メインコンテンツへスキップ
Finnish Trust Network(FTN)を使うと、対象となるユーザーはフィンランドの銀行IDまたは対応しているモバイル証明書で本人確認を行えます。 Finnish Trust Network APIを使えば、ワークフローを使わずに自社のアプリケーションから銀行認証を開始できます。 FTNはDiditのID Verificationワークフローステップ内でも動作し、ウォレット識別子ftnと国コードFINを使用します。 以下で説明するホスト型の連携では、他のDiditワークフローと同じセッション作成、セッション結果、Webhookを使用します。
Finnish Trust Networkはフィンランドで利用できます。 ワークフローでFIN向けに受け入れるウォレットとしてftnを有効にしてください。 公開料金は完了した認証1件あたり$0.25です。 対応しているすべてのウォレットについては、ウォレットの対応範囲と料金を参照してください。

​
ユーザージャーニー

  1. ユーザーは、ワークフローが受け入れる本人確認方法の中からフィンランドとFinnish Trust Networkを選択します。
  2. 参加している銀行または対応するモバイル証明書を選択します。
  3. そのサービスで認証を行い、本人確認を承認します。
  4. Diditのセッションに戻ると、セッションが本人確認の結果を検証し、ワークフローを続行します。
ユーザーは、選択したサービスで有効なIDを保有し、その認証方法を利用できる必要があります。 銀行の認証情報や承認コードは、そのサービスの認証画面でのみ入力します。 Diditが自社の検証フォームで銀行のパスワードを求めることはありません。 Diditの認証方法選択画面と戻り画面には、セッションのブランディングとカスタムドメインの設定が適用されます。 選択された銀行または本人確認サービスは、自社の認証画面を独自に管理します。

​
ワークフローの設定

コンソールでワークフローのID Verificationステップを開き、Countriesを選択してFinlandを開きます。 Wallets acceptedで、利用可能な場合はFinnish Trust Networkを有効にします。 ユーザーが代わりに書類を使えるようにする場合は、書類認証を有効のままにしてください。 新しいセッションを作成する前に、ワークフローを保存して公開してください。 以下はmethodsの設定の一部であり、ワークフローのリクエスト全体ではありません。
利用できないウォレットを指定すると、ワークフローの保存は拒否されます。 APIの完全な仕様についてはワークフローの機能設定を、画面での設定についてはコンソールでの設定を参照してください。

​
検証結果

FTNのチェックが完了すると、cryptographicの保証レベルを持つウォレット検証結果が返されます。 検証済みの本人情報には、選択された本人確認方法から返された場合に、ユーザーの氏名、生年月日、個人識別子が含まれます。 FTNは顔写真を返しません。 任意の本人情報フィールドがすべて存在すると想定せず、実際の結果を確認してください。 セッションのCredentialカードには、選択されたウォレットとその検証済みエビデンスが表示されます。 結果のスキーマについては、本人確認のデータモデルを参照してください。 FTNの認証に成功すると本人確認ステップは完了しますが、セッションの最終的な判定は残りのチェックによって決まります。 ワークフローで必要な場合は、ライブネス検知と顔照合のステップを別途設定したままにしてください。

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

ユーザーがキャンセルした場合、リクエストが期限切れになった場合、または検証に失敗した場合、Diditはその国のwallet.on_failure設定を適用します。 fallback_to_documentは、フィンランドで書類認証が有効になっている場合に書類の撮影を開始します。 declineは本人確認ステップを却下します。 無効になっている書類認証方法はフォールバックとして使用できません。 ユーザーをまずFinnish Trust Networkに誘導し、失敗した後にのみ書類の撮影を表示するには、document.fallback_onlyをtrueに設定します。 書類の撮影をフォールバックとしてのみ提供するを参照してください。 リダイレクトや銀行選択画面の表示は、本人確認の成功を意味しません。 アクセスを許可する前に、検証済みのセッション結果またはWebhookを待ってください。 Webhookの重複配信は、連携の他の部分と同じ冪等な処理で対応してください。

​
テストと本番公開

ウォレットが有効になっている環境でテストしてください。 正常な復帰、ユーザーによるキャンセル、期限切れ、不完全な本人確認、書類認証へのフォールバックをテストしてください。 ユーザーが利用するデバイスやブラウザ環境もテストしてください。 サンドボックスでのシミュレーション結果は、実際の銀行認証や本番環境での有効化を証明するものではありません。 FTNの料金は、公開されている基本料金で完了した認証1件あたり$0.25です。 キャンセル、期限切れ、失敗したウォレットの試行には、完了したウォレット認証の料金は発生しません。 完了した書類認証へのフォールバックは、書類認証の料金に基づいて別途請求されます。 現在の請求ルールについては、ウォレットの料金を参照してください。

​
関連ガイド

最終更新日 2026年11月1日