1. Experience Edge

Experience Edge API用のJSONウェブトークンを作成します

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

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

Experience Edge for XMは、Edgeテナントの管理とコンテンツへのアクセスを支援する以下のAPIを提供します。

  • Delivery API - 公開コンテンツへのアクセスを提供するGraphQL API。

  • トークンAPI - Delivery APIにアクセスする際に使われるAPIキーを管理できるREST API。

  • Admin API - Edgeテナントの設定を可能にするREST API。

注記

また、Authoring・管理APIやDeploy APIのJWTを申請することもできます。

リクエストの承認

Experience Edge APIとやり取りするには、使用したいAPIに応じてリクエストを承認する必要があります。

デリバリーAPI

Delivery APIへのリクエストを承認するには、Edgeトークンを生成し、すべてのAPI呼び出しに含める必要があります。Edgeトークンは以下のいずれかの方法で生成できます:

トークンAPIおよび管理者API

Token APIまたはAdmin APIへのリクエストを承認するには:

JWTをリクエストしてください

始める前に

Experience Edge用のJSONウェブトークン(JWT)をリクエストするには、JSONまたはURLエンコード形式のいずれかで以下のHTTPリクエストを行います。

POST https://auth.sitecorecloud.io/oauth/token

リクエスト文には以下の必要な属性を記載する必要があります:

Attribute

種類

概要

価値

audience

string

JWTが対象としているAPI群。

https://api.sitecorecloud.io

grant_type

string

JWTを得るために用いられた方法です。

client_credentials

client_id

string

あなたのEdge管理クライアントのクライアントIDです。

この価値がわからない場合は、まずEdge管理クライアントを作成しましょう。

あなたのクライアントID。

例: or27P5db...

client_secret

string

あなたのEdge管理クライアントのクライアント秘密。

この価値がわからない場合は、まずEdge管理クライアントを作成しましょう。

あなたのクライアントの秘密です。

例: ctrWEP7Rd3...

JSON

curl -X POST 'https://auth.sitecorecloud.io/oauth/token' \
-H 'Content-Type: application/json' \
--data-raw '{
    "audience": "https://api.sitecorecloud.io",
    "grant_type": "client_credentials",
    "client_id": "<YOUR_CLIENT_ID>",
    "client_secret": "<YOUR_CLIENT_SECRET>"
}'

URLエンコード

curl -X POST 'https://auth.sitecorecloud.io/oauth/token' \
-H 'content-type: application/x-www-form-urlencoded' \
--data-urlencode 'audience=https://api.sitecorecloud.io' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<YOUR_CLIENT_ID>' \
--data-urlencode 'client_secret=<YOUR_CLIENT_SECRET>'

以下はその回答例です:

{
    "access_token": "eyJhbG...",
    "scope": "...",
    "expires_in": 86400,
    "token_type": "Bearer"
}

回答では:

セキュリティ上の考慮事項

Sitecore発行のJWTはRS256で署名されています。JWTを使用する前に、JWTライブラリを使ってSitecoreのJSON Web Key Set(JWKS)URIに対して検証してください:

https://auth.sitecorecloud.io/.well-known/jwks.json

JWKS URIは署名の検証に使われる公開鍵を提供します。JWTライブラリを設定して、期待される発行者(https://auth.sitecorecloud.io/)とオーディエンス(https://api.sitecorecloud.io)を確認し、有効期限チェックが無効化されていないことを確認してください。どのカードが自動的に検証されているか、図書館のドキュメントを確認してください。自分の認証情報申請から直接取得していないJWTは絶対に使わないでください。

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