トークンの配信GraphQL API生成

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

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

GraphQL IDE使用時にリクエストを承認するために、Delivery GraphQL APIのAPIトークンを生成する必要があります。このトピックでは、Delivery GraphQL APIトークンを生成するすべての方法について説明します。

フロントエンドアプリでDelivery GraphQL APIへのリクエストを承認する推奨方法は、APIトークンではなくコンテキストIDを使うことです。すべてのオプションについては 「認可およびAPIアクセス 」をご覧ください。

SitecoreAI DeployでAPIトークンを生成する

Delivery GraphQL APIトークンを取得する最も簡単な方法は、環境のDetailsタブにあるSitecoreAI Deployでトークンを生成することです。

SitecoreAIデプロイでデリバリー GraphQL APIトークンを生成するには:

  1. Deployアプリのナビゲーションペインで「 プロジェクト」をクリックします。

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

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

  4. 環境ページで、「 Details Tab >Generate Delivery API トークン」をクリックしてください。

    !ヒント 詳細 タブではプレビュー用APIトークンも生成GraphQL API。

  5. APIトークンの使い方とタイミングを確認しましょう。

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

SitecoreAI Deployの代替として、Deploy REST APIを使ってDelivery GraphQL APIのトークンをプログラム的に生成できます。

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

  1. 組織自動化クライアント、または 環境用の自動化クライアントを作成しましょう。これによりクライアントIDとクライアントシークレットが生成されます。

  2. Deploy REST API用のJSONウェブトークンを作成しaccess_token

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

  4. プレースホルダーの値を環境IDとアクセストークンに置き換え、次のcURLコマンドを実行してください。

    curl -X GET 'https://xmclouddeploy-api.sitecorecloud.io/api/environments/v1/<YOUR_ENVIRONMENT_ID>/obtain-edge-token' \ -H 'Accept: text/plain' \ -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'

    !注XM Cloudは現在SitecoreAIです。エンジニアリング資産が更新されている間、一部のコード例、画像、UIラベルはXM Cloudを使用している場合があります。

    回答では、apiKey値があなたの配達GraphQL APIトークンです。

  5. APIトークンの使い方とタイミングを確認しましょう。

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

SitecoreAIデプロイの代替として、トークンREST APIを使ってデリバリー GraphQL API用のトークンをプログラム的に生成できます。

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

  1. SitecoreAI Deployで環境用のエッジ管理クライアントを作成します。これによりクライアントIDとクライアントシークレットが生成されます。
  2. クライアントIDとクライアントシークレットを使ってJSONウェブトークンを作成します。これによりJWTが生成されます。JSONウェブトークンは24時間で期限切れになります。期限切れ後は新しいものを申請してください。
  3. トークンREST API作成エンドポイントのJWTを使い、Delivery GraphQL APIトークンを生成します。
  4. APIトークンの使い方とタイミングを確認しましょう。
この記事を改善するための提案がある場合は、 お知らせください!