FAQとトラブルシューティング

適応型コンテンツに関するよくある質問とトラブルシューティング手順

アダプティブコンテンツには、どの認証方法を使えばよいですか？

アクセスをどのように制御したいかによります：

• 1つのサイトに公開コンテンツと非公開コンテンツを置く場合は、 署名付きCookie
• 認証なしのシンプルなパーソナライズには、 URLパラメータ
• 完全に非公開のサイトには、 認証済みアクセス統合
• すでにフィーチャーフラグを使っている場合は、 フィーチャーフラグプロバイダー

一部に認証済みコンテンツを含む、部分的に公開されたサイトを公開できますか？

はい。サイト全体へのログインを必須にせず、認証が必要なセクションを一部含む公開サイトにできます：

1. サイトの公開範囲は Public、Unlisted、または Share link のままにします。
2. サイト設定でアダプティブコンテンツを有効にします。
3. 使用 署名付きCookie メインアプリケーションにログインした後に、訪問者のクレームを渡すために。
4. 認証済み訪問者にのみ表示する特定のページまたはセクションに条件を設定します。

カスタムOIDCプロバイダーでアダプティブコンテンツを設定するにはどうすればよいですか？

アダプティブコンテンツは、どのIDプロバイダーでも動作します：

1. GitBookで汎用OIDC統合を設定します。
2. OIDCプロバイダーを設定して、トークンにカスタムクレームを含めます。
3. それらのクレームをGitBookの訪問者スキーマにマッピングします。

よくある問題：プロバイダーがトークンにカスタムクレームを含めていること（標準のOIDCクレームだけではない）、クレームがプロバイダー固有のプロパティの下にネストされていないか確認すること、トークン形式を確認すること。プロバイダーによってカスタムクレームの構造は異なるため、プロバイダーのドキュメントを確認してください。

セグメントが機能しない、またはプレビューに表示されないのはなぜですか？

• 訪問者スキーマが正しく定義されていることを確認してください。
• セグメントJSONがスキーマ構造と一致していることを確認してください。
• 条件が、テストしているセクション、ページ、またはブロックに適用されていることを確認してください。
• 正しいページからプレビュー機能を使用し、スキーマ変更後はプレビューを更新してください。

以下を参照 セグメントを使ったテスト 完全なテスト手順について。

制限付きコンテンツは検索結果に表示されますか？

いいえ。検索結果には、訪問者がアクセスできるコンテンツのみが反映されます。アダプティブコンテンツの背後にあるセクション、ページ、またはブロックは、それを表示する条件を満たす訪問者に対してのみインデックスされ、検索で表示されます。

JWTクレームスキーマは自由記述の文字列をサポートしていますか？

まだです。クレームスキーマは現在、文字列値については列挙型のみをサポートしているため、必要なすべての文字列値を列挙型内で定義してください。

アダプティブコンテンツはJWTクレーム内の配列で動作しますか？

いいえ。クレームは1つの値、つまり文字列（列挙型）またはブール値を提供します。複数の値が必要な場合は、クレーム提供側（たとえば Azure や Okta）で変換してください。

アダプティブコンテンツの条件をデバッグするにはどうすればよいですか？

• プロパティ名は大文字と小文字を区別します（role ≠ Role).
• データ型を確認してください — boolean true は文字列ではありません "true".
• ネストされた条件でプロパティパスを確認してください。
• トークンに付随するクレームを jwt.io で確認し、期待どおりのクレームが渡されていることを確認してください。