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

마지막 업데이트: 2023-05-21

실시간 서버 간 통합을 통해 파트너 대상에 세그먼트를 게시할 때 을 사용하여 인증하도록 Audience Manager을 설정할 수 있습니다. OAuth 2.0 요청할 때. Audience Manager에서 엔드포인트로 인증된 요청을 발행하는 기능을 제공합니다.

인증 흐름

다음 Adobe Audience Manager OAuth 2.0 인증 구현은 클라이언트 자격 증명 부여 플로우를 기반으로 하며 다음 단계를 따릅니다.

  1. 다음을 제공해야 합니다.
    • 다음 OAuth 2.0 인증 토큰을 생성하는 종단점입니다.
    • 토큰 생성에 사용되는 자격 증명입니다.
  2. An Audience Manager 컨설턴트가 대상 제공한 정보를 사용합니다.
  3. 세그먼트가 이 대상, 즉 실시간 데이터 전송 시스템에 매핑되면 홍채을(를) 만드는 경우 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 실시간 데이터 전송 시스템, 홍채는 일반 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"
         }
      ]
   }]
}
노트

이 요청에는 표준 페이로드(요청 컨텐츠)가 포함되어 있습니다.

중요한 고려 사항

토큰은 암호입니다.

파트너가 제공한 자격 증명과 획득 토큰 Audience Manager 를 사용하여 인증하는 경우 OAuth 2.0 플로우, 는 중요한 정보이며 서드파티와 공유해서는 안 됩니다.

SSL 필수

SSL 보안 인증 프로세스를 유지 관리하려면 을(를) 사용해야 합니다. 토큰을 가져오고 사용하는 데 사용되는 요청을 포함한 모든 요청은 를 사용해야 합니다. HTTPS 엔드포인트.

이 페이지에서는