本APIを使用することで、クライアント事業者(自治体)を署名検証者とした公的個人認証を利用者にリクエストすることができます。xIDが発行する電子証明書による本人確認では現行法令上対応できない取引・申請業務において、xIDアプリを利用してマイナンバーカードによる電子署名を付し、その電子証明書の有効性をJ-LISへ問い合わせることによって本人確認を実施します。法令上マイナンバーカードによる電子署名を求められているケースとして、例えば以下のようなものが該当します。 犯罪による収益の移転防止に関する法律に規定される特定事業者における特定業務に関する本人確認(犯収法施行規則第六条ワ)
行政手続きにおいて、有効な電子証明書が限定列挙されているケース(住民票請求等)
JPKIまたはJPKICallbackエンドポイントを呼び出して公的個人認証のリクエスト利用者のxIDアプリに送信すると、利用者はリクエスト毎にマイナンバーカードの読取りによる本人確認を実施します。本APIを利用するクライアント事業者(自治体)は事前にJ-LISへの届け出と総務大臣による認定を取得する必要があります。申請は弊社で代行いたしますので、詳細は弊社営業担当者へお尋ねください。
本APIは以下のエンドポイントで構成されています。JPKIエンドポイントを利用することで、クライアント事業者(自治体)を署名検証者として公的個人認証を実施することが可能です。本エンドポイントへリクエスト送信後、xIDアプリユーザーに公的個人認証リクエストが送信されます。JPKIStatusエンドポイントからは、xIDアプリユーザーの対応状況(status)のほか、uid, digest, in_trnsaction_id, out_transaction_idなどが返却されます。利用者がクライアントアプリをモバイルで操作し、公的個人認証を開始する場合には、JPKICallbackを活用することで、クライアントアプリ、xIDアプリ間の遷移の利便性を向上させることができます。返却されたデータは、各種法令に基づきクライアント側で適切に管理保管を行なってください。当社側に情報が保管されることはありません。
JPKIについて#
シーケンス#
利用者フロー#
JPKICallbackについて#
JPKIとの違い#
本エンドポイントを用いて公的個人認証を実施した場合、自動的にxIDアプリへ遷移して公的個人認証が開始されます。
当該認証が完了した後、本リクエストを実行したサービスに自動的に戻ります
xIDアプリから自動遷移して戻る先は、デフォルトブラウザがターゲットとなります。特定のアプリへ遷移が必要な場合は、クライアントアプリ側でユニバーサルリンク、アプリリンクを用いて、そちらをcallback_urlに指定することをご検討ください。モバイルで端末で署名を開始する場合は、JPKICallbackエンドポイントを活用することでクライアントアプリ、xIDアプリ間の遷移の利便性を向上させることができます。リクエスト元からxIDアプリへの自動遷移