AEM as a Cloud Service: errore per la risoluzione 403 di ambiti richiesti mancanti con API di query persistenti e server-to-server OAuth
Scopri come risolvere l’errore 403 Forbidden missing required scopes durante l’accesso all’API per query persistenti di AEM 1} utilizzando le credenziali server-to-server di OAuth.
Descrizione description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS) (tutte le versioni)
Sintomi
- Quando si tenta di accedere a endpoint API per query persistenti (ad esempio
https:// .adobeaemcloud.com/graphql/execute.json/ /) utilizzando le credenziali server-to-server OAuth, si verifica il seguente errore 403, messaggio: ‘Autorizzazione di AEM non riuscita - controllare le autorizzazioni AEM group/ACL dell’account tecnico in questo percorso: {“type”:“https://api.adobeaemcloud.com/adobe/meta/errors/forbidden”,“title”:“Forbidden”,“status”:403,“detail”:“Nel token di accesso mancano gli ambiti richiesti.”}’ - L’accesso ai dati dei frammenti di contenuto tramite API funziona come previsto con le stesse credenziali.
- All’account tecnico (credenziali API) sono state concesse le autorizzazioni necessarie in AEM.
- Il problema è specifico per richieste API per query persistenti, non per l’accesso API generale.
Causa
Questo errore si verifica perché il token di accesso generato tramite le credenziali server-to-server OAuth non include l’ambito richiesto per accedere all’API di query persistente. Ciò può essere dovuto a limitazioni negli ambiti disponibili per l’account tecnico o al modo in cui l’API viene registrata in Adobe Developer Console.
Risoluzione resolution
Per risolvere il problema, segui i passaggi seguenti:
-
Verifica l’endpoint API e l’utilizzo del token di accesso:
-
Assicurati di accedere all’endpoint Persisted Query API corretto (ad esempio
https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>). -
Verifica che il token di accesso sia generato per l’account tecnico e l’ambiente corretti.
-
-
Verifica le autorizzazioni dell’account tecnico in AEM:
-
Verifica che l’utente dell’account tecnico sia aggiunto ai gruppi AEM appropriati con le autorizzazioni per accedere ai percorsi richiesti.
-
Assicurarsi che il file
api.yamlcon l’ID client corretto sia distribuito nell’ambiente.
-
-
Verifica e aggiorna la configurazione dell’ambito in Adobe Developer Console:
-
In Adobe Developer Console, apri il progetto e l’integrazione API.
-
Verificare che tutti gli ambiti richiesti per l’API per query persistenti siano selezionati. Se disponibile, assicurati che siano inclusi gli ambiti relativi alle query persistenti.
-
Se mancano ambiti richiesti, modifica l’integrazione per aggiungerli, salva le modifiche e scarica nuovamente le credenziali del servizio aggiornate (file JSON), se applicabile.
-
Rigenera il token di accesso utilizzando le credenziali aggiornate e assicurati che la richiesta del token includa tutti gli ambiti richiesti.
-
Riprova la chiamata API utilizzando il nuovo token di accesso.
-
-
Se gli ambiti richiesti per le query persistenti non sono disponibili in Adobe Developer Console:
-
Utilizza le credenziali JWT generate da AEM Developer Console (non da Adobe Developer Console) per le API server-to-server. Queste credenziali non sono obsolete e possono essere utilizzate per questo caso d’uso.
-
Segui la documentazione di AEM per generare e utilizzare le credenziali JWT per l’accesso API.
-
-
Suggerimenti per la risoluzione dei problemi:
-
Controlla nuovamente gli ambiti selezionati in Developer Console e assicurati che l’integrazione sia collegata correttamente in Admin Console.
-
Se l’errore persiste, controlla la chiamata API, la risposta e i passaggi di configurazione.
-
-
Se il problema non è risolto, consulta la documentazione ufficiale o contatta il supporto Adobe con i dettagli della chiamata API, della risposta e dei passaggi di configurazione eseguiti.