電子署名ライブラリとAPI

PAdES（PDF Advanced Electronic Signatures）は、署名をPDFファイルの中に埋め込む電子署名形式で、ETSI EN 319 142規格で定義されています。署名済み文書はPDFのままで、Adobe ReaderなどのPDFリーダーの署名パネルで検証でき、ページ上に目に見える署名欄を持たせることもできます。レベルはB-BからB-T（タイムスタンプ付き）、B-LT、B-LTA（長期アーカイブ）へと上がります。

CAdES（CMS Advanced Electronic Signatures）は、CMS/PKCS#7構造に基づく電子署名形式で、ETSI EN 319 122規格で定義されています。あらゆる種類のファイルに署名でき、署名は通常.p7sとして、または署名済みエンベロープの中に入れて文書とともに扱われます。トルコでは電子署名付きの公文書で最も広く使われている形式です。

XAdES（XML Advanced Electronic Signatures）は、XML文書向けに開発された電子署名形式で、ETSI EN 319 132規格で定義されています。署名はXMLの中に埋め込むことも、別に置くこともできます。UBL-TR形式の電子請求書などXMLベースの文書で使われます。

電子署名ライブラリとは、電子署名の作成と検証を自社ソフトウェアに組み込む開発者向けコンポーネント（SDK）です。既製の署名アプリケーションは利用者に画面を提供しますが、ライブラリは画面を持たない部品であり、署名するのは自社のアプリケーション、つまり自社の業務フローの中です。ICカード、トークン、HSMと連携し、CAdES、XAdES、PAdES形式の作成と検証を行います。

e-Yazışmaパッケージは、トルコの公的機関との公式な電子文書のやり取りで使われる標準パッケージです。署名済み文書、メタデータファイル、添付ファイル（ある場合）を1つのパッケージにまとめます。機関間では通常KEP（登録電子郵便）で送られます。

公式のe-Yazışmaパッケージは、メタデータファイルと署名済み文書をまとめて梱包したものです。ライブラリは1回の呼び出しでこれを行います。文書をCAdESまたはXAdESで署名し、スキーマに沿ったメタデータを生成し、パッケージを閉じます。e-Yazışmaのバージョン1.3と2.0に対応し、KamuSMのルート証明書を組み込んでいます。フォルダーを指定すれば、中の文書を一括署名します。

ライブラリは自社のソフトウェアに組み込まれます。署名を起動するのは自社の業務フローで、画面も自社のものです。既製アプリケーション（İmzacı）はデスクトップで動作し、利用者がファイルを選んで署名します。どちらも同じ署名基盤を使います。どちらが合うかは、署名を開始するのが自社ソフトウェアか利用者かで決まります。

CAdES（BES、EPES、T、C、X、XL、A）、XAdES（BES、T、C、X、XL、A）、PAdES（B-B、B-T、B-LT、B-LTA）、ASiC-SおよびASiC-Eです。1つのライブラリで長期アーカイブレベルまで対応できます。

ありません。ライブラリはモジュール型で、PDFならeSignature.PAdESパッケージで足ります。使わない規格、TSA、ハードウェアプロバイダーはプロジェクトに一切入りません。

署名はブラウザーではなく、Webアプリケーションのサーバー側で生成されます。eSignature.PAdESパッケージを呼び出し、署名済みPDFを利用者に返します。決め手は鍵の置き場所です。クラウドHSM、ネットワークHSM、モバイル署名ならサーバーが鍵にアクセスできるため、すべてWeb上で完結します。鍵が利用者のICカードにある場合、ブラウザーはカードにアクセスできないため、デスクトップでİmzacıを使って署名します。

動作します。署名元は抽象化されており、ICカードとUSBトークン（CNG/PKCS#11）、ネットワークHSM、クラウドHSMサービス、モバイル署名を同じフローで扱えます。各プロバイダーは独立したパッケージです。

できます。RFC 5280に基づく証明書チェーン検証、CRL、OCSP、Delta CRL、オフライン検証はライブラリに含まれており、署名の作成と検証を同じコンポーネントが行います。

あります。コードを書かずに使えるデスクトップアプリケーションがİmzacıです。ICカードでPDFとXMLに署名し、e-Yazışmaパッケージを作成し、フォルダー単位で一括署名します。

必要な規格のパッケージをプロジェクトに追加することです。PDF署名ならeSignature.PAdES、XMLならXAdESパッケージです。ライブラリは39のNuGetパッケージに分かれているため、使うものだけをインストールでき、大きな依存関係が1つだけ入り込むことはありません。

Windows CNGとPKCS#11経由で、AKİS、SafeNet/eToken、Gemalto/Thales、IDEMIA、Feitian、YubiKey、Nitrokeyなどのデバイスに対応します。各プロバイダーは独立した別パッケージで、使わないドライバーはプロジェクトに入りません。

できます。Thales Luna、Utimaco、Entrust nShieldのネットワークHSMに加え、AWS CloudHSM/KMS、Azure Key Vault HSM、Google Cloud KMSに対応します。こうしてカードを持つ利用者なしに、サーバー上で自動署名フローを構築できます。

必要ありません。署名の作成と検証を同じコンポーネントが行います。RFC 5280に基づく証明書チェーン検証、CRL、OCSP、Delta CRL、オフライン検証はライブラリに含まれています。