Primagest Trust Services
プロダクト
ドキュメントよくあるご質問運営会社リリースノート
プロダクト
ドキュメントよくあるご質問運営会社リリースノート
APIリファレンス
  1. カード代替電磁的記録
  • プロダクト
    • WE BUILD TRUST
    • 本人確認
      • 本人確認API
    • 本人情報取得
      • 基本4情報提供API
    • 連携プロダクト
      • ID-MY2
      • マイナアプリ
    • 本人確認アプリサービス
      • 本人確認アプリサービス
  • ドキュメント
    • ようこそ
    • 本人確認
      • 公的個人認証
        • 署名API
        • 利用者証明API
      • カード代替電磁的記録
        • スマートフォンのマイナンバーカードAPI
      • ICチップ読み取り
        • マイナンバーカード券面API
        • マイナンバーカード券面事項入力補助API
        • マイナンバーカード一括取得API
        • 運転免許証API
        • 在留カードAPI
        • 特別永住者証明書API
        • ICチップ画像OCR(オプション)
      • ICチップ読み取り+容貌撮影
    • 本人情報取得
      • 基本4情報提供
        • 同意
          • 同意取得API
          • 同意取消しAPI
          • 同意状況照会API
        • 証跡
          • 証跡照会API
        • 失効情報
          • 失効情報確認API
          • 失効情報通知API
        • 基本4情報提供
          • 基本4情報提供API
          • 基本4情報自動最新化API
    • 連携プロダクト
      • マイナアプリ
        • マイナアプリ 署名API
        • マイナアプリ 認証API
        • マイナアプリ 同意取得API
        • マイナアプリ 同意取消しAPI
    • 本人確認サービス
      • 管理コンソール
      • 確認記録取得API
      • 対面本人確認アプリ
      • 非対面本人確認アプリ
  • よくあるご質問
    • カテゴリ
    • 共通質問
      • APIに関する共通質問
      • SDKに関する共通質問
    • 本人確認
      • カード代替電磁的記録
      • 公的個人認証
      • ICチップ読み取り+容貌撮影
      • ICチップ読み取り
    • 本人情報取得
      • 基本4情報提供
    • 連携プロダクト
      • マイナアプリ
    • SDK
      • 技術的な質問
    • 本人確認サービス
      • 対面本人確認アプリ
      • 非対面本人確認アプリ
    • 管理コンソール
      • 管理者・メンバー
      • パスキー
    • 申込み・支払い・解約
      • 申込み
      • 支払い・解約
    • サポート・セキュリティ
      • セキュリティ・データ管理
      • お問い合わせ・障害対応
  • 運営会社
    • 私たちについて
    • 運営会社
      • 会社概要
      • チーム
      • 情報セキュリティ
      • 認証
      • プライバシーポリシー
    • 利用規約
      • プリマジェストトラストサービス利用規約
      • プリマジェスト本人確認アプリ利用規約
  1. カード代替電磁的記録

スマートフォンのマイナンバーカードAPI


概要#

スマートフォンのマイナンバーカードAPIは、iPhoneのAppleウォレットに格納されたマイナンバーカードから提示されたmdoc(mobile document/モバイル・ドキュメント)を、ISO/IEC 18013-5規格に準拠して検証するためのAPIです。 オンラインで受け取った発行者署名とデバイス署名を検証することで、提示されたデータが「正当な発行機関によって作成されたものであること」および「現在の所持者のデバイスで生成されたものであること」を確認します。
また、本方式ではデータ提供時に利用者自身のデバイス上で生体認証(Face ID等)を行うため、なりすましを強力に防止します。さらに、利用者が提示する情報の項目(氏名、住所、生年月日等)を自ら確認できるため、必要最小限のデータのみを安全に受け渡し可能です。 これにより、発行元の公的機関による真正性が厳密に担保され、偽造や改ざんが極めて困難な、最堅牢かつプライバシーに配慮したデジタル本人確認/属性証明プラットフォームを提供します。
Androidのマイナンバーカードの対応は、2026年秋頃を予定しております。
デジタル庁:2026年秋頃に「Androidのマイナンバーカード」へ刷新します

取得できる項目#

iPhoneのマイナンバーカードから取得可能な属性項目

アクセスコントロール#

iPhoneのマイナンバーカード

処理の流れ#

対面
非対面
1
乱数の取得(サービスプロバイダ事業者)
本人確認セッションを開始し、mdoc検証サーバーからリプレイアタック(再送攻撃)を防止するためのNonce(使い捨ての乱数)を取得する。
2
属性項目の確認と承認(利用者)
要求された属性項目を画面上で確認し、掲示を承認します。生体認証(Face ID/Touch ID)を実行することで、端末内の秘密鍵によるデータ署名を許可します。
3
デバイス署名付mdocの生成(SDK)
取得済みのNonceと属性情報を組み合わせ、端末固有の鍵で署名(Device Auth)を付与します。これにより、検証サーバーのみが復号・検証可能な暗号化された提示用データ(DeviceResponse)を構成します。
4
復号と署名検証(プラットフォーム事業者)
暗号化データを復号し、Nonceの一致確認、発行元署名による改ざん検知、およびデバイス署名による所有証明を厳格に行います。すべての検証を通過したのち、承諾された属性のみをJSON形式で取り出します。

シーケンス図#

対面
非対面

実装例#

iOS 対面
Android 対面
iOS 非対面
本実装例では解説のためアプリから直接通信していますが、商用環境ではAPIキーの露出や盗用を防ぐため、必ず自社サーバーを介してAPIキーを秘匿する構成にしてください。

前へ
カード代替電磁的記録
次へ
ICチップ読み取り
Built with