コンテキストID環境変数
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Context ID環境変数は、SitecoreAIソリューションの設定や設定を簡単にします。これは、コンテンツ、サイト、ファイル、フォーム、統合設定など、すべての設定済みリソースにマッピングする統一識別子です。 開発環境にContext IDを含めると、残りはSitecoreAIが処理します。Context IDはまた、SitecoreAIソリューションに追加される将来のシステム構成も管理し、新機能や統合をサポートするための追加設定を節約できます。
環境を作成すると、2つのコンテキストIDが自動的に作成されます:
- Live Context ID - Delivery APIを用いてExperience Edgeに公開されたコンテンツへのアクセスを提供します。このコンテキストIDは本番サイトで使用してください。
- プレビューコンテキストID - プレビュー APIを使って、SitecoreAI環境内の下書きや未承認コンテンツを含むすべてのコンテンツへのアクセスを提供します。
アプリケーション設定を簡素化するため、JSSおよびContent SDKアプリにはコンテキストリソースのサポートが含まれています:
- コンテキストIDのJSSサポートは JSSアドオン から提供されており、バージョン21.6以降のアプリが必要です。必要に応じて アップグレードガイド を使ってアプリを更新してください。
- すべてのコンテンツSDKアプリは、箱からContext IDを完全にサポートしています。
!注SitecoreAIが生成するコンテキストIDは秘密扱いされるべきです。クライアント側のリクエストについては、そのリクエストにのみスコープを持つ 公開スコープ付きのコンテキストIDを作成します 。
コンテキストIDの取得方法
Deployアプリ内の以下の場所からライブコンテキスト識別子とプレビューコンテキスト識別子の両方をコピーできます:
-
環境 の詳細タブで 、コンテキストID(プレビュー) と コンテキストID(ライブ) という見出しの下にあります。
-
開発者設定タブ。コンテキストIDはSITECORE_EDGE_CONTEXT_IDの値です。
-
Content SDKを使っていて、クライアント側のリクエストをEdgeエンドポイントに行いたい場合、SITECORE_EDGE_CONTEXT_IDと同じ値でNEXT_PUBLIC_SITECORE_EDGE_CONTEXT_IDを追加することもできます。
!警告NEXT_PUBLIC_SITECORE_EDGE_CONTEXT_IDを使うと、クライアント側でコンテキストIDが公開されます。クライアント側での使用には、必要なリソースのみを含む スコープ付きコンテキストIDを作成します 。
コンテンツSDKを使ってクライアントサイドのエッジエンドポイントへのリクエストを行う際、クライアント側のやり取りが正しいコンテキストに関連付けられ、分析追跡に含まれるようにNEXT_PUBLIC_SITECORE_EDGE_CONTEXT_ID設定する必要があります。
-
環境のコンテキストIDを再生成する
環境のコンテキストIDを永久に取り消し、新しいコンテキストIDを生成するには、コンテキストIDを再生成できます。これは、誰かがあなたのコンテキストIDに不正アクセスした場合や トークンを取り消した後に行うことがあります。
!重要コンテキストIDを再生成する際、古いコンテキストIDを使用しているすべてのアプリやサービスは新しいものに更新する必要があります。また、環境の再デプロイも必要です。
環境のコンテキストIDを再生成するには:
- 環境 の詳細 タブで Regenerate(mdiAutorenew: Regenerate)をクリックしてください。
- 「 コンテキストIDを再生 」ダイアログで、現在のコンテキストIDをコピーして記録を作成します。コンテキストIDを再生成した後、古いコンテキストIDのインスタンスを検索し、新しいものに置き換えることができます。
- 再生をクリックします。
次のステップ
コンテキストIDを再生成した後、古いコンテキストIDを使用しているアプリやサービスは、以下の処理を行うまで動作を停止します。
- 取り消されたコンテキストIDを、関連するすべてのアプリやサービス、例えばローカル環境変数ファイルやVercelの設定設定で置き換えてください。
- 影響を受けた環境を再展開してください。