PdfTools.Crypto.Providers.Pkcs11.Sessionクラス

暗号化操作を実行するためのデバイス(HSM、USBトークンなど)へのセッション

セッションはPDF文書に署名するための署名設定を作成するために使用できます。
セッションを取得するには以下の手順を実行します:

• PdfTools.Crypto.Providers.Pkcs11.Module.Load(String)を使用してPKCS#11ドライバーモジュールをロードします。
• モジュールのPdfTools.Crypto.Providers.Pkcs11.Module.Deviceから適切な暗号化デバイスを取得します。利用可能なデバイスが1つしかないと想定できる場合はPdfTools.Crypto.Providers.Pkcs11.DeviceList.GetSingle()を使用できます。
• PdfTools.Crypto.Providers.Pkcs11.Device.CreateSession(String)を使用してデバイスへのセッションを作成します。

継承

定義

public class Session : Provider

プロパティ

	名前	概要
	Certificates	このデバイスで利用可能な証明書 証明書またはその秘密鍵(PdfTools.Crypto.Providers.Certificate.HasPrivateKey参照)はLogin(String)後にのみ取得可能です。
	TimestampUrl	タイムスタンプを取得する信頼できるタイムスタンプ機関(TSA)のURL TSAはRFC3161で定義たTime-Stampプロトコルをサポートしなければなりません。 プロパティ値は次の要素を含むURLです: http[s]://[‹user›[:‹password›]@]‹host›[:‹port›][/‹resource›] それぞれ: http/https: TSAへの接続プロトコル ‹user›:‹password›(省略可): TSA接続のための資格情報 (Basic認証) ‹host›: TSAホスト名 ‹port›: TSA接続用のポート番号 ‹resource›: 他のリソース タイムスタンプを適用するにはタイムサーバーへのオンライン接続が必須です。 ファイアウォールもそれに応じて設定する必要があります。 プロキシを使用している場合(PdfTools.Sdk.Proxy参照)は以下のMIMEタイプがサポートされていることを確認してください。 application/timestamp-query application/timestamp-reply

メソッド

	名前	概要
	CreateSignature	署名証明書に基づいて署名設定を作成
	CreateSignatureFromKeyId	秘密鍵のIDと外部証明書に基づく署名設定を作成 PKCS#11デバイスに秘密鍵のみが格納され、証明書は外部から提供され署名設定を作成します。これは、Google Cloud Key Management(KMS)などの秘密鍵のみを保存できるPKCS#11デバイスを対象としています。 秘密鍵オブジェクトはPKCS#11ストア内のCKA_IDオブジェクト属性などのIDを使用して識別されます。 信頼チェーンの証明書はPdfTools.Crypto.Providers.Pkcs11.SignatureConfiguration.AddCertificate(Stream)を使用して追加する必要があります。
	CreateSignatureFromKeyLabel	秘密鍵のラベル(名前)と外部証明書に基づいて署名設定を作成 PKCS#11デバイスに秘密鍵のみが格納され、証明書は外部から提供され署名設定を作成します。これは、Google Cloud Key Management(KMS)などの秘密鍵のみを保存できるPKCS#11デバイスを対象としています。 秘密鍵オブジェクトはPKCS#11ストア内のCKA_LABELオブジェクト属性などのラベルを使用して識別されます。 信頼チェーンの証明書はPdfTools.Crypto.Providers.Pkcs11.SignatureConfiguration.AddCertificate(Stream)を使用して追加する必要があります。
	CreateSignatureFromName	証明書名に基づいて署名設定を作成
	CreateTimestamp	タイムスタンプ設定を作成 タイムスタンプを作成するにはTimestampUrlを設定します。
	Dispose	オブジェクトを閉じます オブジェクトに関連付けられているすべてのリソースを解放します。 (PdfTools.Crypto.Providers.Providerから継承)
	Login	暗号化デバイスにログイン 暗号化操作を有効にするにはログインが必要です。さらに、証明書や秘密鍵などのデバイスのオブジェクトの一部はログインのちにのみ利用可能になるものがあります。