設定驗證 Adobe Target API
此 Adobe Target 管理API,包括 Recommendations Admin API由驗證保護,以確保僅授權使用者使用它們來存取 Adobe Target. 使用 Adobe Developer Console 以管理所有使用者的驗證 Adobe Experience Cloud solutions,包括 Adobe Target.
以下為產生舊版JWT驗證權杖所需的初步步驟,以便與成功互動 Adobe Target API:
- 在中建立專案(先前稱為整合) Adobe Developer Console.
- 將專案詳細資料匯出至Postman。
- 產生持有者存取權杖。
- 測試持有者存取權杖。
先決條件
在本指南的其餘部分中假設您熟悉以下資源:
建立Adobe I/O專案
在本節中,您將存取 Adobe Developer Console 並為建立專案 Adobe Target. 如需詳細資訊,請參閱 專案檔案.
<!—(1. 根據「 」產生您的私密金鑰和公開憑證 有關驗證的檔案.// [//]: # (如所述 步驟1 之 如何設定AdobeIO:驗證 — 逐步進行. 完成步驟1後,請返回本指南並繼續執行以下步驟2。//此步驟的結果應是建立 private.key
檔案和 certificate_pub.crt
檔案。 產生這兩個檔案之後,請回到本指南。)—>
-
在 Adobe Admin Console,確定您的 Adobe 使用者帳戶已同時被授予 產品管理員 和 開發人員 層級存取至 Target.
-
在 Adobe Developer Console,選取 Experience Cloud組織 要為其建立此整合的專案。 (請注意,您可能只能存取單一 Experience Cloud組織.)
-
按一下 建立新專案.
-
按一下 新增API 新增REST API至您的專案以存取 Adobe 服務與產品。
-
選取 Adobe Target 作為 Adobe 要整合的服務。 按一下 下一個 按鈕隨即顯示。
-
選取一個選項,將公開和私密金鑰與您要建立的服務帳戶整合建立關聯 Target. 在此範例中,選取 選項1:產生金鑰組 並按一下 產生金鑰組.
-
依照指示,記下自動下載的組態檔(
config
),其中包含您的私密金鑰。 按 「下一步」。 -
在您的檔案系統中,確認
config
,在上一步建立的壓縮組態檔。 同樣地,這個config
檔案包含您的私密金鑰,您稍後需要這些金鑰。 檔案系統內的確切位置可能與此處顯示的位置不同。 -
返回Adobe Developer Console,選取 產品設定檔 與您在其中使用Adobe Recommendations的屬性相對應。 (如果您未使用屬性,請選取「預設工作區」選項。) 按一下 儲存已設定的API.
-
按一下 建立整合. 您應該會收到暫時訊息,指出您的API已成功設定。
-
最後一個步驟,是將專案重新命名為比原始專案更有意義的名稱
Project 1
. 若要這麼做,請使用導覽路徑顯示來導覽至專案,按一下 編輯專案 以存取 編輯專案 模型,並重新命名專案。
匯出專案詳細資料
現在您已擁有Adobe專案,可用來存取 Target,您必須確定傳送該專案的詳細資訊以及AdobeAPI要求。 若要與多個AdobeAPI互動,包括多個 Target API。 例如,整合詳細資料包括所需的授權和驗證資訊 Target 管理API。 因此,若要搭配Postman使用API,您必須將這些詳細資料帶入Postman。
有許多方式可在Postman中指定您專案的詳細資料,但在本節中,我們利用了某些預先建立的功能和集合。 首先(在本節中),您會將整合的詳細資訊匯出至Postman環境。 接下來(在以下區段中),您將產生持有者存取權杖,以授予您存取必要Adobe資源的許可權。
-
仍在 Adobe Developer Console,導覽以檢視您的新專案 服務帳戶(JWT) 認證。 使用左側導覽或 認證 區段,如下所示。
在 認證詳細資料,請注意,您可以檢視 公開金鑰, 使用者端ID,以及與您的服務帳戶相關的其他資訊。
-
按一下以導覽至 Adobe Target API。 使用左側導覽或 連線的產品和服務 區段,如下所示。
-
按一下 Postman專用下載 > 服務帳戶(JWT) 建立擷取Postman環境驗證資訊的JSON檔案。
請記下檔案系統中的JSON檔案。
-
在Postman中,按一下齒輪圖示來管理您的環境,然後按一下 匯入 匯入JSON檔案(環境)。
-
選擇您的檔案,然後按一下 開啟.
-
在Postman中 管理環境 強制回應視窗,按一下新匯入環境的名稱以進行檢查。 (您的環境名稱可能與此處顯示的名稱不同。 視需要編輯名稱。 它不一定需要符合 Adobe 專案。)
-
注意
CLIENT_SECRET
和API_KEY
(連同其他變數)會預先填入其值,取自您在Adobe Developer主控台中定義的整合。 (PostmanCLIENT_SECRET
變數應符合CLIENT SECRET
開發人員控制檯中顯示的Adobe認證,以及API_KEY
在Postman中也應相符CLIENT ID
(位於開發人員主控台)。 相反地,注意PRIVATE_KEY
,JWT_TOKEN
、和ACCESS_TOKEN
為空白。 讓我們從提供PRIVATE_KEY
值。 -
從您的檔案系統,開啟
config
檔案,並開啟private
金鑰檔案。 -
選擇並複製所有內容
private
金鑰檔案。 -
在Postman中,將您的私密金鑰值貼到 初始值 和 目前值 欄位。
-
按一下 更新,然後關閉環境強制回應視窗。
產生持有者存取權杖
在本節中,您會產生持有者存取權杖,這是驗證您與的互動所需的權杖 Adobe Target API。 若要產生持有者存取Token,您必須將整合詳細資訊(建立於上節中)傳送至 AdobeIdentity Management服務(IMS). 有幾種方法可以達成此目的,但在本指南中,我們利用了包含預先建立IMS呼叫的Postman集合,讓程式簡單明瞭。 匯入集合後,您可以視需要重複使用它,以產生新的代號,而不只是用於 Adobe Target、以及其他Adobe API。
-
導覽至 AdobeIdentity Management服務API範例呼叫.
-
按一下 產生Postman集合的Adobe I/O存取權杖.
-
按一下「 」以取得此集合的原始JSON 原始,然後將產生的JSON複製到剪貼簿。 (您也可以將原始JSON儲存為.json檔案。)
-
在Postman中,透過貼上並從剪貼簿提交原始JSON來匯入集合。 (您也可以上傳已儲存的.json檔案)。 按一下 「繼續」。
-
選取 IMS:JWT透過使用者權杖產生+驗證 請求產生PostmanAdobe I/O存取權杖集合,確認已選取您的環境,然後按一下 傳送 以產生權杖。
note note NOTE 此持有者存取權杖的有效期限為24小時。 每當您需要產生新Token時,請再次傳送請求。 -
再次開啟管理環境強制回應視窗,然後選取您的環境。
-
請注意
ACCESS_TOKEN
和JWT_TOKEN
現在會填入值。
問題:我是否必須使用Adobe I/O存取權杖產生Postman集合來產生JSON Web權杖(JWT)和持有者存取權杖?
答案:否。 Adobe I/O存取權杖產生Postman集合可方便在Postman中更輕鬆地產生JWT和持有者存取權杖。 或者,您可以使用Adobe Developer主控台中的功能,手動產生持有者存取權杖。
測試持有者存取權杖
在本練習中,您將傳送一個API請求來使用新的持有者存取權杖,該請求會從您的中擷取活動清單 Target 帳戶。 成功的回應表示您的 Adobe 專案和驗證如預期運作,以使用API。
-
匯入 Adobe Target 管理API Postman集合. 按照所有提示操作,直到在Postman中匯入集合為止。
-
展開集合,然後記下 列出活動 要求。
-
請注意,變數如
{{access_token}}
一開始未解決。 您可以用數種不同的方式解決此問題 — 例如,您可以定義新的集合變數,稱為{{access_token}}
— 但在本指南中,您將會變更API請求,以運用您先前使用的Postman環境。 如此一來,環境就能繼續以單一、一致的方式整合AdobeAPI間所有通用變數。 -
要取代的型別
{{access_token}}
替換為{{ACCESS_TOKEN}}
. -
要取代的型別
{{api_key}}
替換為{{API_KEY}}
. -
要取代的型別
{{tenant}}
替換為{{TENANT_ID}}
. 注意{{TENANT_ID}}
尚未辨識。 -
開啟管理環境強制回應視窗,然後選取您的環境。
-
輸入以新增
{{TENANT_ID}}
環境變數。 複製租使用者ID值並貼到中 初始值 和 目前值 新欄位TENANT_ID
環境變數。note note NOTE 租使用者ID與您的不同 Target clientcode
. 當您登入時,租使用者ID存在於URL中 Target. 若要取得租使用者ID,請登入Adobe Experience Cloud,然後開啟 Target,然後按一下Target卡片。 使用URL子網域中所述的租使用者ID值。 例如,如果您在登入時的URL Adobe Target 是<https://mycompany.experiencecloud.adobe.com/...>
則您的租使用者ID為「mycompany」。 -
在確認您已選取正確的環境後,傳送您的請求。 您應會收到包含活動清單的回應。
現在您已驗證Adobe驗證,接下來可以使用它來與互動 Adobe Target API (以及其他AdobeAPI)。 例如,您可以 使用Recommendations API 以建立或管理建議,或者您可以將其用於 Target傳送API.