OAuth 2.0 Integración para transferencias salientes en tiempo real oauth-integration-for-real-time-outbound-transfers
Al publicar segmentos en el destino socio a través de una integración de servidor a servidor en tiempo real, se puede configurar Audience Manager para que se autentiquen al OAuth 2.0 realizar las solicitudes. Esto presenta la capacidad de emitir solicitudes autenticadas desde el Audience Manager hasta el extremo.
Authentication Flujo auth-flow
La Adobe Audience Manager implementación de autenticación de OAuth 2.0 se basa en el flujo de concesión de credenciales de cliente y sigue estos pasos:
-
Debe proporcionarnos:
- El OAuth 2.0 extremo que genera el token de autenticación.
- Las credenciales utilizadas para generar un token.
-
Un Audience Manager consultor configura el destino con la información proporcionada.
-
Una vez que un segmento se asigna a este destino, nuestro sistema de transferencia de datos en tiempo real, IRIS, hace un
POSTsolicitud al punto final del token para intercambiar las credenciales por un token al portador. -
Para cada segmento solicitud de publicación al punto final de socio, IRIS utiliza el token al portador para autenticarse.
Requisitos auth-requirements
Audience Manager Como socio, se necesitan los siguientes puntos finales para recibir solicitudes autenticadas:
Punto final 1 utilizado por IRIS para obtener un token al portador
Este extremo aceptará las credenciales proporcionadas en el paso 1 y generará un token al portador que se utilizará en solicitudes posteriores.
- El extremo debe aceptar
HTTP POSTsolicitudes. - El extremo debe aceptar y mirar el Authorization encabezado. El valor de este encabezado será:
Basic <credentials_provided_by_partner>. - El punto final debe mirar el Content-type encabezado y validar que su valor es
application/x-www-form-urlencoded ; charset=UTF-8. - El cuerpo del solicitud será
grant_type=client_credentials.
Ejemplo solicitud realizado por Audience Manager al punto final socio para obtener un token al portador
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
Ejemplo de respuesta del punto de conexión del socio
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"}
Punto final 2 utilizado por IRIS para publicar segmentos utilizando el token al portador
Audience Manager Envía datos a este extremo casi en tiempo real, ya que los usuarios cumplen los requisitos para los segmentos. Además, este método puede enviar lotes de datos de sin conexión o incorporados con una frecuencia de hasta cada 24 horas.
El token al portador generado por el extremo 1 se utiliza para emitir solicitudes a este extremo. El Audience Manager sistema de transferencia de datos en tiempo real, IRIS, construye un solicitud HTTPS normal e incluye un encabezado de autorización. El valor de este encabezado será: Portador <bearer token from step 1>.
Ejemplo de respuesta del punto de conexión del socio
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"
}
]
}]
}
Consideraciones importantes considerations
Los tokens son contraseñas
Las credenciales presentadas por el socio y los tokens obtenidos al Audience Manager autenticarse utilizando el OAuth 2.0 flujo, son información sensible y no deben compartirse con terceros.
SSL es obligatorio
SSL debe utilizarse para mantener un proceso de autenticación seguro. Todas las solicitudes, incluidas las utilizadas para obtener y utilizar los tokens, deben utilizar HTTPS extremos.