Autenticación y acceso a la API de Privacy Service

Esta guía proporciona una introducción a los conceptos principales que debe conocer antes de intentar realizar llamadas a la API de Adobe Experience Platform Privacy Service.

Requisitos previos prerequisites

Esta guía requiere una comprensión práctica de Privacy Service y cómo le permite administrar las solicitudes de acceso y eliminación de sus interesados (clientes) en las aplicaciones de Adobe Experience Cloud.

Para crear credenciales de acceso para la API, un administrador de su organización debe haber configurado previamente perfiles de producto para un Privacy Service en Adobe Admin Console. El perfil de producto que asigna a una integración de API determina qué permisos tiene la integración al acceder a las funciones de Privacy Service. Consulte la guía de administración de permisos de Privacy Service para obtener más información.

Recopilación de valores para los encabezados obligatorios gather-values-required-headers

Para realizar llamadas a la API de Privacy Service, primero debe recopilar las credenciales de acceso para utilizarlas en los encabezados obligatorios:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Estos valores se generan mediante Consola de Adobe Developer. Su {ORG_ID} y {API_KEY} solo debe generarse una vez y puede reutilizarse en futuras llamadas a la API. Sin embargo, su {ACCESS_TOKEN} es temporal y debe regenerarse cada 24 horas.

Los pasos para generar estos valores se tratan en detalle a continuación.

Configuración única one-time-setup

Vaya a la consola de desarrollador de Adobe e inicie sesión con su Adobe ID. A continuación, siga los pasos descritos en el tutorial sobre la creación de un proyecto vacío en la documentación de la consola de desarrollador.

Una vez creado un nuevo proyecto, seleccione Agregar al proyecto y elija API en el menú desplegable.

La opción API que se está seleccionando en la Agregar al proyecto Menú desplegable de la página de detalles del proyecto en Developer Console

Seleccione la API de Privacy Service select-privacy-service-api

Aparece la pantalla Añadir una API. Seleccionar Experience Cloud para reducir la lista de API disponibles y, a continuación, seleccione la tarjeta para API de Privacy Service antes de seleccionar Siguiente.

La tarjeta de API de Privacy Service que se está seleccionando de la lista de API disponibles

TIP
Seleccione el Ver documentos opción para navegar en una ventana separada del explorador para completar el Documentación de referencia de la API de Privacy Service.

A continuación, seleccione el tipo de autenticación para generar tokens de acceso y acceder a la API de Privacy Service.

IMPORTANT
Seleccione el Servidor a servidor OAuth , ya que será el único método admitido a partir de ahora. El Cuenta de servicio (JWT) El método está obsoleto. Aunque las integraciones que utilizan el método de autenticación JWT seguirán funcionando hasta el 1 de enero de 2025, Adobe recomienda migrar las integraciones existentes al nuevo método de servidor a servidor OAuth antes de esa fecha. Obtenga más información en la sección+----------------+ | badge negative | +================+ | Obsoleto | +----------------+Generar un token web JSON (JWT).

Seleccione el método de autenticación de servidor a servidor Oauth.

Asignación de permisos mediante perfiles de producto product-profiles

El paso de configuración final es seleccionar los perfiles de producto desde los que heredará esta integración sus permisos. Si selecciona más de un perfil, sus conjuntos de permisos se combinarán para la integración.

NOTE
Los administradores crean y administran los perfiles de producto y los permisos granulares que proporcionan a través de Adobe Admin Console. Consulte la guía de Permisos de Privacy Service para obtener más información.

Cuando termine, seleccione Guardar API configurada.

Se está seleccionando un solo perfil de producto de la lista antes de guardar la configuración

Una vez añadida la API al proyecto, la variable API de Privacy Service Esta página del proyecto muestra las siguientes credenciales, necesarias en todas las llamadas a las API de Privacy Service:

  • {API_KEY} (ID de cliente)
  • {ORG_ID} (ID de organización)

Información de integración después de agregar una API en Developer Console.

Autenticación para cada sesión authentication-each-session

La credencial final necesaria que debe recopilar es su {ACCESS_TOKEN}, que se utiliza en el encabezado Autorización. A diferencia de los valores para {API_KEY} y {ORG_ID}, se debe generar un nuevo token cada 24 horas para seguir utilizando la API.

En general, hay dos métodos para generar un token de acceso:

Generación manual de un token manual-token

Para generar manualmente una nueva {ACCESS_TOKEN}, vaya a Credenciales > Servidor a servidor OAuth y seleccione Generar token de acceso, como se muestra a continuación.

Grabación de pantalla de cómo se genera un token de acceso en la interfaz de usuario de Developer Console.

Se genera un nuevo token de acceso y se proporciona un botón para copiar el token en el portapapeles. Este valor se utiliza para el encabezado Authorization requerido y debe proporcionarse con el formato Bearer {ACCESS_TOKEN}.

Automatización de la generación de tokens auto-token

También puede utilizar un entorno y una colección de Postman para generar tokens de acceso. Para obtener más información, lea la sección sobre uso de Postman para autenticar y probar llamadas a la API en la guía de autenticación de API de Experience Platform.

Lectura de llamadas de API de muestra read-sample-api-calls

Cada guía de extremo proporciona llamadas de API de ejemplo para demostrar cómo dar formato a sus solicitudes. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en la guía de introducción para las API de Platform.

Pasos siguientes next-steps

Ahora que comprende qué encabezados utilizar, está listo para empezar a realizar llamadas a la API de Privacy Service. Seleccione una de las guías de extremos para empezar:

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580