テストカード代替機能

デジタル認証アプリおよびテスト用のマイナンバーカードを使用することなくサービスに組み込んだ認証および署名機能をテストすることができる機能です。

テスト用マイナンバーカードを持っていないサービス事業者もデジタル認証アプリの接続が簡単にできるようにする機能です。いくつかあるテストデータの中からデータを選択し、データに従ったAPIレスポンスを返却します。テストカード代替機能を使用する場合とテスト用デジタル認証アプリ（テスト用マイナンバーカード）を使ったテストとを両立することはできません。
認証APIをご利用のサービス事業者のみに提供します。

事前準備

以下の開発者サイトのドキュメントをご参照の上、RPとテスト環境への連携を行ってください。

https://developers.digital.go.jp/documents/auth-and-sign/implement-guideline/

RPからデジタル認証アプリサーバへ認可リクエストを実行してください。サービスのウェブページからリダイレクトされ、以下のデジタル認証アプリ 認証API/署名APIテストレスポンス設定画面が表示されます。

下記にデジタル認証アプリ 認証API/署名APIテストレスポンス設定画面の操作方法を示します。

認証APIテストレスポンス設定画面操作方法

画面項目

1. 認証APIテストレスポンス設定画面には以下の項目が表示されます。

   

   • 証明書タイプ
     テストカード情報一覧で選択する証明書のタイプを選択します。
   • レスポンス
     認可リクエストエンドポイントのレスポンスを選択します。
   • エラーパターン
     レスポンスで[異常]を選択した場合に、認可リクエストエンドポイントで返却するエラーの内容を選択します。
   • テストカード情報一覧
     認証APIのテストでテスト可能なマイナンバーカードおよびスマホ用電子証明書の一覧が表示されます。
     テストしたい内容に合わせたテストカード情報を選択します。
     証明書タイプを選択した場合は一致する証明書タイプのテストカード情報が表示されます。

正常レスポンスを返却する場合

1. 証明書タイプから[マイナンバーカード]または[スマホ用電子証明書]ラジオボタンを選択します。

   

   証明書タイプを選択すると画面下部のテストカード情報一覧は選択した証明書タイプに応じたテストカードが表示されます。

2. レスポンスから[正常]ラジオボタンを選択します。

   

3. テストカード情報一覧から認証を行うテストカード情報を選択し、[認証]ボタンを押下します。

   

4. RPへ認可レスポンスが返却されますので内容を確認してください。トークンリクエスト（認可コードフロー）などの後続処理を行うことができます。

異常レスポンスを返却する場合

1. レスポンスから[異常]ラジオボタンを選択します。

   

2. 「エラーパターン」の中からテストを実施したいエラーパターンを選択します。

   ※ specified_certificate_type_not_mach エラーは一般利用を想定していないため、選択しないようお願いします。
   ※エラーパターンの意味は「エラーパターンの詳細」項目を参照してください。
   

3. テストカード情報一覧から認証を行うテストカード情報を選択し、[認証]ボタンを押下します。
   

4. 選択したエラーパターンに応じてエラーレスポンスを返却、またはエラー画⾯を表⽰します。

   • RPへ認可レスポンスが返却されますのでエラーの内容を確認してください。

   • レスポンスで異常を選択してエラーパターンを選択しない場合は以下のエラーメッセージが表示されます。

   

   • 選択したエラーパターンがHTTP 503エラーを発生する合は、以下のエラーページが表示されます。

   

   • 選択したエラーパターンがHTTP 504エラーを発生する場合は、以下のエラーページが表示されます。

   

署名APIテストレスポンス設定画面操作方法

画面項目

1. 署名APIテストレスポンス設定画面には以下の項目が表示されます。

   

   • 証明書タイプ
     テストカード情報一覧で選択する証明書のタイプを選択します。
   • 署名トランザクションID
     署名トランザクション開始エンドポイントで発行した署名トランザクションIDを表示します。この値は編集できません。
   • レスポンス
     認可リクエストエンドポイントのレスポンスを選択します。
   • エラーパターン
     レスポンスで[異常]を選択した場合に、認可リクエストエンドポイントで返却するエラーの内容を選択します。
   • 署名トランザクション結果取得エラーパターン
     レスポンスで[異常]を選択した場合に、署名トランザクション結果取得エンドポイントで返却するエラーの内容を選択します。
   • テストカード情報一覧
     署名APIのテストでテスト可能なマイナンバーカードおよびスマホ用電子証明書の一覧が表示されます。
     テストしたい内容に合わせたテストカード情報を選択します。
     証明書タイプを選択した場合は一致する証明書タイプのテストカード情報が表示されます。

正常レスポンスを返却する場合

1. 証明書タイプから[マイナンバーカード]または[スマホ用電子証明書]ラジオボタンを選択します。

   

   証明書タイプを選択すると画面下部のテストカード情報一覧は選択した証明書タイプに応じたテストカードが表示されます。

2. レスポンスから[正常]ラジオボタンを選択します。

   

3. テストカード情報一覧から署名を行うテストカード情報を選択し、[署名]ボタンを押下します。

   

4. RPへ認可レスポンスが返却されますので内容を確認してください。トークンリクエスト（認可コードフロー）などの後続処理を行うことができます。

異常レスポンスを返却する場合

エラーパターンのエラーをテストしたい場合

入力項目「エラーパターン」の中からテストを実施したいエラーパターンを選択します。
このエラーパターンは、一般的な異常状況をテストするために使用されます。

1. レスポンスから[異常]ラジオボタンを選択します。

   

2. エラーパターンの中からテストを実施したいエラーパターンを選択します。

   ※エラーパターンの意味は「エラーパターンの詳細」項目を参照してください。

   

3. テストカード情報一覧から署名を行うテストカード情報を選択し、[署名]ボタンを押下します。

   

4. 選択したエラーパターンに応じてエラーレスポンスを返却、またはエラー画⾯を表⽰します。

   • RPへ認可レスポンスが返却されますのでエラーの内容を確認してください。

   • レスポンスで異常を選択してエラーパターンを選択しない場合は以下のエラーメッセージが表示されます。

   

• エラーパターンを選択した結果HTTP 503エラーの場合は以下のエラー画面が表示されます。

  

• エラーパターンを選択した結果HTTP 504エラーの場合は以下のエラー画面が表示されます。

  

署名トランザクション結果取得エラーパターンのエラーをテストしたい場合

入力項目「エラーパターン」は[-]（未選択）を選択し、

入力項目「署名トランザクション結果取得エラーパターン」の中からエラーパターンを選択してください。
このエラーパターンは、特定の異常状況を検証するために使用されます。

1. [異常]ラジオボタンを選択します。

   

2. 署名トランザクション結果取得エラーパターンを選択します。

   ※ specified_certificate_type_not_mach エラー、specified_certificate_type_unavailable エラーは一般利用を想定していないため、選択しないようお願いします。
   ※署名トランザクション結果取得エラーパターンの意味は「エラーパターンの詳細」項目を参照してください。

   

3. テストカード情報一覧から署名を行うテストカード情報を選択し、[署名]ボタンを押下します。

   

4. RPへ署名トランザクション結果取得レスポンスが返却されますのでエラーの内容を確認してください。

バックチャネルログアウトを実行する場合

テストカード代替機能において、デジタル認証アプリサーバからRPのサーバへback-channel logoutリクエストを発生させるためには、以下の手順を行なってください。

1. テストカード代替機能の"正常レスポンスを返却する場合”の操作を行い、サーバにおいてクライアントアサーションの取得とリフレッシュトークン、IDトークン、IDトークンに含まれるsub値のいずれかを取得してください

2. 下記の通りHTTP POSTリクエストを送信します。

   • リフレッシュトークンを使用する場合
     URL：https://sb-auth-and-sign.go.jp/api/realms/main/sandbox/logout
     Content-Type：application/x-www-form-urlencoded
     リクエストボディ：
     • client_assertion_type：urn:ietf:params:oauth:client-assertion-type:jwt-bearer
     • client_assertion：クライアントアサーション（クライアント認証のための情報を含むJWT）
     • refresh_token：アクセストークン発行レスポンスに含まれるリフレッシュトークン
   • IDトークンを使用する場合
     URL：https://sb-auth-and-sign.go.jp/api/realms/main/sandbox/logout
     Content-Type：application/x-www-form-urlencoded
     リクエストボディ：
     • client_assertion_type：urn:ietf:params:oauth:client-assertion-type:jwt-bearer
     • client_assertion：クライアントアサーション（クライアント認証のための情報を含むJWT）
     • id_token：アクセストークン発行レスポンスに含まれるIDトークン
   • Sub値を使用する場合
     URL：https://sb-auth-and-sign.go.jp/api/realms/main/sandbox/logout
     Content-Type：application/x-www-form-urlencoded
     リクエストボディ：
     • client_assertion_type：urn:ietf:params:oauth:client-assertion-type:jwt-bearer
     • client_assertion：クライアントアサーション（クライアント認証のための情報を含むJWT）
     • subject_id：アクセストークン発行レスポンスのIDトークンに含まれるsub値

3. バックチャネルログアウトが成功した場合、下記の通りレスポンスが返却されます。
   HTTPステータス：200
   Content-Type: application/json
   レスポンスボディ：

   • executed_backchannel_logout：true

エラーパターンの詳細

エラーパターンに関しては以下をご参照ください。

変更履歴

• 2025-03-27
  • 初版公開
• 2026-04-24
  • スマホ用電子証明書の証明書タイプとエラー種別を追加