OAuth 2.0 실시간 아웃바운드 전송을 위한 통합 oauth-integration-for-real-time-outbound-transfers
실시간 서버 간 통합을 통해 파트너 대상에 세그먼트를 게시할 때 을 사용하여 인증하도록 Audience Manager을 설정할 수 있습니다. OAuth 2.0 요청할 때. 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 실시간 데이터 전송 시스템, 홍채는 일반 HTTPS 요청을 구성하며 인증 헤더를 포함합니다. 이 헤더의 값은 Bearer가 됩니다. <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
토큰은 암호입니다.
파트너가 제공한 자격 증명과 획득 토큰 Audience Manager 를 사용하여 인증하는 경우 OAuth 2.0 플로우, 는 중요한 정보이며 서드파티와 공유해서는 안 됩니다.
SSL 필수
SSL 보안 인증 프로세스를 유지 관리하려면 을(를) 사용해야 합니다. 토큰을 가져오고 사용하는 데 사용되는 요청을 포함한 모든 요청은 를 사용해야 합니다. HTTPS
엔드포인트.