OAuth伺服器對伺服器驗證

OAuth伺服器對伺服器驗證允許以權杖為基礎的安全存取AEM Forms Communications API,而不需要使用者互動。 Adobe Developer Console支援OAuth伺服器對伺服器驗證。

先決條件

開始之前,請確定符合下列必要條件:

如何使用OAuth伺服器對伺服器驗證產生存取權杖?

請依照下列步驟,從Adobe Developer主控台產生存取權杖,並透過OAuth伺服器對伺服器驗證發出第一個API呼叫。

​1. Adobe Developer Console專案設定

  1. 導覽至Adobe Developer Console

  2. 使用您的Adobe ID登入

  3. 建立新專案或導覽至您現有的專案

若要建立新專案
  1. 在​ 快速入門 ​區段中,按一下​建立新專案

  2. 使用預設名稱建立新專案

    建立ADC專案

  3. 按一下右上角的​編輯專案

    編輯專案

  4. 提供有意義的名稱(例如「formsproject」)

  5. 按一下「儲存

    編輯專案名稱

瀏覽至您現有的專案
  1. 從Adobe Developer Console按一下​所有專案

    搜尋專案

  2. 找到您的專案,然後按一下以開啟。

    尋找專案

2.新增Forms API

根據您想要做的以下工作新增Forms API:

  • AEM Forms Communications API:需要產生、轉換、組合或保護檔案(PDF及相關格式)時使用。
  • Adaptive Forms Runtime API — 在執行階段需要轉譯、提交或處理Adaptive Forms時使用。
適用於AEM Forms Communications API的
  1. 按一下​新增API

    新增API

  2. 選取​Forms通訊API

    1. 在​ 新增API ​對話方塊中,依​ Experience Cloud ​篩選

    2. 選取​「Forms通訊API」

      新增Forms通訊API

    3. 按一下「下一步」。

    4. 選取​ OAuth伺服器對伺服器 ​驗證方法

      選取驗證方法

最適化Forms執行階段API的
  1. 按一下[新增API]

    新增API

  2. 選取AEM Forms傳遞和執行階段API

    1. 在​ 新增API ​對話方塊中,依​ Experience Cloud ​篩選

    2. 選取​「AEM Forms傳遞和執行階段API」
      新增Forms通訊API

    3. 按一下「下一步」。

    4. 選取​ OAuth伺服器對伺服器 ​驗證方法。
      選取驗證方法

您也可以按一下​新增至專案 > API,將API和驗證方法新增至您現有的專案
新增API至現有的專案

3.新增產品設定檔

產品設定檔提供存取AEM資源的憑證許可權(或授權)。

  1. 選取符合您AEM執行個體URL ()的​產品設定檔https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com

    • 服務型別 — 指定與AEM執行個體關聯的服務或許可權

    • 環境型別 — 指定環境是用於作者或發佈服務

    • 方案XXX — 識別Cloud Manager方案識別碼

    • 環境XXX — 識別該程式中的特定環境ID

    note note
    NOTE
    產品設定檔會繫結至特定的AEM執行個體(程式+環境)。 一律選擇符合執行個體URL的設定檔。
  2. 按一下​「儲存已設定的 API」。API和產品描述檔已新增到您的專案

    選取專案組態

4.產生並儲存認證

  1. 在Adobe Developer Console中導覽至您的專案

  2. 按一下​ OAuth伺服器對伺服器 ​認證

  3. 檢視​ 認證詳細資料 ​區段

    檢視認證

記錄API認證

    API Credentials:
    ================
    Client ID: <your_client_id>
    Client Secret: <your_client_secret>
    Technical Account ID: <tech_account_id>
    Organization ID: <org_id>
    Scopes: AdobeID,openid,read_organizations

5.產生存取權杖

手動或以程式設計方式產生存取權杖:

以進行測試

在Adobe Developer Console中手動產生存取權杖:

  1. 瀏覽至您的專案

    1. 在Adobe Developer Console中,開啟您的專案
    2. 按一下​OAuth伺服器對伺服器
  2. 產生存取權杖

    1. 按一下專案API區段中的​ 「產生存取權杖」 ​按鈕
    2. 複製產生的存取權杖

    產生存取權杖

    note note
    NOTE
    存取權杖僅對​ 24小時 ​有效
用於生產

使用Adobe IMS API以程式設計方式產生權杖:

必要的認證:

  • 用戶端 ID
  • 用戶端密碼
  • 範圍(通常: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document

權杖端點:

code language-none
https://ims-na1.adobelogin.com/ims/token/v3

範例要求(curl):

code language-bash
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<YOUR_CLIENT_ID>' \
-d 'client_secret=<YOUR_CLIENT_SECRET>' \
-d 'scope=AdobeID,openid,read_organizations'

回應:

code language-json
    {
    "access_token": "eyJhbGciOiJSUz...",
    "token_type": "bearer",
    "expires_in": 86399
    }

您現在可以使用產生的存取Token針對開發、預備或生產環境進行API呼叫。

最佳實務:管理開發、測試和生產的認證

  • 請一律使用開發、測試和生產的個別認證。

  • 將每個認證對應至正確的AEM環境URL。

  • 安全地儲存秘密,並且絕不將其提交至原始檔控制。

  • 追蹤存取權杖有效性,因為權杖僅在24小時內有效。

後續步驟

若要瞭解如何設定同步Forms通訊API的環境,請參閱AEM Forms as a Cloud Service通訊同步處理

相關文章

瞭解如何設定同步(隨選)和非同步(批次) Forms Communications API的環境:

同步API

AEM Forms Communications API — 同步

瞭解如何設定同步(隨選) Forms Communications API的環境,以便立即產生或處理檔案。

了解更多

非同步API

AEM Forms Communications API — 非同步(批次)

瞭解如何為非同步(批次) Forms Communications API設定環境,以排程方式產生或處理多個檔案。

了解更多

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab