OAuth 2.0 实时出站传输集成

当通过实时服务器到服务器集成将区段发布到合作伙伴目标时,可以设置Audience Manager以在发出请求时使用OAuth 2.0进行身份验证。 这表明能够从Audience Manager向端点发出经过身份验证的请求。

身份验证流

Adobe Audience Manager OAuth 2.0身份验证实现基于客户端凭据授权流,并遵循以下步骤:

  1. 您必须向我们提供:
    • 生成身份验证令牌的OAuth 2.0端点。
    • 用于生成令牌的凭据。
  2. Audience Manager顾问使用您提供的信息设置destination
  3. 一旦将一个段映射到此目标,我们的实时数据传输系统IRIS向令牌端点发出POST请求以交换承载令牌的凭据。
  4. 对于每个段发布请求到合作伙伴端点,IRIS使用承载令牌进行身份验证。

要求

作为Audience Manager合作伙伴,需要以下端点才能接收经过身份验证的请求:

IRIS用于获取承载令牌的端点1

此端点将接受在步骤1提供的凭据并生成用于后续请求的承载令牌。

  • 端点必须接受HTTP POST请求。
  • 端点必须接受并查看Authorization头。 此标题的值将为:Basic <credentials_provided_by_partner>
  • 端点必须查看Content-type头并验证其值是application/x-www-form-urlencoded ; charset=UTF-8
  • 请求的正文为grant_type=client_credentials

由Audience Manager向伙伴端点发出的示例请求,以便获得承载令牌

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使用承载令牌发布段

Audience Manager 当用户符合区段资格时,会近乎实时地向此端点发送数据。此外,此方法可每24小时发送一批脱机或载入的数据。

端点1生成的承载令牌用于向此端点发出请求。 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"
         }
      ]
   }]
}
注意

此请求包含标准有效负荷(请求内容)。

重要注意事项

令牌是口令

合作伙伴提供的凭据和Audience Manager在使用OAuth 2.0流进行身份验证时获得的令牌是敏感信息,不得与第三方共享。

SSL 必填

SSL 必须用于维护安全身份验证过程。所有请求(包括用于获取和使用令牌的请求)都必须使用HTTPS端点。

On this page

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