2026年春のサービス開始に先駆け事前相談受付中。気軽にお問い合わせください。
Primagest Trust Services
プロダクト
ドキュメント
ブログ
運営会社
プロダクト
ドキュメント
ブログ
運営会社
お問い合わせ
デジタル認証アプリ
ようこそ
公的個人認証サービス
公的個人認証
利用者ID
利用者ID発行
利用者ID削除API
JPKI
署名API
利用者証明API
証跡照会
証跡照会API
ICチップ読み取り
マイナンバーカード
券面API
券面事項入力補助API
基本4情報提供
同意
同意取得API
同意取消しAPI
同意状況
同意状況照会API
失効情報
失効情報確認API
失効情報通知API
基本4情報提供
最新基本4情報提供API
基本4情報自動最新化API
デジタル認証アプリ
署名API
認証API
同意取得API
同意取消しAPI
SDK
iOS SDK
Android SDK
React Native SDK
Windows SDK
ソリューションを構築
本人確認
本人確認(対面)
本人確認(非対面)
本人確認(デジタル認証アプリ)
本人認証
本人認証(対面)
本人認証(非対面)
本人認証(デジタル認証アプリ)
顧客情報最新化
最新基本4情報提供
基本4情報自動最新化
プロダクト
ドキュメント
ブログ
運営会社
プロダクト
ドキュメント
ブログ
運営会社
お問い合わせ
デジタル認証アプリ
同意取得API
概要
#
同意取得APIは、利用者の最新基本4情報(氏名・住所・生年月日・性別)の提供を受けるために、予め利用者から同意を取得するAPIです。
利用者からの同意は、本人の意思に基 づくものであることを確実に示すため、署名用電子証明書を用います。署名用電子証明書を用いた同意は、サービスプロバイダ事業者とプラットフォーム事業者を経由したうえで、J-LISに送信されます。
各事業者及びJ-LISは、それぞれ同意情報に関するデータベース等を構築し、保存・管理を行います。
処理の流れ
#
1
同意取得の要求(SP)
利用者の最新基本4情報(氏名・住所・生年月日・性別)提供に対する同意情報を取得し、リダイレクト先URLと併せてAPIに送信します。
2
署名トランザクションの開始(PF)
受信した同意情報に基づき同意申請書を生成し、その内 容から署名対象データを作成します。署名対象データを同意申請書に追加し、署名トランザクションを開始します。正常に開始された場合、サービスプロバイダ事業者にデジタル認証アプリ用の同意URLを返却します。
3
デジタル認証アプリの起動(SP)
受信した同意URLにアクセスすると、利用者のスマートフォンでデジタル認証アプリが起動します。PCまたはタブレットを利用する場合は、認証用のQRコードがブラウザまたはアプリ画面に表示されますので、利用者はスマートフォンでQRコードを読み取り、表示された6桁のパスコードを入力して認証を行い、デジタル認証アプリを起動します。
4
署名値の生成(SP)
デジタル認証アプリ起動後、利用者は画面の案内に従って操作を行い、同意申請書に基づいて署名値を生成します。署名完了後、リダイレクトにより署名結果パラメータをAPIへ送信します。
5
CSRF対策検証(PF)
リダイレクトで受信したデータをもとに、CSRF攻撃の有無を検証します。攻撃が検知された場合は、認証処理を中断しエラーを返却します。
6
署名トランザクション結果の取得(PF)
検証が正常に完了した場合、デジタル認証アプリで生成された署名結果を取得します。取得した内容に異常がある場合はエラーを返却し、処理を中断します。
7
署名値・署名用電子証明書の追加(PF)
取得した署名結果から、署名値、署名用電子証明書を同意申請書に追加します。
8
同意申請の要求(PF)
署名値および署名用電子証明書を追加した同意申請書を使用し、J-LISに同意申請を送信します。
9
署名トランザクションIDの返却(PF)
同意申請が正常に完了した場合、署名トランザクションIDをリダイレクトで返却し、署名完了画面へ遷移します。
10
同意申請結果の取得(SP)
取得した署名トランザクションIDを各APIに送信することで、利用者識別用のID、同意申請結果が返却されます。
シーケンス図
#
前へ
認証API
次へ
同意取消しAPI