AEM as a Cloud Service : résolution de l’erreur 403 concernant les portées manquantes avec l’API de requête persistante et OAuth de serveur à serveur
Découvrez comment résoudre l’erreur 403 Portées obligatoires manquantes interdites lors de l’accès à l’API de requête persistante d’AEM à l’aide des informations d’identification de serveur à serveur OAuth.
Description description
Environnement
Adobe Experience Manager as a Cloud Service (AEMaaCS) (toutes les versions)
Symptômes
- Lors de la tentative d’accès aux points d’entrée API de requête persistante (tels que
https:// .adobeaemcloud.com/graphql/execute.json/ /) à l’aide des informations d’identification de serveur à serveur OAuth, l’erreur suivante se produit 403, message : « Échec de l’autorisation AEM - vérifiez les autorisations de groupe AEM/ACL du compte technique sur ce chemin : {« type »:« https://api.adobeaemcloud.com/adobe/meta/errors/forbidden »,« title »:« Forbidden »,« status »:403,« detail »:« Il manque des portées requises pour le jeton d’accès.« } » - L’accès aux données de fragment de contenu via l’API fonctionne comme prévu avec les mêmes informations d’identification.
- Le compte technique (informations d’identification d’API) a reçu les autorisations requises dans AEM.
- Le problème est spécifique aux requêtes API de requête persistante, et non à l’accès général à l’API.
Cause
Cette erreur se produit, car le jeton d’accès généré via les informations d’identification de serveur à serveur OAuth n’inclut pas la portée requise pour accéder à l’API de requête persistante . Cela peut être dû à des limitations dans les portées disponibles pour le compte technique ou à la manière dont l’API est enregistrée dans le Adobe Developer Console.
Résolution resolution
Suivez les étapes ci-dessous pour résoudre le problème :
-
Vérifiez le point d’entrée de l’API et l’utilisation du jeton d’accès :
-
Vérifiez que vous accédez au point d’entrée API de requête persistante correct (tel que
https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>). -
Vérifiez que le jeton d’accès est généré pour le compte technique et l’environnement appropriés.
-
-
Vérifiez les autorisations du compte technique dans AEM :
-
Vérifiez que l’utilisateur du compte technique est ajouté aux groupes AEM appropriés avec les autorisations d’accès aux chemins d’accès requis.
-
Assurez-vous que le fichier
api.yamlavec l’identifiant client correct est déployé dans l’environnement.
-
-
Examinez et mettez à jour la configuration de l’étendue dans le Adobe Developer Console :
-
Dans le Adobe Developer Console, ouvrez votre projet et l’intégration d’API .
-
Vérifiez que toutes les portées requises pour l’API de requête persistante sont sélectionnées. Le cas échéant, assurez-vous que les portées liées aux requêtes persistantes sont incluses.
-
Si des portées obligatoires sont manquantes, modifiez l’intégration pour les ajouter, enregistrez les modifications et téléchargez à nouveau les informations d’identification de service mises à jour (fichier JSON), le cas échéant.
-
Régénérez le jeton d’accès à l’aide des informations d’identification mises à jour et assurez-vous que la demande de jeton inclut toutes les portées requises.
-
Réessayez l’appel API à l’aide du nouveau jeton d’accès.
-
-
Si les portées requises pour les requêtes persistantes ne sont pas disponibles dans le Adobe Developer Console :
-
Utilisez les informations d’identification JWT générées à partir du AEM Developer Console (et non du Adobe Developer Console) pour les API serveur à serveur. Ces informations d’identification ne sont pas obsolètes et peuvent être utilisées pour ce cas d’utilisation.
-
Consultez la documentation d’AEM pour générer et utiliser les informations d’identification JWT pour l’accès à l’API.
-
-
Conseils de dépannage :
-
Vérifiez à nouveau les étendues sélectionnées dans le Developer Console et assurez-vous que l’intégration est correctement liée dans Admin Console.
-
Si l’erreur persiste, passez en revue les étapes d’appel API, de réponse et de configuration.
-
-
Si le problème n’est pas résolu, consultez la documentation officielle ou contactez l’assistance Adobe pour obtenir des détails sur l’appel API, la réponse et les étapes de configuration effectuées.