マイナアプリ 同意取消しAPI
概要
利用者からの同意取消しは、本人の意思に基づくものであることを確実に示すため、同意の申請時と同様、署名用電子証明書を用います。署名用電子証明書を用いた同意取消しは、サービスプロバイダ事業者とプラットフォーム事業者を経由したうえ で、J-LISに送信されます。
利用者による同意取消し申請後、J-LISにて申請を受信次第、即時に、J-LISからの基本4情報（氏名・住所・生年月日・性別）提供が停止されます。
アクセスコントロール
処理の流れ
対面
非対面
同意取消しの要求（サービスプロバイダ事業者）
利用者から基本4情報（氏名・住所・生年月日・性別）提供に対する同意取消しの要求を受信し、リダイレクト先URLと併せてAPIに送信します。
署名トランザクションの開始（プラットフォーム事業者）
同意取消し申請書を生成し、その内容から署名対象データを作成します。署名対象データを同意取消し申請書に追加し、署名トランザクションを開始します。正常に開始された場合、サービスプロバイダ事業者にマイナアプリ用の同意取消しURLを返却します。
マイナアプリの起動（サービスプロバイダ事業者）
受信した同意取消しURLにアクセスすると、利用者のスマートフォンでマイナアプリが起動します。PCまたはタブレットの場合は、認証用のQRコードがブラウザやアプリ画面に表示されますので、利用者はマイナアプリの「二次元コードを読み取る」をタップすることでカメラを起動し、表示されたQRコードを読み取ることで、マイナアプリに表示された6桁のパスコードをPCまたはタブレットの画面で入力します。
署名値の生成（サービスプロバイダ事業者）
マイナアプリ起動後、利用者は画面の案内に従って操作を行い、同意取消し申請書に基づいて署名値を生成します。署名完了後、リダイレクトにより署名結果パラメータをAPIへ送信します。
CSRF対策検証（プラットフォーム事業者）
リダイレクトで受信したデータをもとに、CSRF攻撃の有無を検証します。攻撃が検知された場合は、認証処理を中断しエラーを返却します。
署名トランザクション結果の取得（プラットフォーム事業者）
検証が正常に完了した場合、マイナアプリで生成された署名結果を取得します。取得した内容に異常がある場合はエラーを返却し、処理を中断します。
署名値・署名用電子証明書の追加（プラットフォーム事業者）
取得した署名結果から、署名値、署名用電子証明書を同意取消し申請書に追加します。
同意取消し申請の要求（プラットフォーム事業者）
署名値および署名用電子証明書を追加した同意取消し申請書を使用し、J-LISに同意取消し申請を送信します。
署名トランザクションIDの返却（プラットフォーム事業者）
同意申請が正常に完了した場合、署名トランザクションIDをリダイレクトで返却し、署名完了画面へ遷移します。
同意取消し結果の取得（サービスプロバイダ事業者）
取得した署名トランザクションIDを各APIに送信することで、同意取消し結果が返却されます。
シーケンス図
対面
非対面