Integration overview and prerequisites

此資訊會告訴您如何建立Adobe I/O和Places服務整合。

使用者存取的先決條件

向組織的系統管理員確認下列任務已完成:

  • 「置入核心服務」會顯示在您組織的管理控制台中。

  • 您已加入組織。

  • 您已新增為「將核心服務置於組織中的使用者」。

    如需詳細資訊,請參 閱「取得Places服務的存取權」中的「將使用者或開發人員新增至您的Places服務和體驗平台啟動設定檔​

  • 您已新增為「開發人員」,加入貴組織的「放置核心服務」。

    如需新增開發人員的詳細資訊,請參 閱取得Places服務存取權中的「將使用者或開發人員新增至您的Places服務和Experience Platform Launch設定檔​

    如需開發人員角色的詳細資訊,請參閱「管 理開發人員」。

REST API請求

對Places Service REST API的每個請求都需要下列項目:

  • 組織ID
  • API金鑰
  • 持牌代號

與Adobe I/O的整合提供這些項目,以及使用JSON網頁Token(JWT)來請求不記名Token的方式。

  • 如需JWT的詳細資訊,請參 閱JSON Web Token簡介
  • 要為Places服務建立整合,請參 閱下面的建立Places服務整合
  • 若要瞭解API金鑰整合、產生JWT和公開金鑰憑證,請參閱 Adobe I/O驗證概觀
重要

如果您無法登入Adobe I/O主控台,或如果「建立整合」頁面上不提供「置入服務」選項 ,請參閱「網站服務API概觀」中的「組織需求」 **

建立Places服務整合

要建立Places服務整合,請完成以下任務:

生成公共密鑰對和私有密鑰對

若要建立Places Service整合,您需要公用和私用金鑰對。 您可以購買這些對,也可以產生您自己的自簽金鑰。

若要產生您自己的自簽金鑰:

  1. 在終端視窗中,複製並貼上下列每一行,並在貼上每 Enter 一行後按:

       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    重要

    建議您命名索引鍵以方便參考,並將它們儲存在資料夾中。 如果您建立多個整合,您可以輕鬆識別和管理屬於哪個整合的金鑰。

  2. 輸入OpenSSL要求的資訊:

    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    

    如需OpenSSL的詳細資訊,請參閱 OpenSSL

    重要

    您提供的資訊會併入索引鍵中。

  3. 導覽至和檔案所 .key.crt 的目錄。

    例如,在MacOS中,請至 Macintosh HD > users > (your user name) > Keys

以下視頻將引導您完成生成密鑰對的過程:

整合視訊

在Adobe I/O主控台中建立Places服務整合

要建立Places服務整合,請執行以下操作:

  1. 請前往 https://console.adobe.io ,並使用您的Adobe ID登入。

  2. 在「快速 開始 」區段中,按一下「 建立整合」

  3. 選取 Access an API 並按一下 Continue

    Access an API 是預設位置。

  4. 如果您可以存取多個Experience Cloud組織,請從右上角的下拉式清單中選取組織。

  5. Under Experience Cloud, select Places Service as the Adobe service to which you want to integrate and click Continue.

  6. 選取 New integration 並按一下 Continue

  7. 在「建立新整合」畫面中,輸入名稱和說明。

  8. 將您在上方建 xxxx_public.crt 立的檔案拖放至拖放 Public keys certificates 區域。

  9. 選擇產品設定檔。

    如果您不確定要選擇哪個配置檔案,請與系統管理員聯繫。

  10. 在頁面底部,按一下 Create integration

  11. 數秒後,在「已建立的整 合」畫面中 ,確認出現下列訊息:

    Your integration has been created.

  12. 此時會顯示整合詳細資訊頁面,其頂端是整合名稱。

    依預 Overview 設會顯示標籤,並顯示API金鑰、您的組織ID、技術帳戶ID,以及您整合的其他詳細資訊。

記錄組織ID和API金鑰

  1. 在整合詳細資訊頁面上,按一下 Services 標籤並確認顯 Places Service 示於下方 Configured Services

  2. 在標籤 Overview 上,找出並記錄API金鑰(用戶端ID)和組織ID。

    每個Places Service REST API請求都需要這些ID。

產生JWT Token

在整合詳細資訊頁面上,按一 JWT 下標籤,以便您透過產生JWT並提供交換URL來測試整合。

要生成JWT令牌:

  1. 在文字編輯器中,開啟您在上 private.key 方建立的檔案。

  2. On the JWT tab, copy the contents of the key and paste it in the Paste private key field.

  3. 按一下「Generate JWT」。

  4. In the Sample CURL command section, click Copy and paste the contents in your command prompt or terminal window.

  5. 按鍵盤上的鍵 Enter 盤運行命令。

  6. 找到 "token_type": "bearer""access_token" 值。

    載體存取Token的值是您在Places Service API請求中使用的值。

重要

Adobe存取Token的有效 期限 為24小時,請儲存範例CURL命令(步驟5)。 如果存取Token不再有效,您需要重新產生Token。

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now