API認證和產品設定檔管理

瞭解如何管理OpenAPI型AEM API的​ 認證和產品設定檔

在本教學課程中,您將瞭解如何新增或移除:

  • 認證:提供AEM API的驗證。
  • 產品設定檔:提供憑證的許可權(或授權)以存取AEM資源。

背景

使用AEM API時,您需要在Adobe Developer Console (或ADC)專案中定義​ 認證 ​和​ 產品設定檔。 在以下熒幕擷圖中,您可以看到AEM Assets作者API的​ 認證 ​和​ 產品設定檔

認證和產品設定檔

認證 ​提供API的驗證機制。 產品設定檔 ​授予​ 許可權(或授權) ​給認證,以存取AEM資源。 API要求可以代表應用程式或使用者。

產品設定檔與一或多個​ 服務 ​相關聯。 在AEM as a Cloud Service中,服務 ​代表具有預先定義之存放庫節點存取控制清單(ACL)的使用者群組,允許精細的許可權管理。

技術帳戶使用者產品設定檔

成功引發API後,會在AEM作者服務中建立代表ADC專案憑證的使用者,以及符合產品設定檔和服務設定的使用者群組。

技術帳戶使用者成員資格

在上述案例中,使用者1323d2...是在AEM Author服務中建立的,並且是使用者群組AEM Assets Collaborator Users - ServiceAEM Assets Collaborator Users - author - Program XXX - Environment XXX的成員。

新增或移除認證

AEM API支援下列型別的驗證認證:

  1. OAuth伺服器對伺服器:專為機器對機器互動所設計。
  2. OAuth網頁應用程式:專為使用者端應用程式中與後端伺服器的使用者導向互動所設計。
  3. OAuth Single Page App:專為使用者端應用程式中沒有後端伺服器的使用者導向互動所設計。

您可以使用不同型別的憑證來支援各種使用案例。

所有認證都會在您的ADC專案中進行管理。

新增認證

若要新增AEM API的認證,請移至ADC專案的​ API ​區段,然後按一下​ 連線其他認證。 然後,按照您特定認證型別的指示操作。

連線其他認證

移除認證

若要移除AEM API認證,請在ADC專案的​ API ​區段中選取它,然後按一下​ 刪除認證

刪除認證

新增或移除產品設定檔

產品設定檔 ​提供認證的​ 許可權(或授權) ​以存取AEM資源。 產品設定檔 ​提供的許可權是以與​ 產品設定檔 ​相關聯的​ 服務 ​為基礎。 大部分​ 服務 ​透過與​ 服務 ​具有相同名稱的AEM執行個體中的使用者群組,提供對AEM資源的​ 讀取 ​許可權。

有時憑證(亦稱為技術帳戶使用者)需要其他許可權,例如AEM資源的​ 建立、更新、刪除 (CUD)。 在這種情況下,您需要新增與提供必要許可權的​ 服務 ​相關聯的新​ 產品設定檔

例如,當AEM Assets Author API引動收到非GET請求的403錯誤時,您可以新增​ AEM Administrators - author - Program XXX - Environment XXX 產品設定檔 ​以解決此問題。

CAUTION
AEM Administrators ​服務提供​_完整_ Experience Manager管理存取權。 或者,您可以更新服務許可權以僅提供必要許可權。
新增產品設定檔

若要為AEM API新增產品設定檔,請在ADC專案的​ API ​區段中按一下​ 編輯產品設定檔,在​ 設定API ​對話方塊中選取所需的產品設定檔,然後儲存變更。

編輯產品設定檔

選取與所需服務相關聯的所需產品設定檔(例如​ AEM Administrators - author - Program XXX - Environment XXX),然後儲存變更。

選取產品設定檔

請注意,AEM管理員 — 作者 — 方案XXX — 環境XXX ​產品設定檔與​ AEM管理員 ​服務和​ AEM Assets API使用者 ​服務皆有關聯。 如果沒有後者,產品設定檔將不會顯示在可用的產品設定檔清單中。

產品設定檔服務

更新資產中繼資料的​ PATCH ​請求現在應該可以正常運作,而不會發生問題。

PATCH要求

移除產品設定檔

若要移除AEM API的產品設定檔,請在ADC專案的​ API ​區段中按一下​ 編輯產品設定檔,在​ 設定API ​對話方塊中取消選取所需的產品設定檔,然後儲存變更。

取消選取產品設定檔

摘要

您已瞭解如何使用Adobe Developer Console (ADC)專案中的​ 憑證和產品設定檔 ​來變更AEM API的驗證機制和許可權。

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69