メインコンテンツに移動

15件の投稿件のタグ「documentation」を含む

すべてのタグを見る

ウィジェットと年齢確認に関するモバイル統合ガイダンス

モバイルでk-IDをどのように統合すべきかを明確にするため、ドキュメントを更新しました。年齢ゲートと同意フローはネイティブに構築し、Web埋め込みは年齢確認URLに限定してください。

新機能​

年齢ゲートとエンドツーエンドウィジェットに関するモバイルガイダンス​

年齢ゲートウィジェットとエンドツーエンドウィジェットは、モバイルアプリには推奨されません。モバイルでは、カスタムワークフローを使用し、CDK UXガイドラインに従って年齢ゲートと同意のUX要素をネイティブに構築してください。

モバイルでサポートされる唯一のWeb埋め込みは、k-ID APIから返される年齢確認URLと年齢保証URLです。具体的なエンドポイントとチャレンジタイプについては、モバイルアプリガイドを参照してください。

モバイルアプリガイドの刷新​

モバイルアプリガイドは、モバイルでのWeb埋め込みが引き続き推奨されるフローである年齢確認を中心に再構成されました：

デフォルトブラウザ方法​

モバイル実装方法として、デフォルトの外部ブラウザ方法が新たに文書化されました。これはAndroid（Intent.ACTION_VIEW）とiOS（UIApplication.open）の両方で機能し、AgeKeysを完全にサポートし、redirectUrlコールバックを通じてアプリにフォーカスを戻します。

デバイスの向きに関するガイダンス​

年齢確認はポートレート（縦向き）で最も効果的に機能します。アプリ内ブラウザサーフェスはアプリの向きのロックを継承するため、横向きにロックされたアプリでは、確認URLをデフォルトの外部ブラウザで開いてください。ブラウザは独自の向きを管理するため、ユーザーはポートレートに回転でき、フロー完了時にはredirectUrlコールバックがアプリに戻します。

更新されたドキュメント​

  • モバイルアプリ: 年齢確認を中心に再構成し、デフォルトブラウザとデバイスの向きのセクションを新設
  • CDK 埋め込みフロー: エンドツーエンドウィジェットと年齢ゲートウィジェットがモバイルでは推奨されない旨の注記を追加
  • CDK 概要: 統合アプローチの比較にモバイルガイダンスを追加
  • CDK カスタムワークフロー: カスタムワークフローがモバイルアプリに推奨されるアプローチである旨を記載
  • 検証可能な保護者の同意（VPC）: このウィジェットベースのガイドがWeb専用である旨の注記を追加

次のステップ​

  • モバイルで統合する場合は、カスタムワークフローとCDK UXガイドラインを使用して、年齢ゲートと同意のUXをネイティブに構築してください
  • モバイルでは年齢確認URLのみを埋め込み、横向きロックされたアプリにはデフォルトブラウザ方法を使用してください

Redirect URL for Automatic age assurance flows

/age-gate/check now accepts a redirect URL that k-ID navigates to once an Automatic age assurance challenge completes. This is intended for top-level browser handoffs (such as a mobile webview that bounces out to k-ID and back) where an iframe-based result handler isn't an option.

What's new​

  • options.playerAgeAssurance.redirectUrl. Pass an http(s) URL or a custom-scheme mobile deeplink (for example myapp://age-gate/return) on /age-gate/check. After the player completes or dismisses the CHALLENGE_AGE_GATE_AGE_ASSURANCE flow, k-ID redirects to that URL with challengeId, productId, sessionId (on PASS), and status (PASS or FAIL) appended as query parameters. Existing query parameters on the URL are preserved.
  • Scope. The option is only honored for CHALLENGE_AGE_GATE_AGE_ASSURANCE. CHALLENGE_PARENTAL_CONSENT is unaffected and continues to return through the trusted-adult flow.
  • Confirm outcomes server-side. The redirect query parameters are a UX hint. Treat the Challenge.StateChange webhook or /challenge/get-status as the source of truth before granting access.

Documentation​

AIコーディングエージェント向け公式 k-ID Agent Skills バンドル

k-IDは、Agent Skillsの公式バンドルを公開しました — k-IDがサポートするすべての法域要件（米国のCOPPA、EUのGDPR-Kids、英国AADC、英国オンライン安全法、ブラジルECA Digital、オーストラリアのオンライン安全法 / ソーシャルメディア最低年齢など）に対して、AIコーディングエージェントにk-IDを正しく統合する方法を教える、小さく組み合わせ可能な命令パックです。Claude Code、Cursor、OpenAI Codex、GitHub Copilot、Gemini CLIをはじめ、35以上のAIコーディングツールで動作します。

新機能​

  • 8つの焦点を絞ったスキルがk-ID統合の全領域をカバーします：年齢ゲート、親の同意、年齢確認および年齢保証（高リスク権限向けのverifiedAgeThresholdフローを含む）、セッションと権限、webhook、さらにサーバ信頼境界とモバイル／ネイティブの横断的補助スキル。
  • 設計上、法域横断的。同じスキルでCOPPA、GDPR-Kids、英国AADC、英国OSA、ブラジルECA Digital、オーストラリアのオンライン安全法への統合を実現します — 法域ごとの挙動はクライアントコードで分岐させるのではなく、Compliance Studioでサーバ側から構成されます。
  • ワンコマンドインストール：Claude Codeではプラグインマーケットプレイスから、その他の互換ツールではワンラインのgit cloneで導入できます。
  • オープンな標準 — スキルはAgent Skills仕様に準拠し、特定のベンダーに依存せず任意の互換エージェントで動作します。
  • ドキュメント優先の契約 — スキルは統合パターンと既知の落とし穴をエンコードし、APIの形式についてはこのドキュメントサイトにリンクするため、APIと不整合になることがありません。

試す​

詳しく見る​

AIプロダクトクイックスタートガイド

AI特化型プロダクト向けの新しいクイックスタートガイドが追加され、Compliance StudioのリファレンスにAI権限カテゴリも掲載されました。

新機能​

  • AIプロダクトクイックスタート。 AIプロダクトのエンドツーエンド統合手順を説明します：Compliance StudioでのAI権限の設定、保護者の同意の収集、AI機能の制御、権限変更への対応。
  • AI権限カテゴリ。 権限リファレンスにAIカテゴリと7つの権限が掲載されました：ai-chat、ai-media-generation、ai-voice-mode、ai-memory、ai-companion-chatbot、ai-media-upload、ai-model-training。

ドキュメント​

レート制限のドキュメント

k-ID APIおよびユーザー向けの年齢確認・保護者同意フローのデフォルトレート制限を、専用ページに掲載しました。

新機能​

  • APIレート制限。 k-ID APIへの呼び出しはプロダクト単位で制限されます：ライブモードでは500 RPS、テストモードでは10 RPS。制限を超えたリクエストはHTTP 429 Too Many Requestsを返します。
  • 年齢確認および保護者同意フローのレート制限。 ユーザー向けフローはプロダクト単位で制限されます：ライブモードでは100 RPS、テストモードでは20 RPS。制限に達すると、ユーザーには「しばらく待ってから再試行してください」というインフロー上のエラーが表示されます（429はサーバーには通知されません）。
  • 引き上げのリクエスト。 これらはデフォルトです。プロダクトでより高い容量が必要な場合は、k-IDの担当者にご連絡ください。
  • ローンチ前チェックリストを更新。 ライブモードの上限値はテストモードと比べて大幅に高くなるため、CDKおよびAgeKit+のローンチ前チェックリストの両方で、レート制限を明示的に取り上げ、新しいページへリンクするようにしました。

ドキュメント​

Mock Providers切り替え、確認方法の並び順、COPPA 2026ガイド

本日のリリースでは、Compliance Studioに2つの新機能と、COPPA 2026規則改正に向けた開発者向けガイドを追加しました。

新機能​

  • Mock Providers / Real Providers 切り替え。 テストモードで実行中の確認フローに、Mock Providers（デフォルト）と Real Providers を切り替えるスイッチを備えた TEST MODE ツールバーが表示されるようになりました。Mock Providers は内蔵シミュレータを提示し、ペルソナの送信（Adult、Teen、Child、または Passes / Fails Age Check）、カスタム年齢レンジや生年月日の入力、Inconclusive / Fraudulent 失敗のシミュレートが可能です。送信は実プロバイダと同じサーバーパスを流れるため、Webhook、セッション、DOMイベントはまったく同じように動作します。
  • 確認方法の並び順。 Assurance and Verification タブの各有効な方式にドラッグハンドルが付きました。方式をドラッグしてFamily Connectウィジェットでユーザーに表示される順序を変更できます。Reset to default order で k-ID 既定の並び順に戻したり、Market Specific Rules で市場ごとに異なる並び順を適用したりできます。
  • Compliance Guidesセクションを新設。 コンプライアンス・プレイブック用の新しいトップレベルセクションを公開しました。最初のエントリは 2026年COPPA規則改正 です。このガイドでは、COPPAの適用を受ける事業者向けに、2026年4月22日 の施行日までに必要となる設定更新を解説します。

ドキュメント​

確認方法をフォールバックとして設定できるように

プロダクトの各確認方法を、有効・無効に加えてフォールバックのみとして設定できるようになりました。

新機能​

  • フォールバックのみ: この設定の確認方法は、ユーザーが別の確認方法を試したあと、その試行が年齢シグナルを返さなかった場合（年齢判定が確定しなかった場合）にのみ提示されます。最初の一覧には出ません。
  • 用途: より軽い手段で結果が得られなかった場合だけ、より強い手段や代替手段を用意しつつ、最初からすべての選択肢を並べない構成にできます。

ドキュメント​

  • 成人確認: 確認方法ごとの有効・無効および フォールバックのみ の設定
  • 確認方法: 確認の概要と フォールバックのみ の注記

年齢確認APIレスポンスの短いURLフィールド

年齢確認を作成するエンドポイント（POST /age-verification/perform-access-age-verification やその他の perform-* 年齢確認ルートなど）のレスポンスに、id および url に加えて shortUrl が含まれるようになりました。

新機能​

  • 短いリンク: shortUrl は、完全な url と同じ確認体験へリダイレクトする短いリンクです。クエリ文字列が長いと扱いにくい場合（QRコードや、ユーザーが別端末で確認を完了する場合など）に使えます。
  • 完全なURLは従来どおり: セッションの JWT は引き続き完全な url の token クエリパラメータにあります。その URL を独自に短縮したり再構築したりしないでください。
  • 不透明な値: shortUrl は不透明な文字列として扱い、返却されたとおりに表示・エンコードしてください。パスやクエリの形式は将来変わる可能性があるため、固定形式に依存しないでください。

詳しく見る​

プラットフォーム年齢シグナルのドキュメント

Apple iOS、Google Play、Xbox、Meta Horizon、k-ID の年齢データが k-ID にどう取り込まれるか、年齢ゲートを表示しなくてよいケース、および 検証済み と 未検証 のシグナルが高リスク権限や年齢保証とどう関わるかを説明する、プラットフォーム年齢シグナル のエンドツーエンドドキュメントを公開しました。

新機能​

CDK — プラットフォーム年齢シグナル​

  • プラットフォーム年齢シグナル — クイックな統合パス、API マップ、推奨リクエスト順、POST /age-gate/check でのプラットフォームシグナルの扱い、対応プラットフォームと 検証済みの declarationType、検証済みと未検証のシグナルの動作。
  • プラットフォームシグナルの詳細 — プラットフォームごとのフィールド形、各ネイティブシグナルの取得方法、エンドポイント別の説明（get-requirements、check、get-default-permissions、session/get、get-platform-age-range、session/upgrade）、バリデーション、年齢の衝突、k-id シグナルのルール。

コンセプトと関連ドキュメント​

  • 年齢シグナル — プラットフォーム年齢シグナルが他のシグナル種別とどう並ぶか、PlatformAgeSignal の統合詳細への参照先。
  • 高リスク機能用の年齢保証 および 権限 — verifiedAgeThreshold と年齢ゲートでの検証済みプラットフォームシグナルに関する相互リンクの挙動。

API リファレンス（OpenAPI）​

セッションアップグレード、AgeVerification、platformAgeSignal の説明を、上記ドキュメントと揃えて 検証済みプラットフォームシグナル の表現に統一しました。

ドキュメント​

ブラウザとデバイスの互換性

年齢確認フローでサポートされているブラウザとデバイスを簡単に確認できるよう、新しい ブラウザとデバイスの互換性 ページをドキュメントに追加しました。

新機能​

ブラウザとデバイスの互換性​

新しいページでは、デスクトップとモバイルの最小ブラウザバージョン、および埋め込みブラウザ（iOS の ASWebAuthenticationSession、Android の Chrome Custom Tabs）の要件を掲載しています。これにより、各認証プロバイダー全体の互換性要件を 1 つのリファレンスにまとめています。

新規ドキュメント​