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

請依照下列步驟解決問題:

  1. 驗證API端點及存取權杖使用情形:

    • 確定您正在存取正確的 持續查詢API 端點(例如https://<author-instance>.adobeaemcloud.com/graphql/execute.json/<project>/<query>)。

    • 確認已針對正確的技術帳戶和環境產生存取Token。

  2. 檢查AEM中的技術帳戶許可權:

    • 確認已將技術帳戶使用者新增至適當的AEM群組,且這些群組具有存取所需路徑的許可權。

    • 確定已將具有正確使用者端識別碼的api.yaml檔案部署到環境。

  3. 在Adobe Developer Console中檢閱及更新範圍設定:

    • 在Adobe Developer Console中,開啟您的專案與API整合。

    • 檢查是否已選取 持續查詢API 的所有必要範圍。 如果可用,請確保包含與持久查詢相關的範圍。

    • 如果缺少任何必要的範圍,請編輯整合以新增它們、儲存變更,並重新下載更新的服務認證(JSON檔案) (如果適用)。

    • 使用更新的認證重新產生存取權杖,並確保權杖請求包含所有必要的範圍。

    • 使用新的存取權杖重試API呼叫。

  4. 如果Adobe Developer Console中沒有持續查詢的必要範圍:

    • 針對伺服器對伺服器API,使用從AEM Developer Console (而非Adobe Developer Console)產生的JWT認證。 這些認證不會遭到淘汰,並可用於此使用案例。

    • 請依照AEM檔案指示,產生並使用JWT憑證來存取API。

  5. 疑難排解提示:

    • 在Developer Console中仔細檢查選取的範圍,並確認在Admin Console中正確連結整合。

    • 如果錯誤持續發生,請檢閱API呼叫、回應和設定步驟。

  6. 如果問題尚未解決,請參閱官方檔案或聯絡Adobe支援,瞭解您的API呼叫、回應和已採取之設定步驟的詳細資訊。

相關閱讀

recommendation-more-help
experience-cloud-kcs-help-kbarticles