> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart-ID・Mobile-ID連携ガイド

> DiditでSmart-IDとMobile-IDによる本人確認を設定する方法を解説します。対応国、照合コードによる認証、検証済み属性、フォールバックについても説明します。

Smart-IDとMobile-IDでは、ユーザーがスマートフォンでリクエストを承認するだけで本人確認を行えます。
[Smart-ID API](https://docs.didit.me/ja/api-reference/digital-id-wallets/smart-id.md)または[Mobile-ID API](https://docs.didit.me/ja/api-reference/digital-id-wallets/mobile-id.md)を使うと、ワークフローを使わずに自社のアプリケーションから認証を開始できます。
どちらの方式もDiditの**ID検証**ワークフローステップ内でも実行でき、`cryptographic`の保証レベルを持つウォレット認証結果を返します。
以下で説明するホスト型ワークフロー連携では、他のDiditワークフローと同じセッション作成とWebhook連携を使用します。

> [!NOTE]
>
> **Smart-IDとMobile-IDは利用可能です。**
> Smart-IDはエストニア、ラトビア、リトアニア、ベルギーに対応しています。
> Mobile-IDはエストニアとリトアニアに対応しています。
> ワークフローで受け入れるウォレットは、コンソールで国ごとに選択してください。
> 全一覧は[ウォレットの対応範囲と料金](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md#料金)を参照してください。

## 対応国と前提条件

この連携は、エストニア(`EST`)、ラトビア(`LVA`)、リトアニア(`LTU`)、ベルギー(`BEL`)のSmart-IDに対応しています。
Mobile-IDはエストニア(`EST`)とリトアニア(`LTU`)に対応しており、ラトビアではMobile-IDは提供されていません。
これらの国コードは連携済みのルートを示すものであり、すべてのルートがお客様の環境で有効化されていることを保証するものではありません。

Smart-IDの場合、ユーザーには有効で利用資格のあるSmart-IDアイデンティティ、その個人識別コード、アプリへのアクセスが必要です。
Mobile-IDの場合、ユーザーには有効なMobile-IDアイデンティティ、その個人識別コード、紐付けられた電話番号が必要です。
Mobile-IDの電話番号は国際形式で入力します。エストニアは`+372`、リトアニアは`+370`です。
選択する国は、使用するアイデンティティと一致している必要があります。

どちらの方式も顔写真は返しません。
ワークフローでセルフィーが必要な場合は、適切な[ライブネス検知](https://docs.didit.me/ja/core-technology/liveness/overview.md)と[顔照合](https://docs.didit.me/ja/core-technology/face-match/overview.md)のステップを別途設定したままにしてください。

## ユーザーに表示される内容

1. ユーザーは国を選択し、ワークフローで受け付けるウォレットの中から**Smart-ID**または**Mobile-ID**を選びます。
2. 認証セッションで個人識別コードの入力を求められます。Mobile-IDでは、紐付けられた電話番号の入力も求められます。
3. 認証リクエストがスマートフォンに届くまでの間、ページに照合コードが表示されます。
4. ユーザーはスマートフォン上のコードが認証ページのコードと一致することを確認し、スマートフォンでPINを使って承認します。
5. Diditは署名済みの本人確認結果を検証し、認証ワークフローを続行します。

本人情報の入力フォームと照合コードの画面は、他の認証方式と同じレイアウトを使用します。
ホワイトラベルのカスタマイズが有効な場合、これらの画面はセッションの色、タイポグラフィ、ボタンのスタイル、顧客のロゴを引き継ぎ、セッションのドメイン上に留まります。
ページを再読み込みすると、新たな承認リクエストを開始することなく、有効な照合コードが復元されます。

ユーザーが認証ページでウォレットのPINを入力することはありません。
コードが一致しない場合や、ユーザー自身がリクエストを開始していない場合は、リクエストをキャンセルする必要があります。
照合コードによるフローはパソコンまたはスマートフォンのブラウザで動作し、QRコードは不要です。
ページは結果を自動的に待機し、キャンセルの選択肢を提供します。
スマートフォンで承認された場合でも、Diditがウォレット認証を成功として扱うには、本人確認と署名のチェックに合格する必要があります。

## ワークフローを設定する

コンソールでワークフローの**ID Verification**ノードを開き、**Countries**を選択して、設定したい国を開きます。
**Wallets accepted**で利用可能なウォレットを選択し、失敗時の動作を選びます。
新しいセッションを作成する前に、ワークフローを保存して公開してください。
コンソールでの操作手順の詳細は、[コンソールでのID検証の方式](https://docs.didit.me/ja/console/id-verification-methods.md#smart-idまたはmobile-idを有効にする)を参照してください。

> [!WARNING]
>
> 以下は`methods`設定の断片であり、完全なワークフローリクエストではありません。
> お客様の環境でエストニアについて`smart_id`と`mobile_id`の**両方**が`available`となっている場合にのみ使用してください。
> 利用できないウォレットが含まれていると、ワークフロー全体の保存が拒否されます。

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

`providers`配列は受け入れリストです。ユーザーはその中のウォレットから選択し、配列の順序によって優先するウォレットが決まることはありません。
リトアニアで両方が利用可能な場合は、同じウォレット識別子を使用して`LTU`を指定します。
ラトビアまたはベルギーの場合は、同じ利用可否の確認を前提として、`smart_id`のみを使用して`LVA`または`BEL`を指定します。
指定しなかった国では、既存のデフォルトの書類撮影の動作が維持されます。
設定の完全な仕様は[ワークフロー機能の設定](https://docs.didit.me/ja/management-api/workflows/feature-configs.md#ocr-/-本人確認)にあります。

## 認証結果を読み取る

完了したセッションは、[セッション判定API](https://docs.didit.me/ja/sessions-api/retrieve-session.md)または[Webhook連携](https://docs.didit.me/ja/integration/webhooks.md)で読み取ります。
ウォレットチェックが成功すると、`verification_method: "wallet"`、`assurance: "cryptographic"`、および`wallet_provider: "smart_id"`または`"mobile_id"`が記録されます。
`wallet_verification`オブジェクトは、ウォレット、発行国、認証日時、保証レベル、署名の判定結果を示します。
本人確認結果では、正規化された`full_name`および`date_of_birth`フィールドが提供されます。
これら2つのウォレットでは、`wallet_verification.attributes`に、検証済みのアイデンティティから取得した`given_name`、`family_name`、`birthdate`、`personal_code`が含まれます。
発行国は本人確認の経路を示すものであり、その人物の国籍を証明するものではありません。
Diditが返すのは署名の判定結果であり、元となる署名済みアサーションは返しません。
顔写真やウォレットのPINは返されません。

コンソールでは、セッションの**Credential**カードにウォレットとその検証済みの証拠が表示されます。
ウォレットチェックが成功すると本人確認ステップは完了しますが、セッションの最終判定は引き続きワークフロー内の後続のチェックによって決まります。
フィールドの型や、チェック結果とセッション全体の判定の違いについては、[本人確認のデータモデル](https://docs.didit.me/ja/reference/data-models.md#本人確認)を参照してください。

## キャンセルと失敗への対応

ユーザーがキャンセルした場合、タイムアウトした場合、または認証を完了できなかった場合、Diditはその国の`wallet.on_failure`設定を適用します。
`fallback_to_document`は、その国で書類撮影が有効になっている場合に書類撮影を開始します。
`decline`は本人確認ステップを却下します。
書類撮影が無効になっている場合、書類によるフォールバックは利用できません。

ウォレット認証の料金が発生するのは、完了して検証済みとなったウォレットチェックのみです。
キャンセル、期限切れ、失敗となったウォレットの試行には料金は発生しません。
完了した書類フォールバックは別のチェックとして扱われ、[書類検証の料金](https://docs.didit.me/ja/getting-started/pricing.md)が適用されます。
公開されている料金は[ウォレットの料金表](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md#料金)を参照してください。料金が公開されていない方式を無料とみなさないでください。

## 本番環境に移行する前にテストする

提供を予定している各ウォレットと国を、それが有効になっている環境でテストしてください。
正しいウォレットが表示されること、照合コードが表示されること、承認後にワークフローが続行されること、セッション結果に想定どおりのウォレットの証跡が含まれることを確認してください。
キャンセル、期限切れ、および選択したフォールバックの動作も確認してください。

サンドボックスのシミュレーションやステージングでのテストは、本番環境での認証とは異なります。
シミュレーションによる承認は連携の確認には役立ちますが、実際の本人が本番環境で認証できることを証明するものではありません。
展開前に、コンソールで本番環境での利用可否を確認し、使用予定のルートについて、許可を得た実機での認証を完了してください。

## その他のデジタルIDウォレット

Diditの[デジタルIDウォレットカタログ](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md)には、本番環境での利用可否と今後対応予定のウォレットが掲載されています。利用可能なFinnish Trust Networkや、対応予定のBankIDおよびEUDI Walletとの連携も含まれます。
ウォレットが掲載されていること、料金が公開されていること、またはオンボーディングフォームを完了したことだけでは、本番環境での認証は有効になりません。
現在有効化できるものは、カタログとご利用環境のコンソールで確認してください。

[フィンランド向けのFinnish Trust Network](https://docs.didit.me/ja/core-technology/id-verification/finnish-trust-network.md)も参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.