1. 環境管理

コンテキストID環境変数

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

コンテキストID環境変数は、SitecoreAIソリューションの設定と設定を簡素化します。これは、コンテンツ、サイト、ファイル、フォーム、統合設定など、設定済みのすべてのリソースにマッピングされる統一識別子です。 開発環境にコンテキストIDを含めると、残りはSitecoreAIが処理します。コンテキストIDはSitecoreAIソリューションに追加される将来のシステム構成も管理し、新機能や統合をサポートするための追加設定を節約できます。

環境を作成すると、2つのコンテキストIDが自動的に作成されます:

  • Live Context ID- Delivery APIを用いてExperience Edgeに公開されたコンテンツへのアクセスを提供します。このコンテキストIDは本番サイトに使ってください。

  • Preview Context ID- プレビュー APIを用いて、SitecoreAI環境内のドラフトや未承認コンテンツを含むすべてのコンテンツへのアクセスを提供します。

アプリケーション設定を簡素化するため、JSSおよびContent SDKアプリにはコンテキストリソースのサポートが含まれています:

  • JSSのコンテキストIDサポートはJSSアドオン から提供され、バージョン21.6以降のアプリが必要です。 アップグレードガイド を使って必要に応じてアプリを更新してください。

  • すべてのコンテンツSDKアプリは、箱からContext IDを完全にサポートしています。

コンテキストIDの取得方法

Deployアプリ内の以下の場所からライブおよびプレビューのコンテキスト識別子の両方をコピーできます:

  • 環境の見出しのDetailsタブ、Context ID (Preview) とContext ID (Live) 。

    Context ID environment variables in the Details tab for an environment.

  • 開発者設定タブです。コンテキスト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を再生成する

環境のコンテキストIDを永久に取り消し、その代わりに新しいコンテキストIDを生成するには、コンテキストIDを再生成できます。誰かがあなたのContext IDに不正アクセスした場合にこれを行えるかもしれません。

大事な

コンテキストIDを再生成すると、古いコンテキストIDを使用しているすべてのアプリやサービスは新しいものに更新する必要があります。環境の再デプロイも必要です。

環境のコンテキストIDを再生成するには:

  1. 環境の詳細タブでRegenerate button Regenerateをクリックします。

  2. Regenerate Context IDsダイアログで、現在のコンテキストIDをコピーして記録します。コンテキストIDを再生成した後、古いコンテキストIDのインスタンスを検索して新しいものに置き換えることができます。

  3. クリックRegenerate。

今後のステップ

コンテキストIDを再生成した後、古いコンテキストIDを使用しているアプリやサービスは、以下の処理を行うまで動作を停止します。

  • 影響を受けた環境を再展開してください。

  • 取り消されたコンテキストIDを、関連するすべてのアプリやサービス、例えばローカル環境変数ファイルやVercelの設定設定で置き換えてください。

この記事を改善するための提案がある場合は、 お知らせください!