機能レベルの年齢保証
ユーザーが保護された機能に到達したときにCDKが年齢の証明を求める仕組みと、その後に権限が解除される流れ。
機能レベルの年齢保証は、Adaptive Accessのうち、サインアップ時ではなく、ユーザーが保護された機能に到達したときに年齢の証明を求める部分です。一部の市場の一部の権限は、有効にする前に確認済み年齢が必要です。たとえば、市場のルールで求められる場合の有料ルートボックスやターゲティング広告などです。閾値以上では、これらの権限はユーザーが年齢を証明するまで無効のままです。証明には、確認済みと見なされるプラットフォーム年齢シグナルか、POST /session/upgrade から返される CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE チャレンジを使用します。権限の最低年齢が閾値より低い場合、最低年齢以上で閾値未満のユーザーについて保護者が同意できます。最低年齢が閾値と同じ場合、保護者は同意できず、閾値未満のユーザーはその権限を得られません。
ステップごとの統合手順については、機能利用時の年齢保証クイックスタートを参照してください。
このページの目的
以下を理解する必要がある場合にこのページを使用してください:
- ユーザーがすでに年齢ゲートを通過した後も権限が無効のままである理由
POST /session/upgradeが権限を即座に有効にするか、チャレンジを返すか- 閾値を満たしているがまだ年齢を確認していないユーザーへの対応方法
- 最低年齢を下回る年齢を最初に申告したユーザーの回復方法
有効化
機能レベルの年齢保証は、Compliance Studioの エンジンとオーバーライド > グローバルルールの編集 にある 機能レベルのアクセス で制御され、市場ごとに変更できます。新しいプロダクトでは はい に設定された状態で始まります。既存のプロダクトでは、変更するまで いいえ と表示されます。Adaptive Accessの設定を参照してください。
ある市場で 機能レベルのアクセス が いいえ に設定されている場合、Compliance Studioから公開する設定では、CDKのルールで求められる場合であっても、その市場のどの権限にも verifiedAgeThreshold は付与されません。
確認済み年齢閾値
verifiedAgeThreshold とは、申告または推定された年齢ではなく、確認済み年齢が必要であることを意味します。どの権限に閾値があり、それが何歳かは、ユーザーの市場に対するCDKのルールと、Compliance Studioで設定したオーバーライドによって決まります。閾値はセッションから、または /age-gate/get-requirements から読み取ってください。後者は、その市場で verifiedAgeThreshold を持つすべての権限を permissions の下に一覧表示します。アプリ内で閾値をハードコードしないでください。
verifiedAgeThreshold を持つ権限の場合:
- 権限の最低年齢未満の場合、権限は
managedBy: PROHIBITEDです。 - 最低年齢以上で閾値未満の場合、権限は
managedBy: GUARDIANです。保護者は、年齢保証ではなく標準の保護者同意フローで権限に同意できます。 - 閾値以上の場合、権限は
managedBy: PLAYERで、ユーザーが確認するまで無効のままです。ただし、ユーザーが閾値に達する前に保護者が権限を有効にしていた場合を除きます。
権限の最低年齢が閾値と同じ場合、その権限が managedBy: GUARDIAN になることはありません。閾値未満では PROHIBITED です。
権限状態のロジック
権限に verifiedAgeThreshold がある場合、Permission オブジェクトにそのフィールドが含まれます:
{
"name": "loot-boxes-paid-gameplay-impacting",
"enabled": false,
"managedBy": "PLAYER",
"verifiedAgeThreshold": 18
}| ユーザーの年齢と閾値の比較 | 年齢確認済み? | managedBy | enabled |
|---|---|---|---|
| 最低年齢未満 | N/A | PROHIBITED | false |
| 最低年齢以上、閾値未満 | N/A | GUARDIAN | 保護者が同意した後のみ true |
| 閾値以上 | いいえ | PLAYER | false(ユーザーが閾値に達する前に保護者が有効にした場合を除く) |
| 閾値以上 | はい(確認済みプラットフォームシグナル経由) | PLAYER | true |
| 閾値以上 | はい(年齢保証経由) | PLAYER | true |
保護者の同意で閾値のある権限を解除できるのは、ユーザーが閾値未満の間だけです。閾値以上では保護者の同意は確認済み年齢の代わりになりませんが、保護者が以前に有効にした権限は有効のままです。
セッションの ageVerification
確認済みプラットフォームシグナルが処理されるか、年齢保証チャレンジが完了すると、セッションに ageVerification オブジェクトが保存されます:
{
"ageVerification": {
"verifiedAge": 18,
"platformName": "apple-ios",
"declarationType": "governmentIDChecked",
"verifiedAt": "2026-03-14T00:00:00Z"
}
}この確認は再利用可能です。セッションに記録されると、同じかより低い閾値を持つ権限に対する後続の POST /session/upgrade は、新しいチャレンジなしで許可されます。
セッションアップグレードフロー
POST /session/upgrade は、ユーザーが権限を即座に取得できるか、先に確認が必要かを決定します。
セッションアップグレードAPI
関連するリクエストフィールド:
| フィールド | 型 | 説明 |
|---|---|---|
platformAgeSignal | PlatformAgeSignal | 閾値を即座に満たすことができるプラットフォームシグナル |
options | object | 年齢保証エクスペリエンスに転送されるオプション |
options.facialAgeEstimation.passIfOver | integer | 顔年齢推定が合格とすべき最小年齢。k-IDのデフォルトを使用する場合は未設定のままにします。顔年齢推定のマージンを参照してください。 |
options.facialAgeEstimation.failIfUnder | integer | 推定年齢の範囲全体がこの年齢未満の場合にのみ、顔年齢推定は不合格になります。範囲がこの年齢にかかる場合は不確定となり、ユーザーは別の方法を試せます |
options.redirectUrl | string | チャレンジ完了後のリダイレクト先。トップレベルのブラウザコンテキスト(iframe 内ではない)で実行される場合に適用されます。http(s) およびカスタムスキームのモバイルディープリンク(例: myapp://upgrade/return)を受け付けます。安全でないスキームは拒否され、リダイレクトは行われません。完了時に k-ID は challengeId、productId、sessionId(PASS の場合のみ付与)、status(PASS または FAIL)、type を付加します。結果はサーバー側で確認してください。クエリパラメータは UX 上のヒントとして扱ってください。 |
リクエスト例(確認済みプラットフォームシグナルが権限を満たす場合):
POST /api/v1/session/upgrade
{
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
"requestedPermissions": [
{ "name": "loot-boxes-paid-gameplay-impacting" }
],
"platformAgeSignal": {
"name": "apple-ios",
"ageLow": 18,
"ageHigh": 25,
"declarationType": "governmentIDChecked"
}
}{
"session": {
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
"permissions": [
{
"name": "loot-boxes-paid-gameplay-impacting",
"enabled": true,
"managedBy": "PLAYER",
"verifiedAgeThreshold": 18
}
],
"ageVerification": {
"verifiedAge": 18,
"platformName": "apple-ios",
"declarationType": "governmentIDChecked",
"verifiedAt": "2026-03-14T00:00:00Z"
}
}
}リクエスト例(ユーザーが閾値を満たしているが年齢保証が必要な場合):
POST /api/v1/session/upgrade
{
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
"requestedPermissions": [
{ "name": "loot-boxes-paid-gameplay-impacting" }
],
"options": {
"redirectUrl": "https://mygame.com/callback"
}
}{
"session": {
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
"permissions": [
{
"name": "loot-boxes-paid-gameplay-impacting",
"enabled": false,
"managedBy": "PLAYER",
"verifiedAgeThreshold": 18
}
]
},
"challenge": {
"challengeId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE",
"url": "https://family.k-id.com/session/upgrade/age-assurance?token=..."
}
}結果例(ユーザーが権限の最低年齢を下回っている場合):
{
"session": {
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
"permissions": [
{
"name": "loot-boxes-paid-gameplay-impacting",
"enabled": false,
"managedBy": "PROHIBITED",
"verifiedAgeThreshold": 18
}
]
}
}この場合、この年齢ではユーザーも保護者も権限を有効にできないため、チャレンジは返されません。
結果例(ユーザーが閾値未満で、最低年齢以上の場合):
この例では、multiplayer の最低年齢が 13、閾値が 18 のプロダクトで、ユーザーは 15 歳です。
{
"session": {
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187",
"permissions": [
{
"name": "multiplayer",
"enabled": false,
"managedBy": "GUARDIAN",
"verifiedAgeThreshold": 18
}
]
},
"challenge": {
"challengeId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"oneTimePassword": "ABC123",
"type": "CHALLENGE_SESSION_UPGRADE",
"url": "https://family.k-id.com/authorize?otp=ABC123"
}
}これは標準のアップグレードフローと同じ保護者チャレンジです。保護者が承認すると権限が有効になります。年齢保証は実行されません。
主な動作:
- リクエストされた権限は、すべてが
verifiedAgeThresholdを持つか、すべてが持たないかのどちらかである必要があります。両方を混在させたリクエストは400を返します。 - ユーザーがデジタル同意年齢を下回っている場合、リクエストは年齢保証ではなく標準の保護者同意フローを使用します
- ユーザーがリクエストされたすべての閾値を下回っている場合、リクエストは保護者に送られます。レスポンスには、まだ有効になっていない
GUARDIAN権限に対するCHALLENGE_SESSION_UPGRADEチャレンジが含まれます。PROHIBITED権限は除外されます。権限が残らず、リクエストに法的文書も同意期限もない場合、チャレンジは発行されません - ユーザーがリクエストされたすべての閾値を下回っているかどうかは、セッションの年齢で決まります。プラットフォームの年齢は、この保護者パスでも年齢保証パスでも読み取られます。プラットフォームの年齢によって、リクエストが一方のパスからもう一方に移ることはありません。保護者パスでは、プラットフォームの年齢が権限の最低年齢を下回っている場合、その権限はチャレンジから除外されます。年齢保証パスでは、プラットフォームの年齢が閾値を下回っている場合に除外されます。デジタル同意年齢未満のリクエスト、年齢保証が無効なリクエスト、Safe Start のアップグレードでは、プラットフォームの年齢は読み取られません
- セッションの年齢がリクエストされた閾値の少なくとも1つを満たしている場合、リクエストは年齢保証に進みます。ユーザーがまだ閾値を下回っているリクエスト済みの権限は除外され、それらに対する保護者チャレンジは発行されません。保護者に依頼するには、それらの権限を別の呼び出しでリクエストしてください
materialChangeと法的文書のオプションは、この保護者パスでは標準フローと同じように機能します。年齢保証パスでは400を返します- 確認済みプラットフォームシグナルは、リクエストされた一部またはすべての権限を即座に満たすことができます
- セッション上の既存の
ageVerificationもリクエストを満たすことができます - まだ未解決の権限のみが年齢保証チャレンジになります
異なる年齢の権限をリクエストする
異なる閾値を持つ権限を1回の呼び出しでリクエストできます。たとえば、16歳以上の機能と18歳以上の機能です。チャレンジはリクエストされた年齢のうち最も高い年齢を確認し、ユーザーの確認は1回で済みます。チェックに合格すると、リクエストされたすべての権限が有効になります。不合格の場合は、どの権限も有効になりません。ID文書で17歳であることが示されたユーザーは、その呼び出しでは16歳以上の権限も18歳以上の権限も取得しません。より低い年齢の機能を単独で解除できるようにするには、別の呼び出しでリクエストしてください。
セッションアップグレードは、リクエストした権限のみを有効にします。リクエストしていない権限を有効にすることも、権限を無効にすることもありません。
チャレンジ結果の処理
チャレンジURLはチャレンジの種類によって異なります。
CHALLENGE_SESSION_UPGRADEはhttps://family.k-id.com/authorize?otp=...を指します。保護者はそこで承認し、完了は標準のアップグレードフローに従います。CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCEはhttps://family.k-id.com/session/upgrade/age-assurance?token=...を指します。以下の手順はこの種類のためのものです。
URLの有効期限は、token クエリパラメータ内のJWTの exp クレームとしてエンコードされています。ライブモードでは、チャレンジURLはデフォルトで 2週間 有効ですが、一部の管轄区域ではより短くなります(たとえばインドネシアでは、保護者の同意チャレンジは作成後24時間で期限切れになります)。テストモードでは、待たずに期限切れURLの処理を試せるよう 7分 のみ有効です。詳しくは チャレンジURLとメールリンクの有効期限 を参照してください。
ユーザーがこのURLを開くと:
- トークンが解析・検証されます。
- チャレンジがすでに解決されている場合、ユーザーは完了ページにリダイレクトされます。
- まだ保留中の場合、プロダクトに設定された年齢保証の方法(顔年齢推定やID文書スキャンなど)を表示する確認iframeが表示されます。
- 完了時、結果が統合先に送信されます。
結果を受け取る方法は3つあります:
オプション1:postMessage をリッスン
iframeまたはwebview統合の場合、チャレンジページは Challenge.StateChange メッセージを親ウィンドウにポストします:
{
"eventType": "Challenge.StateChange",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"productId": "your-product-id",
"status": "PASS",
"type": "CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE"
}
}警告
DOM postMessage イベントはUIを更新するために役立ちますが、信頼できる情報源ではありません。サーバー側のロジックには、webhookまたはポーリングエンドポイントを使用してください。
オプション2:GET /challenge/get-status をポーリング
GET /api/v1/challenge/get-status?challengeId=a1b2c3d4-e5f6-7890-abcd-ef1234567890可能なステータスは PASS、FAIL、PENDING、IN_PROGRESS です。
オプション3:Challenge.StateChange webhookを受信
k-IDは、チャレンジステータスが変更されるたびに、設定されたエンドポイントに Challenge.StateChange webhookイベントをポストします:
{
"eventType": "Challenge.StateChange",
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"productId": 11472,
"status": "PASS",
"type": "CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE",
"sessionId": "608616da-4fd2-4742-82bf-ec1d4ffd8187"
}
}| フィールド | 説明 |
|---|---|
data.id | POST /session/upgrade によって返された challengeId |
data.status | PASS、FAIL、または IN_PROGRESS |
data.type | チャレンジタイプ(例:CHALLENGE_SESSION_UPGRADE_BY_AGE_ASSURANCE) |
data.sessionId | PASS 時に存在:更新されたセッションを取得するために使用 |
合格したチェックによってセッションの権限が変わった場合、k-IDはそのセッションについて Session.ChangePermissions webhookも送信します。
Webhookはリアルタイムで配信され、ポーリングを必要としないため、サーバー側の処理に推奨されるアプローチです。フィールドリファレンスとステータスライフサイクルの完全な情報については、Challenge.StateChange を参照してください。
結果後
PASS後、GET /session/getを呼び出し、更新された権限を使用します。チェックで証明された権限が有効になり、セッションにageVerificationが含まれます。FAIL後、権限は無効のままです。ユーザーは後で別のPOST /session/upgrade呼び出しを通じて再試行できます。failureReason: below-minimum-ageでFAILになった場合、セッションは終了しています。確認によってセッションが終了する場合を参照してください。
最低年齢を下回る年齢を入力したユーザーの回復フロー
ユーザーが権限の最低年齢を下回る申告年齢を入力し、PROHIBITED 権限になる場合があります。その場合、セッションはすでにユーザーがその機能には年齢が足りないと示しているため、通常の session/upgrade フローでは問題を解決できません。
この回復フローの対象:
- プレイヤー管理のセッション
- 承認者がまだリンクされていない保護者管理のセッション
承認者がすでにリンクされている保護者管理のセッションには適していません。
回復手順
- ユーザーを年齢申し立てに誘導します。 適切な
jurisdictionとcriteriaを指定してPOST /age-verification/perform-age-appealを呼び出します。返されたURLをアプリに適したサーフェスで表示して(Webのiframe、ポップアップ、またはリダイレクト、モバイルではシステムブラウザ、アプリ内ブラウザサーフェス、またはコンソールでのQRコードによるハンドオフ)、ユーザーが年齢確認を完了できるようにします。モバイルの詳細については、モバイルアプリクイックスタートを参照してください。申し立てが失敗した場合にユーザーが既存のセッションを保持し、VPCを再度行う必要がないように、まだセッションを無効化しないでください。 - 年齢申し立ての結果を処理します。 DOMイベント、webhook、または
GET /age-verification/get-statusを通じて結果をリッスンします。- 成功時: 申し立てにより、ユーザーの確認済み年齢を証明する
verificationIdが生成されます。 - 失敗時: 機能は禁止されたままです。ユーザーは最初に申告した年齢のままで、既存のセッションは保持されます。
- 成功時: 申し立てにより、ユーザーの確認済み年齢を証明する
- **セッションを無効化します。**異議申し立てが成功したら、
POST /session/deleteで古いセッションを削除し、そのsessionIdを破棄します。 - k-IDシグナルを使用して年齢ゲートフローを再開します。 申し立てからの
verificationIdをk-idプラットフォームシグナルとして送信し、ユーザーが以前に入力した年齢や生年月日は含めないでください。プラットフォームシグナルはユーザーが申告した年齢を超えて確認することはないため、以前のより低い年齢が優先されてしまいます。
POST /api/v1/age-gate/check
{
"jurisdiction": "BR",
"platformAgeSignal": {
"name": "k-id",
"verificationId": "<verificationId from age appeal>"
}
}k-IDは verificationId から確認済み年齢を解決します。確認済み年齢が verifiedAgeThreshold 以上であれば、権限が有効な状態でセッションが作成されます。
権限の順次アップグレード
各閾値権限は独立して追跡されます:
- 1つの権限をアップグレードしても、他の権限が自動的にアップグレードされるわけではありません
- 各権限は引き続き
POST /session/upgradeを通じてリクエストする必要があります - セッションに
ageVerificationが記録されると、同じかより低い閾値を持つ後続の権限は、別のチャレンジなしで許可されます