CDKAdaptive Access

プロダクトレベルの年齢保証

CDKが年齢ゲートでユーザーに年齢の証明を求め、合格した後にのみセッションを作成する仕組み。

プロダクトレベルの年齢保証は、Adaptive Accessのうち、セッションが存在する前の年齢ゲートで年齢の証明を求める部分です。適用される場合、POST /age-gate/check は PASS ではなく CHALLENGE_AGE_GATE_AGE_ASSURANCE チャレンジを返します。ユーザーは自分自身で確認を行い(信頼できる大人は関与しません)、ユーザーが合格した後にk-IDがセッションを作成します。

プロダクトレベルの年齢保証は、以前はAutomatic age assuranceと呼ばれていました。

ステップごとの統合手順については、エントリー時の年齢保証クイックスタートを参照してください。

有効化

プロダクトレベルの年齢保証は、Compliance Studioの エンジンとオーバーライド > グローバルルールの編集 にある プロダクトレベルのアクセス で制御され、市場ごとに変更できます。有効にしない限り いいえ に設定されています。はい に設定すると、トリガー年齢も選択します。その年齢以上を申告したすべてのユーザーは確認を行う必要があります。トリガー年齢のデフォルトは市場の法定成人年齢で、市場のデジタル同意年齢を下回ることはありません。Adaptive Accessの設定を参照してください。

プロダクトレベルのチェックはトリガー年齢以上のすべてのユーザーに影響します

プロダクトレベルの年齢保証は、制限された機能に一度も到達しないユーザーも含め、トリガー年齢以上のすべてのユーザーをサインアップ時に確認します。一部の機能だけが確認済み年齢を必要とする場合は、代わりに機能レベルの年齢保証を使用してください。ライブのプロダクトで有効にする前に、k-IDのアカウントマネージャーにご相談ください。

トリガーされる条件

/age-gate/check は次の順序でユーザーをチェックします:

  1. 禁止。 その市場でプロダクトが利用できない場合、または申告された年齢がプロダクトの最低年齢を下回る場合、レスポンスは PROHIBITED です。年齢保証は実行されません。
  2. 年齢保証。 その市場でプロダクトレベルの年齢保証が有効で、申告された年齢がトリガー年齢以上の場合、レスポンスは CHALLENGE_AGE_GATE_AGE_ASSURANCE チャレンジです。ただし、信頼できるプラットフォーム年齢シグナルがすでにユーザーがその年齢を満たしていることを証明している場合を除きます。
  3. 合格。 申告された年齢で保護者の同意が不要な場合、レスポンスはセッション付きの PASS です。
  4. 保護者の同意。 それ以外の場合、レスポンスは CHALLENGE_PARENTAL_CONSENT チャレンジです。プロダクトレベルの年齢保証は、保護者の同意の経路を変更しません。

信頼できるプラットフォームシグナルは、その ageLow がチェック対象の年齢以上の場合にチャレンジをスキップします。たとえば、declarationType: governmentIDChecked を持つ apple-ios シグナルです。xbox と meta-horizon のシグナルがチャレンジをスキップすることはありません。どのシグナルが信頼できるものとみなされるかについては、プラットフォーム年齢シグナルを参照してください。

`ageAssuranceRequired` はこのチャレンジを予測しません

/age-gate/get-requirements の ageAssuranceRequired フィールドは、Compliance Studioの 年齢保証レポート で設定した値を報告します。チェックを開始することはなく、/age-gate/check が CHALLENGE_AGE_GATE_AGE_ASSURANCE チャレンジを返すかどうかも示しません。常に /age-gate/check レスポンスの challenge.type で分岐してください。

CHALLENGE_AGE_GATE_AGE_ASSURANCE レスポンスの例

{
  "status": "CHALLENGE",
  "challenge": {
    "challengeId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "CHALLENGE_AGE_GATE_AGE_ASSURANCE",
    "url": "https://family.k-id.com/age-gate/verify?token=..."
  }
}

セッションは返されません。CHALLENGE_PARENTAL_CONSENT とは異なり、レスポンスに oneTimePassword は含まれません。url は信頼できる大人の同意ポータルではなく、ユーザーが自分自身で確認を行うページを指しているため、直接表示できます。

チャレンジの処理

  1. チャレンジを表示します。 アプリに適したサーフェスで challenge.url を表示します:
    • allow="camera;payment;publickey-credentials-get;publickey-credentials-create" を指定したWebのiframe
    • モバイルではシステムブラウザ(モバイルアプリクイックスタートを参照)
    • アプリ内ブラウザサーフェス
    • コンソールでのQRコードによるハンドオフ
  2. UIを更新します。 iframeまたは同一ウィンドウのホストでは、ユーザーが完了するとページが Verification.Result DOMメッセージをポストします。これはiframeを閉じるためだけに使用してください。結果ではありません。モバイルやその他のホストでは、リダイレクトURLを渡します(チャレンジ完了後のリダイレクトを参照)。
  3. サーバー側で結果を確認します。 Challenge.StateChange webhookを使用するか、/challenge/get-status をポーリングします。PASS の場合、sessionId に新しく作成されたセッションが含まれます。
  4. セッションを読み込みます。 sessionId を指定して /session/get を呼び出し、ユーザーの権限を読み取ります。

年齢ゲートまたはエンドツーエンドウィジェットを使用する場合、ウィジェットはフローの中でチェックを実行します。Widget.AgeGate.Result イベントはフローが完了すると発火し、PASS の場合は sessionId を含みます。

これらのセッションには `Session.Created` webhookはありません

プロダクトレベルのチェック後に作成されたセッションは、status: PASS と sessionId を持つ Challenge.StateChange を通じて報告されます。k-IDはそのセッションについて別途 Session.Created イベントを送信しません。

セッションの内容

ユーザーが合格すると、k-IDはセッションを作成します:

  • 権限と生年月日は、ユーザーが申告した年齢ではなく、チェックで確認された年齢(ID文書上の生年月日など)に基づきます。たとえば、35歳と申告し、顔年齢推定で19歳と推定されて合格したユーザーには、19歳のセッションが作成されます。
  • 確認済み年齢が必要な機能の権限は、証明された年齢まですでに解除されています。18歳であることを証明したユーザーは、18歳以上の機能について別のチェックを受ける必要はありません。
  • ageVerification は結果を記録するため、同じかより低い年齢での後続の機能レベルのチェックは、別のチャレンジなしで許可されます。

ユーザーが不合格の場合、チャレンジは status: FAIL で終了し、セッションは作成されません。

チャレンジ完了後のリダイレクト

チャレンジがトップレベルのブラウザコンテキスト(iframe内ではない)で実行される場合、たとえばk-IDに引き渡してから戻るモバイルアプリの場合、リダイレクトURLを指定すると、確認の完了後にk-IDがユーザーをそのURLに送ります。/age-gate/check で options.playerAgeAssurance.redirectUrl として渡してください。このオプションは CHALLENGE_AGE_GATE_AGE_ASSURANCE にのみ適用されます。CHALLENGE_PARENTAL_CONSENT は代わりに信頼できる大人のフローを通じて戻ります。

URLは http(s) およびカスタムスキームのモバイルディープリンク(例: myapp://age-gate/return)を受け付けます。安全でないスキームは拒否され、リダイレクトは行われません。ユーザーがチャレンジを完了または閉じた後、k-IDは次のクエリパラメータをURLに付加してそこに遷移します:

パラメータ説明
challengeId完了したチャレンジ
productId年齢ゲートのチェック対象となったプロダクト
sessionId新しく作成されたセッション(PASS の場合のみ存在)
statusPASS または FAIL
typeチャレンジタイプ、CHALLENGE_AGE_GATE_AGE_ASSURANCE

リダイレクトURL上の既存のクエリパラメータは保持されます。

リクエスト例:

POST /api/v1/age-gate/check
Content-Type: application/json
Authorization: Bearer your-api-key

{
  "jurisdiction": "US-CA",
  "dateOfBirth": "2008-04-15",
  "options": {
    "playerAgeAssurance": {
      "redirectUrl": "https://mygame.com/age-gate/return"
    }
  }
}

確認に成功した後、ユーザーはたとえば次のURLに遷移します:

https://mygame.com/age-gate/return?challengeId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&productId=42&sessionId=608616da-4fd2-4742-82bf-ec1d4ffd8187&status=PASS

アプリへのリダイレクトは結果ではありません。アクセスを許可する前に、Challenge.StateChange webhookまたは /challenge/get-status を通じてサーバー側で結果を確認してください。

On this page