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

# 本人確認: サインアップ時の検証と出金前のステップアップ認証

> アカウント作成前にライブネス検知または本人確認を必須にし、出金などの重要な操作の前に再確認します。検証済みクレームをトークンで取得できます（Didit）。

Didit Authenticationの検証済み本人確認では、アカウント作成前と、出金などの機密性の高いアクションを行う前に再度、利用者が本人であることの証明を求めます。確認するタイミングは、お客様が選べます。
アプリは結果と、選択した検証済みクレーム（たとえば `over_18` や検証済みの氏名）を、利用者のトークン内で受け取ります。書類や写真は決して受け取りません。

コンソールの**Authentication > Verified identity**で設定するか、APIの[`verified/`](#apiで設定する)を使って設定できます。

![Didit Business ConsoleのVerified identityページ。サインアップ時の確認レベルと料金、機密性の高いアクション前のステップアップルールが表示されている](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: サインアップ時の確認と、機密性の高いアクション前のルール。

## 仕組み

すべてのチェックは、お客様のアプリケーションの検証セッションとして実行され、そのユーザーの`vendor_data`を指定して作成されます。
つまり、このセッションはお客様の検証一覧に表示され、同じユーザーのサインインや取引と紐付けられます。他の検証と同様に手動レビューの対象となり、その検証の料金で請求されます。

| チェック | ユーザーの操作 | 標準料金 |
| - | - | - |
| Liveness | 自撮り写真を1枚撮影し、ライブネスを確認します。 | \$0.10 |
| Selfie login | Didit がそのユーザーについて既に保持している顔と照合される自撮り写真を撮影します。 | \$0.10 |
| Full ID | 身分証明書をスキャンし、自撮り写真を撮影します。書類、ライブネス、顔照合を行います。 | \$0.33 |

Didit は各チェックをデフォルトのワークフローで実行します。または、チェックごとにお客様のワークフローを選択して実行することもできます。
検証ごとの料金は、[料金](https://docs.didit.me/ja/getting-started/pricing.md)をご覧ください。

## サインアップ時

アカウントが作成される前に本人が通過する必要があるレベルを選択します：

| レベル | 値 | 意味 |
| - | - | - |
| 認証なし | `none` | メールアドレス、電話番号、またはパスキーを持つ人なら誰でもサインアップできます。デフォルト設定です。 |
| ライブネス検知 | `liveness` | 実在する人物がサインアップします。セルフィー1枚をライブネス検知で確認します。 |
| フル本人確認 | `full_id` | アカウントが作成される前に、書類、ライブネス検知、顔照合を行います。 |

新しいレベルは、その後にサインアップする人にのみ適用され、既存のアカウントには決して適用されません。

ホスト型ページでは、Diditがサインアップ中に本人をこの確認プロセスに案内します。
独自の画面を使用する場合、サインアップのリクエストは`verification_required`と、30分間有効な`verification_url`を返します。そのURLに本人を誘導してください。
Didit は、確認が承認された後にのみサインインコードを発行します。

## 機密性の高いアクションの前のステップアップ認証

ステップアップ認証は、アクションのリスクが十分に高い場合にだけ、本人に再度の確認を求めます。
ルールを有効にすると、アプリは機密性の高いアクションを行うたびに、該当するルールがあるかどうかをDiditに問い合わせます。

![本人であることをセルフィーで確認するよう求めるステップアップ認証を表示しているスマートフォン](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

セルフィーによるステップアップ認証を求められたときに本人に表示される画面。

| ルール | 確認が必要になる条件 | 既定のチェック |
| - | - | - |
| `payout` | 出金または送金の金額がしきい値（お使いの通貨で500など）を超えるとき。別の通貨での出金または送金は常に確認します。 | セルフィーログイン |
| `device` | 本人の過去のセッションのいずれからも使用されていないデバイスで、出金または送金が行われるとき。 | セルフィーログイン |
| `bank` | 本人が銀行口座を追加または変更するとき。 | 完全な本人確認 |
| `contact` | 本人がメールアドレスまたは電話番号を変更するとき。 | ライブネス検知 |

各ルールの確認方法は、ライブネス検知、セルフィーログイン、完全な本人確認のいずれかに変更できます。
複数のルールが適用される場合、Diditは最も強い確認方法を求めます。
本人の顔データがまだDiditにない場合、セルフィーログインは完全な本人確認に置き換わります。

### ステップアップ認証を依頼する

アプリは、本人のアクセストークンを添えて`POST {issuer}/step-up/`を呼び出すか、SDKの`stepUp()`メソッドを使います。

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| フィールド | ルール |
| - | - |
| `action` | `payout`、`bank`、`contact`のいずれかです。payoutの場合は`device`ルールも適用されます。 |
| `amount` | `payout`の場合に必須です。小数点以下は2桁まで指定できます。 |
| `currency` | ISO 4217のコードです。既定値はpayoutルールの通貨です。 |
| `return_to` | 確認後に本人が戻る先です。ルールが適用される場合は、登録済みの[リダイレクトURL](https://docs.didit.me/ja/authentication/overview.md#リダイレクトurl)のいずれかである必要があります。 |

* `200 {"required": false}`: 該当するルールがないため、そのまま処理を進めてかまいません。
* `201`と`verification_url`: 本人をそのURLに誘導してください。ステップアップ認証は30分間（`expires_in: 1800`）有効です。

### バックエンドで結果を確認する

本人は`step_up=<id>&status=approved`を付けて`return_to`に戻りますが、そのクエリパラメーターだけでは何も証明されません。
バックエンドは、同じセッションのアクセストークンを使って`GET {issuer}/step-up/{step_up_id}/`を呼び出し、`status`が`approved`の場合にのみアクションを実行してください。

| ステータス | 意味 |
| - | - |
| `pending` | 本人がまだ確認を完了していません。 |
| `approved` | 本人が確認に通りました。アクションを続行してください。 |
| `review` | 確認はチームのレビュー待ちです。 |
| `declined` | 本人は確認に通りませんでした。`verification_url`がまだ有効な間は最終結果ではありません。本人は再試行でき、ステップアップ認証は`pending`に戻ります。 |
| `expired` | 30分が経過しました。新しいステップアップ認証を作成してください。 |
| `superseded` | 別の確認が優先されたか、結果がこのステップアップ認証のものではありませんでした。新しく作成してください。 |

ステップアップ認証はフェイルオープンになりません。確認が利用できない場合、アクションはブロックされたままです。
[JavaScript](https://docs.didit.me/ja/authentication/quickstarts/javascript.md#ステップアップと再認証)、[Next.js](https://docs.didit.me/ja/authentication/quickstarts/nextjs.md#機密性の高い操作を行う前のステップアップ)、[iOS](https://docs.didit.me/ja/authentication/quickstarts/ios.md#機密性の高い操作の前のステップアップ認証)のクイックスタートでSDK側の実装を確認でき、[APIリファレンス](https://docs.didit.me/ja/authentication/api-reference/create-step-up.md)に完全な仕様があります。

## アプリが受け取るもの

トークンに含めるクレームを選択します。

| クレーム | 値 |
| - | - |
| `over_18`, `over_21` | 検証済みの生年月日に基づき、本人が18歳以上か、21歳以上かどうかです。 |
| `given_name`, `family_name` | 検証済みの名と姓です。 |
| `birthdate` | 書類に記載された生年月日で、`YYYY-MM-DD`形式です。 |
| `nationality` | ISO 3166-1 alpha-2コードです。 |
| `country` | 書類の発行国のISO 3166-1 alpha-2コードです。 |
| `document_verified` | 本人確認書類が検証されたかどうかです。 |
| `liveness` | ライブネス検知を通過したかどうかです。 |

アクセストークンとIDトークンには、これらのクレームが`verified`に含まれます。`level`には、本人が通過した最も高いレベルが入ります。値は`liveness`、`liveness_face_match`、`full_id`のいずれかです。本人がどのレベルも通過していない場合は`{}`になります。その場合、`GET /session/`は代わりに`null`を返します。

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* セッション中に承認されたチェックは、次回のリフレッシュ時（5分以内）にトークンへ反映されます。
* トークンを保持するものは、フロントエンドを含め、これらのクレームを読み取れます。そのため、アプリに必要な個人クレームだけを選択してください。
* アプリが受け取るのはクレームだけです。書類、セルフィー、顔データは受け取りません。

## APIで設定する

お使いのアプリケーションの[認証管理API](https://docs.didit.me/ja/authentication/set-up-by-api.md)にある`verified/`に対する`GET`と`PATCH`は、コンソールと同じ設定を読み取り、変更します。

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| フィールド | 値 |
| - | - |
| `signup_level` | `none`、`liveness`、または`full_id`。 |
| `rules` | 変更するルールごとに1件ずつ指定します。`rule`（`payout`、`device`、`bank`、または`contact`）、`enabled`、`method`（`liveness`、`selfie`、または`full_id`）があり、`payout`の場合のみ`threshold`と`currency`を指定します。 |
| `claims` | トークンに含めるクレーム。上の表にあるものから指定します。 |
| `workflows` | 任意。`liveness`、`selfie`、`full_id`のそれぞれに使う独自のワークフローIDを指定できます。`null`を指定すると、Diditのデフォルトを使用します。 |

指定を省略したルールは、現在の設定がそのまま維持されます。


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