> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/faq-and-troubleshooting.md).

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

### 適応コンテンツにはどの認証方法を使うべきですか？

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

* 1つのサイトに公開コンテンツと非公開コンテンツがある場合は、 [署名付き cookie](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/enabling-adaptive-content/cookies.md)
* 認証なしのシンプルなパーソナライズには、 [URL パラメータ](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/enabling-adaptive-content/url.md)
* 完全に非公開のサイトには、 [認証済みアクセス連携](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/enabling-adaptive-content/authenticated-access.md)
* すでにフィーチャーフラグを使っている場合は、 [フィーチャーフラグプロバイダー](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/enabling-adaptive-content/feature-flags.md)

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

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

1. サイトの公開設定は「公開」「未掲載」「共有リンク」のいずれかにします。
2. サイトの設定で適応コンテンツを有効にします。
3. 使用する [署名付き cookie](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/enabling-adaptive-content/cookies.md#signed-cookie) メインアプリケーションにログインした後に、訪問者のクレームを渡します。
4. 認証済み訪問者にのみ表示する特定のページやセクションに条件を設定します。

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

適応コンテンツは、任意の ID プロバイダーで動作します：

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

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

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

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

参照 [セグメントを使ったテスト](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/testing-with-segments.md) 完全なテスト手順について。

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

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

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

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

### 適応コンテンツは JWT クレームの配列でも動作しますか？

いいえ。クレームは単一の値、つまり文字列（enum）または boolean を提供します。複数の値が必要な場合は、クレームプロバイダー側（たとえば Azure や Okta）で変換してください。

### 適応コンテンツの条件をデバッグするにはどうすればよいですか？

* プロパティ名は大文字・小文字を区別します（`role` ≠ `Role`).
* データ型を確認してください — boolean `true` は文字列ではありません `「true」`.
* ネストされた条件ではプロパティパスを確認してください。
* トークンに付与されたクレームを以下で確認してください： [jwt.io](https://www.jwt.io/) 期待どおりのクレームが渡されていることを確認します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content/faq-and-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.