AEM as a Cloud Service：永続クエリ APIとOAuth サーバー間のサーバーで403の必要なスコープが見つからないエラーを解決する
OAuth サーバー間の資格情報を使用してAEM 永続クエリ APIにアクセスする際に、「403 Forbidden missing required scopes」エラーが発生した場合の解決方法を説明します。
説明 description
環境
Adobe Experience Manager as a Cloud Service（AEMaaCS）（すべてのバージョン）
症状
- OAuth サーバー間の資格情報を使用して永続クエリ API エンドポイント（
https:// .adobeaemcloud.com/graphql/execute.json/ /など）にアクセスしようとすると、次のエラーが発生します。 403、「AEMの認証に失敗しました」というメッセージが表示されます。このパスに対するテクニカルアカウントのAEM group/ACL権限を確認します。{“type”:“https://api.adobeaemcloud.com/adobe/meta/errors/forbidden”,“title”:“Forbidden”,“status”:403,“detail”:“The access token is missing required required required scopes”}“”" - APIを介したコンテンツフラグメントデータへのアクセスは、同じ資格情報で期待どおりに機能します。
- AEMで必要な権限がテクニカルアカウント（API資格情報）に付与されました。
- この問題は、一般的なAPI アクセスではなく、永続クエリ API要求に固有です。
原因
このエラーは、OAuth サーバー間の資格情報を介して生成されたアクセストークンに、永続クエリ APIにアクセスするために必要なスコープが含まれていないことが原因で発生します。 これは、テクニカルアカウントの利用可能なスコープの制限や、APIをAdobe Developer Consoleに登録する方法が原因である可能性があります。
解決策 resolution
問題を解決するには、次の手順に従います。
-
API エンドポイントとアクセストークンの使用状況を確認します。
-
正しい永続クエリ API エンドポイント（
https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>など）にアクセスしていることを確認してください。 -
適切なテクニカルアカウントと環境に対してアクセストークンが生成されていることを確認します。
-
-
AEMのテクニカルアカウント権限を確認します。
-
必要なパスにアクセスする権限を持つ適切なAEM グループに、テクニカルアカウントユーザーが追加されていることを確認します。
-
正しいクライアント IDを持つ
api.yamlファイルが環境にデプロイされていることを確認します。
-
-
Adobe Developer Consoleでスコープ設定を確認して更新します。
-
Adobe Developer Consoleで、プロジェクトとAPI統合を開きます。
-
永続クエリ APIに必要なすべてのスコープが選択されていることを確認します。 使用可能な場合は、永続クエリに関連するスコープが含まれていることを確認します。
-
必要なスコープが見つからない場合は、統合を編集して追加し、変更を保存し、更新されたサービス資格情報（JSON ファイル）を必要に応じて再ダウンロードします。
-
更新された資格情報を使用してアクセストークンを再生成し、トークンリクエストにすべての必要なスコープが含まれていることを確認します。
-
新しいアクセストークンを使用して、API呼び出しを再試行します。
-
-
永続クエリに必要なスコープがAdobe Developer Consoleで使用できない場合：
-
サーバー間APIには、AEM Developer Console （Adobe Developer Consoleではなく） から生成されたJWT資格情報を使用します。 これらの資格情報は非推奨（廃止予定）ではなく、このユースケースに使用できます。
-
AEMのドキュメントに従って、API アクセス用にJWT資格情報を生成して使用します。
-
-
トラブルシューティングのヒント：
-
Developer Consoleで選択したスコープを再確認し、Admin Consoleで統合が正しくリンクされていることを確認します。
-
エラーが解決しない場合は、API呼び出し、応答、設定手順を確認します。
-
-
問題が解決しない場合は、公式ドキュメントを参照するか、Adobe サポートに連絡して、API呼び出し、応答、実行された設定手順の詳細を確認してください。