プロダクトレベルの年齢保証
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 は次の順序でユーザーをチェックします:
- 禁止。 その市場でプロダクトが利用できない場合、または申告された年齢がプロダクトの最低年齢を下回る場合、レスポンスは
PROHIBITEDです。年齢保証は実行されません。 - 年齢保証。 その市場でプロダクトレベルの年齢保証が有効で、申告された年齢がトリガー年齢以上の場合、レスポンスは
CHALLENGE_AGE_GATE_AGE_ASSURANCEチャレンジです。ただし、信頼できるプラットフォーム年齢シグナルがすでにユーザーがその年齢を満たしていることを証明している場合を除きます。 - 合格。 申告された年齢で保護者の同意が不要な場合、レスポンスはセッション付きの
PASSです。 - 保護者の同意。 それ以外の場合、レスポンスは
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 は信頼できる大人の同意ポータルではなく、ユーザーが自分自身で確認を行うページを指しているため、直接表示できます。
チャレンジの処理
- チャレンジを表示します。 アプリに適したサーフェスで
challenge.urlを表示します:allow="camera;payment;publickey-credentials-get;publickey-credentials-create"を指定したWebのiframe- モバイルではシステムブラウザ(モバイルアプリクイックスタートを参照)
- アプリ内ブラウザサーフェス
- コンソールでのQRコードによるハンドオフ
- UIを更新します。 iframeまたは同一ウィンドウのホストでは、ユーザーが完了するとページが
Verification.ResultDOMメッセージをポストします。これはiframeを閉じるためだけに使用してください。結果ではありません。モバイルやその他のホストでは、リダイレクトURLを渡します(チャレンジ完了後のリダイレクトを参照)。 - サーバー側で結果を確認します。
Challenge.StateChangewebhookを使用するか、/challenge/get-statusをポーリングします。PASSの場合、sessionIdに新しく作成されたセッションが含まれます。 - セッションを読み込みます。
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 の場合のみ存在) |
status | PASS または 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 を通じてサーバー側で結果を確認してください。