--- title: "コンテキストID環境変数" slug: "context-id-environment-variables" abstract: "コンテキストIDは特定の環境と統合するために使われます。各コンテキストIDは関連環境のさまざまなリソースをマッピングし、その環境の詳細タブと開発者設定タブで見つけることができます。" --- # コンテキストID環境変数 Context ID環境変数は、[SitecoreAI](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecoreai.html)ソリューションの設定や設定を簡単にします。これは、コンテンツ、サイト、ファイル、フォーム、統合設定など、すべての設定済みリソースにマッピングする統一識別子です。 [開発環境](https://doc.sitecore.com/sai/ja/developers/sitecoreai/getting-started-with-sitecoreai/set-up-your-local-development-environment.html "Set up your local development environment")にContext IDを含めると、残りはSitecoreAIが処理します。Context IDはまた、SitecoreAIソリューションに追加される将来のシステム構成も管理し、新機能や統合をサポートするための追加設定を節約できます。 環境を作成すると、2つのコンテキストIDが自動的に作成されます: - Live Context ID - [Delivery API](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/delivery-graphql-api.html "Delivery API")を用いて[Experience Edge](https://doc.sitecore.com/xp/en/developers/hd/22/sitecore-headless-development/sitecore-experience-edge-for-xm.html)に公開されたコンテンツへのアクセスを提供します。このコンテキストIDは本番サイトで使用してください。 - プレビューコンテキストID - プレビュー APIを使って、SitecoreAI環境内の下書きや未承認コンテンツを含むすべてのコンテンツへのアクセスを提供します。 アプリケーション設定を簡素化するため、JSSおよびContent SDKアプリにはコンテキストリソースのサポートが含まれています: - コンテキストIDのJSSサポートは [JSSアドオン](https://doc.sitecore.com/sai/en/developers/jss/22/jss-sai/the-jss-xm-cloud-add-on-for-next-js.html) から提供されており、バージョン21.6以降のアプリが必要です。必要に応じて [アップグレードガイド](https://doc.sitecore.com/sai/en/developers/jss/217/jss-sai/upgrade-jss-21-5-next-js-apps-to-version-21-6.html) を使ってアプリを更新してください。 - すべてのコンテンツSDKアプリは、箱からContext IDを完全にサポートしています。 > !注SitecoreAIが生成するコンテキストIDは秘密扱いされるべきです。クライアント側のリクエストについては、そのリクエストにのみスコープを持つ [公開スコープ付きのコンテキストIDを作成します](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/manage-context-ids.html) 。 ## コンテキストIDの取得方法 Deployアプリ内の以下の場所からライブコンテキスト識別子とプレビューコンテキスト識別子の両方をコピーできます: - 環境 **の詳細タブで** 、**コンテキストID(プレビュー)** と **コンテキストID(ライブ)** という見出しの下にあります。 ![Context ID environment variables in the Details tab for an environment.](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/ContextIDDeploy.png) - [開発者設定](https://doc.sitecore.com/sai/ja/developers/sitecoreai/deploying-sitecoreai/deploy-app/manage-an-environment/access-the-environment-variables-for-a-site.html "Access the environment variables for a site")タブ。コンテキスト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を作成します](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/manage-context-ids.html#create-a-scoped-context-id) 。 コンテンツSDKを使ってクライアントサイドのエッジエンドポイントへのリクエストを行う際、クライアント側のやり取りが正しいコンテキストに関連付けられ、分析追跡に含まれるようにNEXT\_PUBLIC\_SITECORE\_EDGE\_CONTEXT\_ID設定する必要があります。 ## 環境のコンテキストIDを再生成する 環境のコンテキストIDを永久に取り消し、新しいコンテキストIDを生成するには、コンテキストIDを再生成できます。これは、誰かがあなたのコンテキストIDに不正アクセスした場合や [トークンを取り消](https://doc.sitecore.com/sai/ja/developers/sitecoreai/experience-edge/experience-edge-apis/token-rest-api.html#revokebyhash)した後に行うことがあります。 > !重要コンテキストIDを再生成する際、古いコンテキストIDを使用しているすべてのアプリやサービスは新しいものに更新する必要があります。また、環境の再デプロイも必要です。 環境のコンテキストIDを再生成するには: 1. 環境 **の詳細** タブで :mdiAutorenew: Regenerate(mdiAutorenew: **Regenerate**)をクリックしてください。 2. 「 **コンテキストIDを再生** 」ダイアログで、現在のコンテキストIDをコピーして記録を作成します。コンテキストIDを再生成した後、古いコンテキストIDのインスタンスを検索し、新しいものに置き換えることができます。 3. **再生**をクリックします。 ### 次のステップ { .notintoc } コンテキストIDを再生成した後、古いコンテキストIDを使用しているアプリやサービスは、以下の処理を行うまで動作を停止します。 - 取り消されたコンテキストIDを、関連するすべてのアプリやサービス、例えばローカル環境変数ファイルやVercelの設定設定で置き換えてください。 - 影響を受けた環境を再展開してください。