AEM as a Cloud Service: Fehler „Beheben von 403 Fehlern bei erforderlichen Bereichen“ mit der Persistent Query API und OAuth Server-zu-Server

Letzte Aktualisierung: 12. Oktober 2026

Erfahren Sie, wie Sie den Fehler „403 Forbidden Missing Required Scopes“ beim Zugriff auf die AEM-API Persistente Abfrage mithilfe von OAuth-Server-zu-Server-Anmeldedaten beheben können.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS) (alle Versionen)

Symptome

Beim Versuch, mithilfe von OAuth-Server-zu-Server-Anmeldeinformationen auf API-Endpunkte der persistenten Abfrage (z. B. https:// .adobeaemcloud.com/graphql/execute.json/ / ) zuzugreifen, tritt der folgende Fehler auf 403, Meldung: ‘AEM-Autorisierung fehlgeschlagen - Überprüfen Sie die AEM-Gruppen-/ACL-Berechtigungen des technischen Kontos für diesen Pfad: {„type“:“https://api.adobeaemcloud.com/adobe/meta/errors/forbidden",„title“:„Forbidden“,„status“:403,„detail“:„Dem Zugriffstoken fehlen erforderliche Bereiche.“}’
Der Zugriff auf Inhaltsfragmentdaten über die API funktioniert erwartungsgemäß mit denselben Anmeldeinformationen.
Dem technischen Konto (API-Anmeldeinformationen) wurden die erforderlichen Berechtigungen in AEM gewährt.
Das Problem betrifft nur Anfragen mit Persistente Abfrage-) und nicht den allgemeinen API-Zugriff.

Ursache

Dieser Fehler tritt auf, weil das über OAuth Server-zu-Server-Anmeldeinformationen generierte Zugriffstoken nicht den erforderlichen Gültigkeitsbereich für den Zugriff auf die API für persistierte Abfragen enthält. Dies kann auf Einschränkungen in den verfügbaren Bereichen für das technische Konto oder auf die Art und Weise zurückzuführen sein, wie die API in der Adobe Developer Console registriert ist.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

Überprüfen des API-Endpunkts und der Verwendung des Zugriffstokens:
- Stellen Sie sicher, dass Sie auf den richtigen Endpunkt API für persistierte Abfragen zugreifen (z. B. https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>).
- Vergewissern Sie sich, dass das Zugriffstoken für das richtige technische Konto und die richtige Umgebung generiert wird.
Überprüfen Sie die technischen Kontoberechtigungen in AEM:
- Stellen Sie sicher, dass der Benutzer des technischen Kontos den entsprechenden AEM-Gruppen mit Berechtigungen für den Zugriff auf die erforderlichen Pfade hinzugefügt wurde.
- Stellen Sie sicher, dass die api.yaml-Datei mit der richtigen Client-ID in der Umgebung bereitgestellt wird.
Überprüfen und aktualisieren Sie die Bereichskonfiguration in der Adobe Developer Console:
- Öffnen Sie in der Adobe Developer Console Ihr Projekt und die API-Integration.
- Überprüfen Sie, ob alle erforderlichen Bereiche für die API für persistierte Abfragen ausgewählt sind. Stellen Sie sicher, dass Bereiche im Zusammenhang mit persistierten Abfragen enthalten sind, sofern sie verfügbar sind.
- Wenn erforderliche Bereiche fehlen, bearbeiten Sie die Integration, um sie hinzuzufügen, Änderungen zu speichern und die aktualisierten Service-Anmeldeinformationen (JSON-Datei) ggf. erneut herunterzuladen.
- Generieren Sie das Zugriffs-Token mit den aktualisierten Anmeldeinformationen neu und stellen Sie sicher, dass die Token-Anfrage alle erforderlichen Bereiche enthält.
- Wiederholen Sie den API-Aufruf mit dem neuen Zugriffstoken.
Falls die erforderlichen Bereiche für persistierte Abfragen nicht in der Adobe Developer Console verfügbar sind:
- Verwenden Sie JWT-Anmeldeinformationen, die von der AEM Developer Console (nicht der Adobe Developer Console) wurden, für Server-zu-Server-APIs. Diese Anmeldeinformationen werden nicht mehr unterstützt und können für diesen Anwendungsfall verwendet werden.
- Folgen Sie der Dokumentation zu AEM, um JWT-Anmeldeinformationen für den API-Zugriff zu generieren und zu verwenden.
Tipps zur Fehlerbehebung:
- Überprüfen Sie die ausgewählten Bereiche in der Developer Console und stellen Sie sicher, dass die Integration in der Admin Console korrekt verknüpft ist.
- Wenn der Fehler weiterhin auftritt, überprüfen Sie die API-Aufrufe, die Antwort und die Konfigurationsschritte.
Wenn das Problem nicht behoben ist, konsultieren Sie die offizielle Dokumentation oder wenden Sie sich mit Details zu Ihrem API-Aufruf, Ihrer Antwort und den durchgeführten Konfigurationsschritten an den Adobe-Support.