ImportArcotID()

CA Auth ID PKI クライアントリファレンスガイド › ArcotID PKI クライアント API リファレンス › ArcotID PKI クライアント Javascript API › ImportArcotID()

ImportArcotID()

このメソッドは、サーバから ArcotID PKI をダウンロードするために使用されます。ウォレット名は ArcotID PKI の内部ウォレット名に基づいて生成されます。内部ウォレット名が存在しない場合、ウォレットのユーザ ID がウォレット名として使用されます。

この単一の API 呼び出しは、前述のシーケンスを以下のように置き換えます。

SetAttribute("WalletInMemory", true | false) の Javascript 呼び出し。これは、ダウンロードが一時的（メモリのみ）であるか、永続的（ディスクに保存された ArcotID PKI）であるかを示します。
SetCurrentWalletFromEncoding(walletEncoding) の Javascript 呼び出し。この関数は、Base64 でエンコードされた文字列としてウォレットのエンコーディングを受け取り、それを現在のウォレットとしてメモリに保存します。
JavaScript 関数の SetCurrentCardByIndex(0)。これは「現在のカード」を現在のウォレット内の最初のカードに設定します。
Javascript 関数の AddCurrentCardToWallet(walletName)。これは、ハードディスクまたはメモリに格納された新しいウォレットに上記で指定した「現在のカード」を格納します。 walletName パラメータは、ディスクに格納されるウォレットのファイル名の一部として使用されます。

ArcotID PKI JavaScript クライアント 6.0.4.3：

ArcotID PKI を中央のデバイスストアに格納する必要があることを API に示すには、API に渡される props オブジェクトで StorageMode プロパティの値を Shared に設定します。
ArcotID PKI をユーザストアに格納する必要があることを示すには、StorageMode プロパティの値を User に設定します。

ArcotID PKI JavaScript クライアント 6.0.4.3 の構文

boolean ImportArcotID(walletEncoding, StorageType, userName, propertyObject)

その他のクライアントの構文

boolean ImportArcotID(walletEncoding, StorageType, userName)

パラメータ

このメソッドのパラメータを以下に示します。

パラメータ	Type	説明
walletEncoding	文字列	インポートするウォレットの Base64 でエンコードされた文字列。
StorageType	文字列	ArcotID PKI を格納するメディアを指定します。詳細については、「StorageType」を参照してください。
userName	文字列	Arcot カードと関連付けられた一意のユーザ識別子であるユーザ名およびエイリアス。注：エイリアスはユーザから取得され、指定されたアプリケーションコンテキストを持つ属性として ArcotID PKI に格納されます。
propertyObject	プロパティオブジェクト	StorageMode プロパティが含まれます。このプロパティの値は、Shared または User のいずれかに設定し、それぞれ ArcotID PKI を中央のデバイスストアまたはユーザストアに格納する必要があることを示します。このプロパティが設定されていない場合は、ユーザストアがデフォルトとして使用されます。注：このパラメータは ArcotID PKI Javascript クライアント 6.0.4.3 でのみ使用可能です。その他のクライアントでは無視されます。

戻り値

メソッドが成功した場合は、TRUE が返されます。メソッドが失敗した場合は、FALSE が返されます。

ArcotID PKI JavaScript クライアント 6.0.4.3 の例

var arcotClient = new ArcotClient();
var b64wallet = "MII0yAIBAAwHY3Rnb29kMTCCNDcwgjQzAgEBDAR
                 jYXJkoIHFMB8GCmCGSAGG+UYJAQEwEQQAAgEBAg
                 ILAgICAegCAgMYBIGhMIGeAgEAMA4GCmCGSA GG+
                 UYJAgAFAASBiDCBhQJBAMzNUdGcaBZsiAt/88Dk9... ";
var user = "jdoe-sb";
var props = {StorageMode:"Shared"};
// ウォレットをインポートして、ハード ディスクまたはメモリのみに保存できるようにします
var returnValue = arcotClient.ImportArcotID(b64wallet, "hd_memory", user, props);

その他のクライアントの例

var arcotClient = new ArcotClient();
var b64wallet = "MII0yAIBAAwHY3Rnb29kMTCCNDcwgjQzAgEBDAR
                 jYXJkoIHFMB8GCmCGSAGG+UYJAQEwEQQAAgEBAg
                 ILAgICAegCAgMYBIGhMIGeAgEAMA4GCmCGSA GG+
                 UYJAgAFAASBiDCBhQJBAMzNUdGcaBZsiAt/88Dk9... ";
var user = "jdoe-sb";
// ウォレットをインポートして、ハード ディスクまたはメモリのみに保存できるようにします
var returnValue = arcotClient.ImportArcotID(b64wallet, "hd_memory", user);