エンドユーザーの動作環境
テスト環境・本番環境での連携フローでは、エンドユーザーの端末上のブラウザとマイナアプリ（旧マイナポータルアプリ）を使用します。 このページでは、エンドユーザーが連携フローを利用するためにサポートされる動作環境について説明します。
ポケットサイン開発環境では、マイナンバーカードの読み取りやマイナポータルとの画面遷移は全てスキップされるため、このページの制約は適用されません。
サポートするブラウザ
エンドユーザーが連携フローを操作するスマートフォンのブラウザとして、PocketSign MynaConnect は以下をサポートしています。
| OS | ブラウザ |
|---|---|
| Android | Chrome 最新版 |
| iOS | Safari 最新版、Chrome 最新版 |
MynaConnect の連携フローはマイナポータル及びマイナアプリを経由するため、マイナポータル及びマイナアプリの動作環境に含まれ、かつ MynaConnect が動作を確認した環境をサポート対象としています。
上記以外のブラウザ（上記以外のブラウザをデフォルトブラウザに設定している場合を含む）はサポート対象外です。マイナアプリへの遷移等が正しく動作しない可能性があります。
特にAndroidでは、Chrome以外のブラウザで連携フローを開始した場合、マイナアプリの仕様上、連携フローを完了できません。詳しくはAndroidにおけるChrome以外のブラウザの制約をご覧ください。
マイナポータル側の動作環境やマイナアプリの対応機種に変更があった場合でも、MynaConnect 側の対応が完了するまでは、サポート対象に含まれない場合があります。
PCブラウザ向けの事業者サービスの場合、エンドユーザーはPC画面上に表示されるQRコードをスマートフォンで読み取り、スマートフォン上でマイナアプリを操作します。このため、PCブラウザ向けサービスにおいても、エンドユーザーのスマートフォンが上記の動作環境を満たしている必要があります。
AndroidにおけるChrome以外のブラウザの制約
Androidでは、Chrome以外のブラウザやアプリ内ブラウザ（WebView）で連携フローを開始した場合、連携フローを完了できません。これはマイナアプリの仕様による制約です。
事業者サービスでは、次のとおり連携フローがChromeで開始されるようにしてください。
- ブラウザ上で動作する事業者サービス: MynaConnectへのリダイレクトURLはChrome上で開く必要があります。Chrome以外のブラウザを使用しているエンドユーザーには、Chromeで開き直すようご案内ください。
- ネイティブアプリで動作する事業者サービス: MynaConnectへのリダイレクトURLを開くときに、Chromeを明示的に指定して起動してください。デフォルトブラウザに任せる起動方法や、アプリ内のWebViewでは、Chrome以外のブラウザが使われて連携フローを完了できません。
iOSにおけるマイナアプリへの遷移の挙動
iOSでは技術的な制約により、マイナアプリへの遷移の挙動がブラウザによって以下のように異なります。
- iOS Safari: マイナアプリへ自動で遷移します
- iOS Chrome: マイナアプリへは自動で遷移せず、エンドユーザーが画面上の「マイナアプリを開く」ボタンをタップすることで遷移します
iOS Chromeにおける挙動は、今後のiOSの仕様変更等により変わる可能性があります。
また、サポート対象外のブラウザをデフォルトブラウザに設定している場合、マイナアプリへの遷移が正しく動作しない可能性があります。事業者サービスでは、連携フローが正しく動作しない場合にSafariでの利用を試すようエンドユーザーにご案内することをおすすめします。
PCブラウザ（QRコード経由）でのマイナンバーカードの選択
MynaConnectの連携フローでは、エンドユーザーは必ず実物のマイナンバーカードを読み取る必要があります。スマートフォンのマイナンバーカード（スマホ用電子証明書）は対応していないため使用できません。
エンドユーザーがiOS/Android端末上で連携フローを完結する場合（QRコードを経由しない場合）は、マイナアプリ側で実物のマイナンバーカードの読み取りに限定されるため、スマートフォンのマイナンバーカードが使われることはありません。
ただし、PCブラウザ向けサービスでQRコードを経由する場合、APIの仕様により、自己情報の提供に同意する読み取り（マイナンバーカードを2回読み取るフローでは2回目の読み取り）で、スマートフォンのマイナンバーカードが既定の方法として提示される場合があります。この場合、エンドユーザーが画面上で明示的に実物のマイナンバーカードを選び直さないかぎり、スマートフォンのマイナンバーカードで手続きが進みます。
マイナンバーカードを2回読み取るフローで、1回目に実物のマイナンバーカード、2回目にスマートフォンのマイナンバーカードが使用された場合、マイナンバーカードの同一性を判定できないため、そのセッションで自己情報を取得することはできません。GetSelfPersonalDataRequestStatus はステータス ERROR・エラー理由 INVALID_CARD_USED を返します。
エンドユーザーがどのマイナンバーカードを選択したかを、MynaConnectが事前に検知したり選択を強制したりすることはできません。事業者サービスでは、MynaConnectへのリダイレクトの前など、エンドユーザーがマイナポータルへ遷移する前に、必ず実物のマイナンバーカードを読み取るようご案内ください。