下載服務認證
下載服務憑證的步驟與初始化類似。
-
確定您是以下列身分登入:
- Adobe IMS組織管理員
- AEM作者 上的 AEM管理員 IMS產品設定檔的成員
-
開啟包含AEM as a Cloud Service環境的程式以與整合
-
點選 環境 區段中環境旁的省略符號,然後選取 Developer Console
-
點選「整合」標籤
-
點選 技術帳戶 標籤
-
展開要使用的 技術帳戶
-
展開將下載其服務認證的 私密金鑰,並確認狀態為 使用中
-
點選與 私密金鑰 相關聯的 … > 檢視,這會顯示服務認證JSON
-
點選左上角的下載按鈕以下載包含服務憑證值的JSON檔案,並將檔案儲存到安全位置
安裝服務認證
服務憑證提供產生JWT所需的詳細資訊,此資訊會交換用來向AEM as a Cloud Service驗證的存取權杖。 服務認證必須儲存在安全位置,可供外部應用程式、系統或服務存取AEM。 每個客戶管理服務認證的方式和位置都是唯一的。
為簡化起見,本教學課程透過命令列傳入服務認證。 然而,請與您的IT安全團隊合作,瞭解如何根據貴組織的安全方針,儲存及存取這些認證。
- 將下載的服務認證JSON複製到專案根目錄中名為
service_token.json
的檔案- 請記住,絕對不要將 任何認證 認可給Git!
使用服務認證
服務憑證是完整格式的JSON物件,與JWT或存取權杖不同。 而是使用服務認證(包含私密金鑰)來產生JWT,再與Adobe IMS API交換存取權杖。
- 將服務認證從AEM Developer Console下載至安全位置
- 外部應用程式需要以程式設計方式與AEM as a Cloud Service環境互動
- 外部應用程式會從安全位置讀取服務證明資料
- 外部應用程式會使用服務憑證中的資訊來建構JWT權杖
- JWT權杖會傳送至Adobe IMS以交換存取權杖
- Adobe IMS傳回可用來存取AEM as a Cloud Service的存取權杖
- 存取權杖無法變更到期時間。
- 外部應用程式會向AEM as a Cloud Service發出HTTP請求,將存取權杖作為持有人權杖新增到HTTP請求的授權標頭
- AEM as a Cloud Service會收到HTTP要求、驗證要求,並執行HTTP要求所要求的工作,然後將HTTP回應傳回至外部應用程式
外部應用程式的更新
若要使用服務憑證存取AEM as a Cloud Service,外部應用程式必須透過三種方式更新:
- 讀取服務認證
- 為簡化起見,服務憑證會從下載的JSON檔案中讀取,但在實際使用情況下,服務憑證必須根據您組織的安全方針安全儲存
- 從服務憑證產生JWT
- 交換JWT以取得存取權杖
- 當存在服務憑證時,外部應用程式在存取AEM as a Cloud Service時會使用此存取權杖,而不是本機開發存取權杖
在本教學課程中,Adobe的@adobe/jwt-auth
npm模組是用來在單一函式呼叫中,(1)從服務憑證產生JWT,以及(2)交換它以取得存取權杖。 如果您的應用程式不是以JavaScript為基礎,請檢閱其他語言的範常式式碼,瞭解如何從服務憑證建立JWT,並與Adobe IMS交換存取權杖。