> ## 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.

# Finnish Trust Network（FTN）連携ガイド

> DiditでフィンランドのFinnish Trust Network（FTN）による本人確認を設定。銀行ログイン、ワークフロー設定、認証結果、書類によるフォールバックを解説します。

Finnish Trust Network(FTN)を使うと、対象となるユーザーはフィンランドの銀行IDまたは対応しているモバイル証明書で本人確認を行えます。
[Finnish Trust Network API](https://docs.didit.me/ja/api-reference/digital-id-wallets/ftn.md)を使えば、ワークフローを使わずに自社のアプリケーションから銀行認証を開始できます。
FTNはDiditの**ID Verification**ワークフローステップ内でも動作し、ウォレット識別子`ftn`と国コード`FIN`を使用します。
以下で説明するホスト型の連携では、他のDiditワークフローと同じセッション作成、セッション結果、Webhookを使用します。

> [!NOTE]
>
> **Finnish Trust Networkはフィンランドで利用できます。**
> ワークフローで`FIN`向けに受け入れるウォレットとして`ftn`を有効にしてください。
> 公開料金は**完了した認証1件あたり\$0.25**です。
> 対応しているすべてのウォレットについては、[ウォレットの対応範囲と料金](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md#料金)を参照してください。

## ユーザージャーニー

1. ユーザーは、ワークフローが受け入れる本人確認方法の中からフィンランドとFinnish Trust Networkを選択します。
2. 参加している銀行または対応するモバイル証明書を選択します。
3. そのサービスで認証を行い、本人確認を承認します。
4. Diditのセッションに戻ると、セッションが本人確認の結果を検証し、ワークフローを続行します。

ユーザーは、選択したサービスで有効なIDを保有し、その認証方法を利用できる必要があります。
銀行の認証情報や承認コードは、そのサービスの認証画面でのみ入力します。
Diditが自社の検証フォームで銀行のパスワードを求めることはありません。

Diditの認証方法選択画面と戻り画面には、セッションのブランディングとカスタムドメインの設定が適用されます。
選択された銀行または本人確認サービスは、自社の認証画面を独自に管理します。

## ワークフローの設定

コンソールでワークフローの**ID Verification**ステップを開き、**Countries**を選択して**Finland**を開きます。
**Wallets accepted**で、利用可能な場合はFinnish Trust Networkを有効にします。
ユーザーが代わりに書類を使えるようにする場合は、書類認証を有効のままにしてください。
新しいセッションを作成する前に、ワークフローを保存して公開してください。

以下は`methods`の設定の一部であり、ワークフローのリクエスト全体ではありません。

```json theme={null}
{
  "FIN": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["ftn"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

利用できないウォレットを指定すると、ワークフローの保存は拒否されます。
APIの完全な仕様については[ワークフローの機能設定](https://docs.didit.me/ja/management-api/workflows/feature-configs.md#ocr-/-本人確認)を、画面での設定については[コンソールでの設定](https://docs.didit.me/ja/console/id-verification-methods.md)を参照してください。

## 検証結果

FTNのチェックが完了すると、`cryptographic`の保証レベルを持つウォレット検証結果が返されます。
検証済みの本人情報には、選択された本人確認方法から返された場合に、ユーザーの氏名、生年月日、個人識別子が含まれます。
FTNは顔写真を返しません。
任意の本人情報フィールドがすべて存在すると想定せず、実際の結果を確認してください。

セッションの**Credential**カードには、選択されたウォレットとその検証済みエビデンスが表示されます。
結果のスキーマについては、[本人確認のデータモデル](https://docs.didit.me/ja/reference/data-models.md#本人確認)を参照してください。
FTNの認証に成功すると本人確認ステップは完了しますが、セッションの最終的な判定は残りのチェックによって決まります。
ワークフローで必要な場合は、ライブネス検知と顔照合のステップを別途設定したままにしてください。

## キャンセルと書類へのフォールバック

ユーザーがキャンセルした場合、リクエストが期限切れになった場合、または検証に失敗した場合、Diditはその国の`wallet.on_failure`設定を適用します。
`fallback_to_document`は、フィンランドで書類認証が有効になっている場合に書類の撮影を開始します。
`decline`は本人確認ステップを却下します。
無効になっている書類認証方法はフォールバックとして使用できません。
ユーザーをまずFinnish Trust Networkに誘導し、失敗した後にのみ書類の撮影を表示するには、`document.fallback_only`を`true`に設定します。
[書類の撮影をフォールバックとしてのみ提供する](https://docs.didit.me/ja/core-technology/id-verification/verification-methods.md#書類撮影をフォールバックとしてのみ提供する)を参照してください。

リダイレクトや銀行選択画面の表示は、本人確認の成功を意味しません。
アクセスを許可する前に、検証済みのセッション結果またはWebhookを待ってください。
Webhookの重複配信は、連携の他の部分と同じ冪等な処理で対応してください。

## テストと本番公開

ウォレットが有効になっている環境でテストしてください。
正常な復帰、ユーザーによるキャンセル、期限切れ、不完全な本人確認、書類認証へのフォールバックをテストしてください。
ユーザーが利用するデバイスやブラウザ環境もテストしてください。
サンドボックスでのシミュレーション結果は、実際の銀行認証や本番環境での有効化を証明するものではありません。

FTNの料金は、公開されている基本料金で**完了した認証1件あたり\$0.25**です。
キャンセル、期限切れ、失敗したウォレットの試行には、完了したウォレット認証の料金は発生しません。
完了した書類認証へのフォールバックは、書類認証の料金に基づいて別途請求されます。
現在の請求ルールについては、[ウォレットの料金](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md#料金)を参照してください。

## 関連ガイド

* [デジタルIDウォレットの対応範囲と料金](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md)
* [Smart-IDとMobile-IDの連携](https://docs.didit.me/ja/core-technology/id-verification/smart-id-mobile-id.md)
* [本人確認の方法](https://docs.didit.me/ja/core-technology/id-verification/verification-methods.md)
* [Webhookの連携](https://docs.didit.me/ja/integration/webhooks.md)


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