1. Experience Edge for XM API

Edgeトークンを生成する

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

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

Experience Edgeに公開されたコンテンツをクエリするには、Edgeトークンを生成し、Delivery APIへのすべての呼び出しに含めます。もしアプリがJSS 21.6+を使っているなら、Edgeトークンの代わりにContext IDを使うこともできます。

注記

Delivery APIは、承認済みで公開されたコンテンツへのアクセスを提供するGraphQL APIであり、パフォーマンスと高い可用性に最適化されています。このAPIは本番環境に関連するすべてのアクションに使ってください。配信APIプレイグラウンドを設定して、公開コンテンツをテストできます。参考までに、Delivery APIのクエリ例を利用できます。

以下のいずれかの方法でEdgeトークンを生成できます。

Deployアプリを使ってEdgeトークンを生成します

もしDeployアプリにアクセスできるなら、Detailsタブの「環境からEdgeトークン」を生成できます。

Deployアプリを使ってEdgeトークンを生成するには:

  1. DeployアプリのナビゲーションペインでProjectsをクリックします。

  2. Projectsページで、Edgeトークンを生成したい環境を含むプロジェクトをクリックしてください。

  3. プロジェクトページで、希望する環境をクリックしてください。

  4. 環境ページで、Detailsタブをクリックしてください> Generate Delivery API token

Deploy REST APIを使ってEdgeトークンを生成します

Deployアプリにアクセスできる場合は、CMインスタンスのアクセストークンを生成し、その後Deploy APIを呼び出すことでトークンを生成できます。

Deploy REST APIを使ってEdgeトークンを生成するには:

  1. 組織自動化クライアント、または 環境用の自動化クライアントを作成しましょう。

  2. クライアントIDとクライアントシークレットを使ってJWTをリクエストしてください。 access_token価値はアクセストークンです。

  3. Deployアプリで、Edge APIトークンを作成したい環境 の詳細タブ でIDを取得します。

  4. 以下のcurlコマンドを実行します:

    curl --location "https://xmclouddeploy-api.sitecorecloud.io/api/environments/v1/<your_environment_id>/obtain-edge-token" --header "Accept: text/plain" --header "Authorization: Bearer <your_access_token>"
    XM Cloudは現在SitecoreAIとなっています

    一部のコード例、画像、UIラベルは、エンジニアリング資産の更新中もXM Cloudを使用している場合があります。

    apiKeyはあなたのトークンです。

Token APIを使ってEdgeトークンを生成する

Deployアプリにアクセスできる場合は、まずトークンAPIのアクセストークンを作成し、その後トークンAPI呼び出すことで、Edgeトークンを生成することもできます。

Token APIを使ってEdgeトークンを生成する方法:

  1. SitecoreAI環境のためにEdge管理クライアントを作成しましょう。

  2. クライアントIDとクライアントシークレットを使ってExperience EdgeのJWTをリクエストしてください。 access_token価値はアクセストークンです。

  3. アクセストークンを認証に使い、Token APIのCreateエンドポイントを使ってEdgeトークンを生成します。

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