Root.GetClientCertificateListメソッド

説明

インポートされているクライアント証明書の一覧を取得します。

呼出形式

var certList = //.GetClientCertificateList( )

戻り値

証明書情報を格納したRecordオブジェクトの配列を返します。

証明書情報が取得できなかった場合、空のRecordオブジェクトの配列を返します。

証明書の情報の形式は下記の通りです。

Record certificateInfoList[] {
	/* 証明書のSHA-256ハッシュ。証明書を一意に特定可能。setClientCertificateで使用 */
	ByteArray Digest;
	/* 証明書のシリアル値 */
	ByteArray SerialNumber;
	/* 証明書の有効期間(開始日) */
	Date EffectiveDate;
	/* 証明書の有効期間(終了日) */
	Date ExpiryDate;
	/ サブジェクト(発行された人)情報 : コモンネーム, 国名, 組織名, Eメールアドレス */
	String SubjectCommonName;
	String SubjectCountryName;
	String SubjectOrganization;
	String SubjectEmailAddress;
	/* 発行者(発行した人)情報 : コモンネーム, 国名, 組織名, Eメールアドレス */
	String IssuerCommonName;
	String IssuerCountryName;
	String IssuerOrganization;
	String IssuerEmailAddress;
}

引数

なし

例外

なし

使用例

var digest = null;
var certList = //.GetClientCertificateList();
for(var idx in certList) {
	var cert = certList[idx];
	/*コモンネームが一致する発行者を探す*/
	if(cert.IssuerCommonName == "ExampleCommonName") {
		digest = cert.Digest;
		break;
	}
}
/* 発見したクライアント証明書を使用する */
if(digest != null) //.SetClientCertificate(digest);

関連項目

SetClientCertificateメソッド