Show Menu
화제×

OAuth 2.0 실시간 아웃바운드 전송을 위한 통합

실시간 서버 대 서버 통합을 통해 파트너 대상에 세그먼트를 게시할 때 요청 OAuth 2.0 시 Audience Manager를 인증하도록 설정할 수 있습니다. 이렇게 하면 Audience Manager에서 끝점에 인증된 요청을 발행할 수 있습니다.

인증 흐름

OAuth Adobe Audience Manager 2.0 rfc6749#section-4.4 인증 구현은 클라이언트 자격 증명 부여 흐름을 기반으로 하며 다음 단계를 따릅니다.
  1. 귀하는 다음 사항을 제공해야 합니다.
    • 인증 토큰을 생성하는 OAuth 2.0 끝점입니다.
    • 토큰을 생성하는 데 사용되는 자격 증명입니다.
  2. 컨설턴트는 사용자가 제공한 정보를 사용하여 Audience Manager 대상을 대상 개요 설정합니다.
  3. 세그먼트가 이 대상에 매핑되면 실시간 데이터 전송 시스템인 IRIS가 토큰 끝점에 POST 요청하여 베어러 토큰에 대한 자격 증명을 교환합니다.
  4. 파트너 끝점에 대한 각 세그먼트 게시 요청에 대해 IRIS 베어러 토큰을 사용하여 인증합니다.

요구 사항

파트너가 Audience Manager 되면 인증된 요청을 수신하려면 다음 끝점이 필요합니다.

IRIS 파섹

이 끝점은 1단계에서 제공된 자격 증명을 수락하고 후속 요청에서 사용될 베어러 토큰을 생성합니다.
  • 끝점이 HTTP POST 요청을 수락해야 합니다.
  • 끝점은 Authorization 헤더를 수락하고 확인해야 합니다. 이 헤더의 값은 다음과 같습니다. Basic <credentials_provided_by_partner> Adobe
  • 종단점은 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 파섹

Audience Manager 사용자가 세그먼트를 사용할 수 있으므로 거의 실시간으로 이 끝점에 데이터를 보냅니다. 또한 이 방법은 24시간마다 오프라인 또는 온보드 데이터를 일괄적으로 보낼 수 있습니다.
끝점 1에서 생성된 베어러 토큰은 이 끝점에 대한 요청을 발행하기 위해 사용됩니다. 실시간 데이터 전송 시스템인 IRIS는 Audience Manager 일반적인 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 때 얻은 토큰은 민감한 정보이므로 제3자와 공유해서는 안 됩니다.

SSL is required

SSL 보안 인증 프로세스를 유지하기 위해 사용해야 합니다. 토큰을 가져오고 사용하는 데 사용된 요청을 포함하여 모든 요청은 HTTPS 끝점을 사용해야 합니다.