年齢確認とVPCフローのウィジェットUIをいつ閉じるかを明確にし、MegaWidgetOptionsスキーマにredirectUrlサポートを追加しました。

新機能​

Widget.ExitReviewの明確化​

年齢確認とVPCフローのUIをいつ閉じるかを判断するシグナルとして、Widget.ExitReviewを使用することを明確にするためにドキュメントを更新しました。

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

• 年齢確認ガイド - 確認UIを閉じるためにWidget.ExitReviewをリッスンするガイダンスを追加
• VPCガイド - VPCウィジェットUIを閉じるためにWidget.ExitReviewをリッスンするガイダンスを追加
• CDK埋め込みフロー - ウィジェットUIを閉じるためにWidget.ExitReviewをリッスンするガイダンスを追加

すべての言語バージョン（英語、日本語、簡体字中国語、韓国語）がこの明確化で更新されました。

APIの更新​

MegaWidgetOptionsでのredirectUrl​

MegaWidgetOptionsスキーマに、年齢確認リクエストスキーマと一貫性のあるredirectUrlサポートが含まれるようになりました。これにより、エンドツーエンドウィジェットを使用する際にリダイレクトURLを指定できます。

更新されたスキーマ:

• MegaWidgetOptionsに#/components/schemas/RedirectUrlへの参照を持つredirectUrlフィールドが含まれるようになりました

この変更は、すべてのOpenAPI仕様ファイル（英語、日本語、簡体字中国語、韓国語）で利用できます。

ドキュメントの改善​

プロダクト画像の仕様​

Compliance Studioのプロダクト画像の推奨アスペクト比と解像度を追加しました:

• ロゴ: 1:1（正方形）、512×512px
• バナー: 3:1（横長）、2430×810px

年齢データが利用可能な場合、Verification.Result WebhookイベントのFAILステータスイベントにageCategoryフィールドが含まれるように更新しました。

新機能​

FAILステータスイベントでのageCategory​

ageCategoryフィールドは、次の条件を満たす場合、Verification.Result WebhookイベントのFAILステータスに含まれるようになりました:

• failureReasonがage-criteria-not-met
• 年齢データが利用可能（age.lowとage.highの両方が存在）

これにより、年齢基準を満たさないために検証が失敗した場合でも、ユーザーの年齢カテゴリに関するより完全な情報が提供され、明確なアクセス制御の境界を維持しながら、より優れた分析とログ記録が可能になります。

ドキュメントの更新​

Verification.Resultドキュメントがこの変更を反映するように更新されました:

• フィールドテーブル: FAILステータスでageCategoryが存在するタイミングを明確にするために説明を更新
• 主な違いテーブル: WebhookイベントとAPIエンドポイントでageCategoryが存在するタイミングを明確化
• FAILステータスのフィールド存在ルール: 特定の条件でageCategoryを「場合によって含まれる」として表示するように更新
• 完全なフィールドマトリックス: WebhookのFAILステータスでageCategoryを「sometimes²」として表示するように更新
• ペイロードの例: 新しい動作を示すためにFAILステータスの例にageCategoryを追加
• 実装チェックリスト: FAILステータスでageCategoryを処理するためのガイダンスを更新
• 実装ノート: PASSとFAILの両方のステータスでのageCategoryの動作を明確化

重要な注意事項​

• アクセス制御: FAILステータスイベントでageCategoryが存在する場合でも、アクセス制御の決定に決して使用しないでください。アクセスを決定するには、常にstatusフィールドを使用してください。
• 一貫性: この更新はWebhookイベントとAPIエンドポイントの応答の両方に適用されます
• 言語サポート: すべての言語バージョン（英語、日本語、簡体字中国語、韓国語）が更新されました

次のステップ​

• 更新されたVerification.Resultドキュメントを確認してください
• 必要に応じて、FAILステータスイベントでageCategoryを処理するように統合を更新してください
• 覚えておいてください: ステータスがFAILの場合、フィールドが存在する場合でも、アクセス制御にageCategoryを使用しないでください。分析、ログ記録、または情報提供の目的でのみ使用してください。

セッションと権限を管理するための包括的なガイドを追加し、重要な説明を追加してコアコンセプトのドキュメントを更新しました。

新機能​

新しいガイド: セッションと権限の管理​

新しいクイックスタートガイドを追加しました: セッションと権限の管理。このガイドでは、次の手順を説明しています:

• Webhookとセッション比較を使用した権限変更の検出
• セッション削除と取り消しの処理
• プレイヤーへの権限変更の通知
• 権限アップグレードフローの実装
• チャレンジがセッションとどのように関連するかの理解

このガイドは、親が設定を変更したり、プレイヤーが年齢アップしたりするなど、時間の経過とともに権限の変更に対応する必要がある統合に不可欠です。

ドキュメントの更新​

セッションドキュメント​

セッションコンセプトページに重要な説明を追加しました:

• セッションIDの永続性: プレイヤーはプロダクトごとに正確に1つのセッションを持ちます。セッションIDは権限変更を通じて永続しますが、セッションが取り消され、同意フローが再度完了した場合は新しいセッションIDが作成されます。
• セッション削除の動作: 削除されたセッションは、エラーコードNOT_FOUNDでHTTP 400を返します（404ではありません）。これは意図的なものです—削除されたセッションは、存在しなかったかのように扱う必要があります。
• 年齢アップの変更: 年齢アップイベントはWebhook通知をトリガーしません。これらの変更を検出するには、セッション比較を使用する必要があります。

権限ドキュメント​

権限コンセプトページを次の内容で強化しました:

• managedByフィールドの変更: managedByは時間の経過とともに変更される可能性があることを明確にしました（たとえば、プレイヤーが年齢アップしたときにGUARDIANからPLAYERに）。
• プレイヤー管理の権限: プレイヤーが/session/upgrade APIを介してPLAYER管理の権限を有効にすることをリクエストすると、Challengeを作成せずに自動的に有効になります。
• 権限アップグレードのコンテンツ: 権限アップグレードのドキュメントを、より見つけやすくするために権限ページに統合しました。

変更内容​

ドキュメントの統合​

• 権限アップグレードコンセプトページを権限ページに統合しました。すべての参照を新しい場所に更新しました。

次のステップ​

• 新しいセッションと権限の管理ガイドを確認してください
• 統合がセッション削除を正しく処理していることを確認してください（NOT_FOUNDでHTTP 400）

これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。

Compliance Studioにプロダクトレベルのアクセス制御を備えた新しいDeveloperロールを導入し、組織が異なるプロダクトとチーム間の明確な境界を維持できるようにしました。

新機能​

Developerロール​

Compliance Studioで新しいDeveloperロールが利用可能になりました。Developerロールを持つユーザーは、プロダクトとプロダクト開発者設定を管理できますが、明示的に割り当てられたプロダクトのみです。

主な機能:​

• プロダクトレベルのアクセス制御: Developerは、組織内の特定のプロダクトにのみアクセスを制限できます
• きめ細かい権限: 各Developerロールメンバーをそれぞれのプロダクトに割り当てることができ、プロダクトレベルのアクセス制御を可能にし、組織の境界を維持します
• プロダクト管理: Developerは、割り当てられたプロダクトのプロダクトとプロダクト開発者設定のみを管理できます

メンバーアクセス管理​

組織設定に新しいMember Accessメニューが追加され、OwnerとAdminがDeveloperロールを持つメンバーにプロダクトアクセスを割り当てることができるようになりました。

仕組み:​

• アクセス割り当て: OwnerとAdminは、Member Accessメニューを使用して、Developerロールメンバーに特定のプロダクトを割り当てることができます
• 複数プロダクトの割り当て: 1人のDeveloperに複数のプロダクトを割り当てることができます
• 即座に有効: プロダクトアクセスの割り当ては即座に有効になります

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

• 組織の管理

年齢確認ガイドに包括的なエッジケース処理の例を追加し、フィールド存在ルールを明確にするために検証イベント契約を更新しました。

新機能​

エッジケース処理の例​

ウォーターフォールフローガイドに、検証エッジケースを処理するための詳細なコード例が追加されました。各例は、誤った処理パターンと正しい処理パターンの両方を示しています。

新しい例には以下が含まれます：​

• 部分的な試行（最大試行回数超過）: ユーザーが確定的な年齢決定なしにすべての確認試行を使い果たした場合のmax-attempts-exceeded失敗理由の適切な処理
• 不審な活動の検出: 適切なレート制限とセキュリティ対策を含む、fraudulent-activity-detected失敗理由のセキュリティ重視の処理
• 完全なエッジケースハンドラ: すべてのパターンを一緒に示す包括的なTypeScriptの例

すべての例は、完全なフィールド存在ルールについて検証イベント契約に直接リンクしています。

検証イベント契約の更新​

検証イベント契約が更新され、フィールド存在ルールが明確になりました：

• ageとageCategoryはPASSステータスの場合常に存在: PASSをもたらすすべての確認方法は、年齢情報と年齢カテゴリの両方を提供します。PASSステータスの結果を処理する際は、条件チェックなしでこれらのフィールドに安全にアクセスできます。
• 年齢範囲の明確化: 確認方法によって正確な年齢が提供されない場合、age.lowは確認に必要な閾値の最小年齢となり、age.highは100となります。

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

• ウォーターフォールフロー - エッジケース処理
• 検証イベント契約

k-IDウィジェットをモバイルアプリケーションに統合するのに役立つ包括的なモバイルアプリ統合ドキュメントを追加し、ConnectIDテストリソースを強化しました。

新機能​

モバイルアプリ統合ガイド​

新しいモバイルアプリクイックスタートガイドは、k-IDウィジェットをモバイルアプリケーションに統合するための包括的なドキュメントを提供します。このガイドでは以下をカバーしています：

• プラットフォーム固有の実装方法: Android（Custom Tabs、WebView、Trusted Web Activity）とiOS（ASWebAuthenticationSession、SFSafariViewController、WKWebView）の詳細なガイダンス
• AgeKeysサポート: どの実装方法がAgeKeysとWebAuthnをサポートしているかについての明確なドキュメント
• 結果の通信: ウィジェット結果を受信する2つのアプローチ—コールバックURL（推奨）とDOMメッセージ
• サードパーティアプリの確認フロー: ConnectIDなどの確認方法がサードパーティアプリを介してリダイレクトする方法の完全なドキュメント
• 完全なコード例: iOS（Swift）とAndroid（Kotlin）の両方のステップバイステップの実装例と完全なコードサンプル

ConnectIDテストの強化​

モバイルアプリテストリソースを使用したConnectIDテストドキュメントの強化：

• モバイルアプリテストアプリ: モバイルアプリケーションで完全なリダイレクトフローを検証するために、iOS（TestFlight）とAndroid（Google Play）のConnectID Mock Bank Cテストアプリへのリンクを追加
• テストセクションの更新: モバイルアプリリダイレクトフローテスト専用のサブセクションでConnectIDテストセクションを拡張

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

• モバイルアプリガイド
• ConnectIDテスト

新しいチェンジログセクションの導入をお知らせします！これは、開発者向けインターフェース、APIの動作、統合パターンの変更についてお知らせする一元化された場所として機能します。

新機能​

チェンジログセクション​

本日より、開発者向けの変更に関する更新を1つの便利な場所で確認できます。定期的に更新を投稿し、以下についてお知らせします：

• APIの更新と変更: 新しいエンドポイント、パラメータの変更、非推奨事項
• イベントシステムの更新: DOMイベントとWebhookの変更
• インターフェースと動作の変更: 開発者向けインターフェースと統合パターンの更新
• 破壊的変更: 統合に影響を与える可能性のある重要な更新

検証イベント契約​

すべての検証結果データのフォーマット方法に関する信頼できるリファレンス資料を開発者に提供するため、検証イベント契約を導入します。この契約はDOMイベントとWebhookの両方に適用され、統合のための安定したリファレンスとして維持することをお約束します。

これが意味すること：​

• 一貫したイベント構造: すべてのイベントタイプで予測可能なイベントペイロード
• 包括的なドキュメント: 統合を容易にする完全なイベントスキーマと例
• 信頼できるリファレンス: 検証結果データのフォーマットに関する安定したリファレンス資料として、この契約を維持することをお約束します

イベント構造と統合での使用方法の詳細については、イベントドキュメントを参照してください。

最新情報を確認​

このチェンジログをブックマークして定期的に確認するか、更新を購読してk-IDプラットフォームの最新の変更について常に情報を得てください。統合に影響を与える可能性のあるすべての更新について、お知らせすることをお約束します。

高レベルのプロダクト発表や機能リリースについては、リリースノートをご覧ください。

更新を購読​

お好みのフィード形式でチェンジログを購読できます：

• RSSフィード: RSSで購読
• Atomフィード: Atomで購読
• JSONフィード: JSONで購読

これらのフィードURLのいずれかをRSSリーダー、ニュースアグリゲーター、または監視ツールに追加すると、新しいチェンジログエントリが公開されたときに自動通知を受け取ることができます。

これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。

---

これはチェンジログの最初のエントリです。開発者向けインターフェースと動作が変更される際は、引き続きここに更新を投稿します。