メインコンテンツに移動

7件の投稿件のタグ「age-verification」を含む

すべてのタグを見る

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

モバイルで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のみを埋め込み、横向きロックされたアプリにはデフォルトブラウザ方法を使用してください

クレジットカード専用の年齢確認エンドポイント

クレジットカードのみを方式として年齢確認を実行するための専用エンドポイント /age-verification/perform-credit-card-verification が追加されました。これは、既存の単一方式エンドポイント（ID、AgeKey、ConnectID）と並ぶものです。

新機能​

  • POST /age-verification/perform-credit-card-verification。 自動的な方式選択をバイパスし、クレジットカードのみでユーザーを確認します。他の単一方式エンドポイントと同じリクエスト形式（jurisdiction、subject、criteria、および任意の options.redirectUrl / options.locale）を受け取り、id、url、shortUrl を返します。
  • 成人（18歳以上）の保証。 クレジットカード確認は、正確な年齢推定ではなく成人であることの保証シグナルです。カードの所有が成人に限定されている法域に最も適しています。
  • ステータスと結果は変更なし。 これまでどおり /age-verification/get-status をポーリングするか、Verification.Result webhook を処理してください。結果は確認 method として credit-card を報告します。

ドキュメント​

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 は不透明な文字列として扱い、返却されたとおりに表示・エンコードしてください。パスやクエリの形式は将来変わる可能性があるため、固定形式に依存しないでください。

詳しく見る​

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

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

新機能​

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

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

新規ドキュメント​

確認URLの有効期間とget-statusのドキュメント

年齢確認のドキュメントを更新し、URLの有効期間、期限切れURLの扱い、ステータス確認について追記しました。

新機能​

  • URLの有効期間: 確認URLは作成から2週間有効です。有効期限はJWTのtokenクエリパラメータに含まれます。標準のexpクレームでURLがまだ有効かどうかを判定できます。
  • 期限切れURL: 保存した確認IDで/age-verification/get-statusを呼び出してください。確認が見つからない場合は新規作成してください。
  • URLなしでのステータス確認: 確認IDでget-statusを呼ぶと、いつでもステータスを確認できます（URL期限切れ後やwebhookを受信できなかった場合など）。
  • 保持期間: 2週間以上PENDINGのままの確認は削除され、get-statusでは返されません。

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