OAuth 2.0 整合即時出站傳輸

透過即時伺服器對伺服器整合將區段發佈至合作夥伴目標時,Audience Manager可在提出要求時設定為使用OAuth 2.0進行驗證。 這可讓您從Audience Manager向端點發出已驗證的請求。

驗證流

Adobe Audience Manager OAuth 2.0驗證實作是以「用戶端認證」授權流程為基礎,並遵循下列步驟:

  1. 您必須提供以下資訊:
    • 產生驗證Token的OAuth 2.0端點。
    • 用來產生Token的憑證。
  2. Audience Manager顧問使用您提供的資訊設定目標
  3. 一旦區段被映射到此目的地,我們的即時資料傳輸系統IRIS向令牌端點發出POST請求以交換承載令牌的認證。
  4. 對於向夥伴端點發佈的每個區段請求,IRIS會使用承載Token進行驗證。

要求

作為Audience Manager合作夥伴,需要下列端點才能接收已驗證的請求:

IRIS用於獲取承載令牌的端點1

此端點將接受步驟1中提供的認證,並產生用於後續請求的承載Token。

  • 端點必須接受HTTP POST請求。
  • 端點必須接受並查看Authorization標題。 此標題的值為:Basic <credentials_provided_by_partner>
  • 端點必須查看Content-type標題並驗證其值是否為application/x-www-form-urlencoded ; charset=UTF-8
  • 請求正文為grant_type=client_credentials

Audience Manager向合作夥伴端點提出的範例要求,以取得載體Token

POST /oauth2/token HTTP/1.1
Host: api.partner.com
User-Agent: Adobe Audience Manager Iris
Authorization: Basic zq2LOO1CcYGrODS5nXiNHpEz97eCpVHAoMF8pAgCntXAzxp5uRV7DTAE2qtPLjhMQwrEX3O6MHV4S
Content-Type: application/x-www-form-urlencoded;charset=UTF-8
Content-Length: 29
Accept-Encoding: gzip
  
grant_type=client_credentials

合作夥伴端點的範例回應

HTTP/1.1 200 OK
Status: 200 OK
Content-Type: application/json; charset=utf-8
...
Content-Encoding: gzip
Content-Length: 121
  
{"token_type":"Bearer","access_token":"glIbBVohK8d86alDEnllPWi6IpjZvJC6kwBRuuawts6YMkw4tZkt84rEZYU2ZKHCQP3TT7PnzCQPI0yY"}

IRIS使用端點2來使用承載Token發佈區段

Audience Manager 當使用者符合區段的資格時,會即時傳送資料至此端點。此外,此方法可每24小時傳送一批離線或已登入的資料。

端點1產生的承載Token可用來向此端點發出請求。 該Audience Manager即時資料傳輸系統IRIS構造一般的HTTPS請求並包括授權標頭。 此標題的值為:載體<bearer token from step 1>

合作夥伴端點的範例回應

GET /segments/aam HTTP/1.1
Host: api.partner.com
User-Agent: Adobe Audience Manager Iris
Authorization: Bearer glIbBVohK8d86alDEnllPWi6IpjZvJC6kwBRuuawts6YMkw4tZkt84rEZYU2ZKHCQP3TT7PnzCQPI0yY
Content-Type: application/json
Accept-Encoding: gzip
   
{
"ProcessTime": "Wed Jul 27 16:17:42 UTC 2016",
"User_DPID": "12345",
"Client_ID": "74323",
"AAM_Destination_Id": "423",
"User_count": "2",
"Users": [{
   "AAM_UUID": "19393572368547369350319949416899715727",
   "DataPartner_UUID": "4250948725049857",
   "Segments": [{
            "Segment_ID": "14356",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         }
      ]
   }]
}
注意

此請求包含標準裝載(請求內容)。

重要注意事項

Token是密碼

合作夥伴出示的認證和Audience Manager在使用OAuth 2.0流進行驗證時獲得的代號是敏感資訊,不得與第三方共用。

SSL 必要

SSL 必須使用才能維護安全驗證程式。所有請求,包括用於獲取和使用Token的請求,都必須使用HTTPS端點。

本頁內容

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