AEM as a Cloud Service:解決持續查詢API和OAuth伺服器對伺服器的403缺少必要範圍錯誤
瞭解如何在使用OAuth伺服器對伺服器認證存取AEM 持續查詢API時解決403 Forbidden missing required scope錯誤。
說明 description
環境
Adobe Experience Manager as a Cloud Service (AEMaaCS) (所有版本)
症狀
- 嘗試使用OAuth伺服器對伺服器認證存取 持續查詢API 端點(例如
https:// .adobeaemcloud.com/graphql/execute.json/ /)時,發生下列錯誤 403,訊息: 'AEM授權失敗 — 檢查技術帳戶的AEM群組/ACL許可權,路徑為: {“type”:“https://api.adobeaemcloud.com/adobe/meta/errors/forbidden”,“title”:“Forbidden”,“status”:403,“detail”:“存取權杖缺少必要的範圍。”}" - 透過API存取內容片段資料的工作方式與預期相同,憑證也相同。
- 技術帳戶(API認證)已獲得AEM的必要許可權。
- 此問題專用於 持續查詢API 請求,而不是一般API存取。
原因
發生此錯誤是因為透過OAuth伺服器對伺服器憑證產生的存取權杖不包含存取持續查詢API所需的範圍。 這可能是由於技術帳戶可用範圍的限制或API在Adobe Developer Console中的註冊方式所造成。
解決方法 resolution
請依照下列步驟解決問題:
-
驗證API端點及存取權杖使用情形:
-
確定您正在存取正確的 持續查詢API 端點(例如
https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>)。 -
確認已針對正確的技術帳戶和環境產生存取Token。
-
-
檢查AEM中的技術帳戶許可權:
-
確認已將技術帳戶使用者新增至適當的AEM群組,且這些群組具有存取所需路徑的許可權。
-
確定已將具有正確使用者端識別碼的
api.yaml檔案部署到環境。
-
-
在Adobe Developer Console中檢閱及更新範圍設定:
-
在Adobe Developer Console中,開啟您的專案與API整合。
-
檢查是否已選取 持續查詢API 的所有必要範圍。 如果可用,請確保包含與持久查詢相關的範圍。
-
如果缺少任何必要的範圍,請編輯整合以新增它們、儲存變更,並重新下載更新的服務認證(JSON檔案) (如果適用)。
-
使用更新的認證重新產生存取權杖,並確保權杖請求包含所有必要的範圍。
-
使用新的存取權杖重試API呼叫。
-
-
如果Adobe Developer Console中沒有持續查詢的必要範圍:
-
針對伺服器對伺服器API,使用從AEM Developer Console (而非Adobe Developer Console)產生的JWT認證。 這些認證不會遭到淘汰,並可用於此使用案例。
-
請依照AEM檔案指示,產生並使用JWT憑證來存取API。
-
-
疑難排解提示:
-
在Developer Console中仔細檢查選取的範圍,並確認在Admin Console中正確連結整合。
-
如果錯誤持續發生,請檢閱API呼叫、回應和設定步驟。
-
-
如果問題尚未解決,請參閱官方檔案或聯絡Adobe支援,瞭解您的API呼叫、回應和已採取之設定步驟的詳細資訊。