Experience Edge API用のJSONウェブトークンを作成します
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
JSONウェブトークン(JWT)の作成は、管理者REST APIおよびトークンREST APIへのリクエスト を承認 する際に必須であり、プログラム的にデリバリー GraphQL APIトークンを作成することも可能です。Delivery GraphQL APIのトークンAPIを作成する推奨方法は、SitecoreAI Deployで直接生成することです。
!注また、オーサリング&マネジメントAPIやデプロイREST API用のJWTを作成することもできます。
JSONウェブトークンを作成してください
!注始める前に
JSONウェブトークン(JWT)を要求するには、JSONまたはURLエンコード形式のいずれかで以下のHTTPリクエストを行います。
POST https://auth.sitecorecloud.io/oauth/token
リクエスト文には以下の必要な属性を記載する必要があります:
属性
種類
概要
価値
audience
ストリング
JWTが対象とするAPI群。
grant_type
ストリング
JWTを得るために用いられた方法です。
client_credentials
client_id
ストリング
あなたのEdge管理クライアントのクライアントID。
この価値が分からない場合は、まず 環境用のエッジ管理クライアントを作成しましょう。
あなたのクライアントID。
例: or27P5db...
client_secret
ストリング
あなたのEdge管理クライアントのクライアント秘密です。
この価値が分からない場合は、まず 環境用のエッジ管理クライアントを作成しましょう。
あなたのクライアントの秘密です。
例: ctrWEP7Rd3...
::::tabs:::tab{title="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>" }'
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" }
回答では:
- access_token はJSONのウェブトークンです。JWTを使って管理者REST APIやトークンREST APIへの リクエストを承認 したり、 プログラム的に デリバリー GraphQL APIトークンを作成したりできます。
- scope JWTがアクセスを提供するリソースを定義します。リソースは作成した資格の種類によって異なります。
- expires_in JWTの妥当性を秒単位で定義します。JWTは通常24時間で有効期限が切れますのでご注意ください。その時間が経つとトークンは無効となり、新しいトークンを申請する必要があります。
- 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は絶対に使わないでください。