前のトピック: GetVersion()次のトピック: SetAttribute()


GetGlobalAttribute()

プラグイン、アプレット、または特定の ArcotID PKI から属性値を取得します。 この API を使用して取得できない ArcotID PKI 属性もあります。

構文

string GetGlobalAttribute(attributeName)

パラメータ

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

パラメータ

Type

説明

attributeName

文字列

リクエストする属性。

戻り値

成功した場合、リクエストした Arcot カード属性を返します。

説明

属性を使用して、ブラウザ セッションが閉じられるまでプラグインに保持する情報を設定できます。 SetAttribute() を使用して、独自の属性を作成できます。または、Arcot ウォレットおよびカードに関する特定の情報を取得するために、特別な事前定義済みの属性を使用できます。 事前定義済みの属性には以下のものが含まれます。

属性

説明

SelectedWalletName

ユーザがカードを更新しようとするときにプラグインによって設定されます。

SelectedCardName

ユーザがカードを更新しようとするときにプラグインによって設定されます。

walletn:count

クライアント上に存在する ArcotID PKI の数を示します。

walletn:x

ウォレット内の特定の Arcot カードを選択します。 カードには、0 ~ X の番号が付けられます。

walletn:x:name

特定のウォレットの名前を示します。

walletn:x:cardn:count

特定のウォレット内のカードの数を示します。

注: 通常、1 つのカードのみがウォレットに存在します。

walletn:x:cardn:x:name

特定のウォレット内の特定のカードの名前を示します。

wallet:walletname:card:cardname::walletDER

指定されたウォレット名およびカード名を持ったウォレットの DER エンコーディングを返します。

注: これは、使用中の Web ページが正しいドメインからであることを確認するためにクライアント上でドメインの確認を実行することを必要とします。

walletn:x:cardn:x:serialnumber

ウォレットの指定されたカード内にある Arcot 証明書のシリアル番号を取得します。 シリアル番号は常に 16 進数形式です。

注: 現在の Web ページの DNS ドメインが指定された ArcotID PKI の DNS ドメインに一致する場合、この関数は成功します。

var arcotClient = new ArcotClient();
var i = 0;
var walletname;

// ウォレットの数を取得します
var walletcount = arcotClient.GetGlobalAttribute("walletn.count");

// すべてのウォレットの名前を出力します
for (i = 0; i < walletcount; i++)
{
    walletname = arcotClient.GetGlobalAttribute("wallet." + i +  ":name");
    document.write("<P>" + walletname + "</P>");
}