署名API
概要
マイナンバーカードのICチップまたはスマートフォンのマイナンバーカードから署名用電子証明書を読み取り、利用者によって作成された電子文書を秘密鍵を使用して暗号化することで電子署名を生成します。
これにより、受領した電子文書の利用者の実在性、氏名・住所等を正確・確実に把握し、かつ、改ざんや送信否認のおそれがないものとして申請書等を安心して受け取ることができます。
アクセスコントロール
処理の流れ
対面
非対面
電子文書の作成（サービスプロバイダ事業者）
マイナンバーカードまたはスマートフォンのマイナンバーカードを読み取る前に、契約書や申し込み情報など、署名対象となる電子文書を作成します。
署名用電子証明書の読み取り（サービスプロバイダ事業者）
SDKを使用して利用者のマイナンバーカードまたはスマートフォンのマイナンバーカードを、ICカードリーダーまたは読み取り用スマートフォンのNFC機能で読み取り、6〜16桁の署名用電子証明書の暗証番号を入力することで署名用電子証明書のデータを取得します。
電子文書のハッシュ値生成（サービスプロバイダ事業者）
作成した電子文書から電子署名に使うハッシュ値をSDKで生成します。使用するハッシュ関数は、SHA-1、SHA-256、SHA-384、SHA-512のいずれかを指定します。
電子署名の生成（サービスプロバイダ事業者）
署名用電子証明書の秘密鍵を用いてハッシュ値から電子署名をSDKで生成します。サービスプロバイダ事業者は、生成されたハッシュ値、電子署名、署名用電子証明書、失効状態確認方式を指定してAPIでリクエストを送信します。デフォルト設定ではCRL方式による失効状態の確認が行われるため、OCSP方式を利用する場合は明示的に指定する必要があります。
また、OCSP方式ではCRL方式と違いリアルタイムでJ-LISに失効確認を行うため、発生する利用料金が変わります。
また、OCSP方式ではCRL方式と違いリアルタイムでJ-LISに失効確認を行うため、発生する利用料金が変わります。
署名検証（プラットフォーム事業者）
受信した電子署名を署名用電子証明書の公開鍵で検証し、復元したハッシュ値と元のハッシュ値を照合することで署名の正当性を検証します。なお、検証結果はAPIの応答として返却されます。
署名用電子証明書の有効性確認（プラットフォーム事業者）
署名検証後、署名用電子証明書をJ-LISに送信することで有効性確認を行います。ここまでの結果は証跡としてプラットフォーム事業者側のデータベースに保存され、管理されます。
処理結果の整形・返却（プラットフォーム事業者）
有効性確認後、署名検証および署名用電子証明書の有効性確認の結果をサービスプロバイダ事業者に返却します。
シーケンス図
対面
非対面
実装例
iOS
Android
React Native
Windows