실시간 아웃바운드 전송을 위한 OAuth 2.0 통합 oauth-integration-for-real-time-outbound-transfers
실시간 서버 간 통합을 통해 파트너 대상에 세그먼트를 게시할 때 요청을 수행할 때 OAuth 2.0을(를) 사용하여 인증하도록 Audience Manager을 설정할 수 있습니다. Audience Manager에서 엔드포인트로 인증된 요청을 발행하는 기능을 제공합니다.
인증 흐름 auth-flow
Adobe Audience Manager OAuth 2.0 인증 구현은 클라이언트 자격 증명 부여 흐름을 기반으로 하며 다음 단계를 따릅니다.
요구 사항 auth-requirements
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"
}
]
}]
}
중요한 고려 사항 considerations
토큰은 암호입니다.
OAuth 2.0 흐름을 사용하여 인증할 때 파트너가 제공한 자격 증명과 Audience Manager이(가) 얻은 토큰은 중요한 정보이므로 서드파티와 공유해서는 안 됩니다.
SSL은(는) 필수입니다.
보안 인증 프로세스를 유지하려면 SSL을(를) 사용해야 합니다. 토큰을 가져오고 사용하는 데 사용되는 요청을 포함하여 모든 요청은 HTTPS
끝점을 사용해야 합니다.