Autenticación y acceso a las API de Experience Platform

Este documento proporciona un tutorial paso a paso para obtener acceso a una cuenta de desarrollador de Adobe Experience Platform con el fin de hacer llamadas a las API de Experience Platform. Al final de este tutorial, habrá generado o recopilado las siguientes credenciales que se requieren como encabezados en todas las llamadas a la API de Platform:

Para mantener la seguridad de sus aplicaciones y usuarios, todas las solicitudes a las API de Experience Platform deben autenticarse y autorizarse utilizando estándares como OAuth.

Este tutorial explica cómo recopilar las credenciales necesarias para autenticar las llamadas a la API de Platform, tal como se describe en el diagrama de flujo siguiente. Puede recopilar la mayoría de las credenciales necesarias en la configuración inicial única. Sin embargo, el token de acceso debe actualizarse cada 24 horas.

Requisitos previos prerequisites

Para realizar llamadas correctamente a las API de Experience Platform, debe tener lo siguiente:

También debe disponer de un Adobe ID para completar este tutorial. Si no tiene una Adobe ID, puede crearla siguiendo estos pasos:

Obtener acceso de desarrollador y usuario para Experience Platform gain-developer-user-access

Antes de crear integraciones en la consola de Adobe Developer, la cuenta debe tener permisos de desarrollador y usuario para un perfil de producto de Experience Platform en Adobe Admin Console.

Obtener acceso de desarrollador gain-developer-access

Contactar con un Admin Console administrador de su organización para agregarle como desarrollador a un perfil de producto de Experience Platform utilizando Admin Console. Consulte la Admin Console para obtener instrucciones específicas sobre cómo administración del acceso de desarrollador para perfiles de producto.

Una vez que se le asigne como desarrollador, puede empezar a crear integraciones en Consola de Adobe Developer. Estas integraciones son una canalización de aplicaciones y servicios externos a las API de Adobe.

Obtener acceso de usuario gain-user-access

Su Admin Console El administrador también debe agregarle como usuario al mismo perfil de producto de. Con el acceso de los usuarios, puede ver en la interfaz de usuario el resultado de las operaciones de API que realiza.

Consulte la guía de administración de grupos de usuarios en Admin Console para obtener más información.

Generación de una clave de API (ID de cliente) y un ID de organización generate-credentials

Una vez que se le haya concedido acceso de desarrollador y usuario a Platform mediante Admin Console, el siguiente paso es generar su {ORG_ID} y {API_KEY} credenciales en la consola de Adobe Developer. Estas credenciales solo deben generarse una vez y pueden reutilizarse en futuras llamadas a la API de Platform.

Añadir un Experience Platform a un proyecto add-platform-to-project

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 creación de un proyecto vacío en la documentación de la consola de Adobe Developer.

Una vez creado un nuevo proyecto, seleccione Añadir API en el Resumen del proyecto pantalla.

Aparece la pantalla Añadir una API. Seleccione el icono de producto de Adobe Experience Platform y, a continuación, elija API de Experience Platform antes de seleccionar Siguiente.

Seleccione el tipo de autenticación de servidor a servidor OAuth select-oauth-server-to-server

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

Selección de los perfiles de producto para la integración select-product-profiles

En el Configurar API pantalla, seleccione AEP-Default-All-Users.

Seleccionar Guardar API configurada cuando esté listo.

En el tutorial de vídeo siguiente también se muestra una descripción detallada de los pasos descritos anteriormente para configurar una integración con la API de Experience Platform:

Recopilar credenciales gather-credentials

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

Generación de un token de acceso generate-access-token

El siguiente paso es generar una {ACCESS_TOKEN} credenciales para su uso en llamadas a la API de Platform. A diferencia de los valores para {API_KEY} y {ORG_ID}, se debe generar un nuevo token cada 24 horas para seguir utilizando las API de Platform. Seleccionar Generar token de acceso, como se muestra a continuación.

[Obsoleto]{class="badge informative"} Generar un token web JSON (JWT) jwt

curl -X POST https://ims-na1.adobelogin.com/ims/exchange/jwt \
  -H 'Content-Type: multipart/form-data' \
  -F 'client_id={API_KEY}' \
  -F 'client_secret={SECRET}' \
  -F 'jwt_token={JWT}'

{
  "token_type": "bearer",
  "access_token": "{ACCESS_TOKEN}",
  "expires_in": 86399992
}

Probar credenciales de acceso test-credentials

Una vez que haya recopilado las tres credenciales necesarias (token de acceso, clave de API e ID de organización) , puede intentar realizar la siguiente llamada de API. Esta llamada enumera todas las Experience Data Model (XDM) clases disponibles para su organización. Importe y ejecute la llamada en Postman.

Solicitud

curl -X GET https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}'

Respuesta

Si su respuesta es similar a la que se muestra a continuación, sus credenciales son válidas y funcionan. (Esta respuesta se ha truncado para el espacio).

{
  "results": [
    {
        "title": "XDM ExperienceEvent",
        "$id": "https://ns.adobe.com/xdm/context/experienceevent",
        "meta:altId": "_xdm.context.experienceevent",
        "version": "1"
    },
    {
        "title": "XDM Individual Profile",
        "$id": "https://ns.adobe.com/xdm/context/profile",
        "meta:altId": "_xdm.context.profile",
        "version": "1"
    }
  ]
}

Obtenga los permisos de control de acceso basados en atributos necesarios get-abac-permissions

Para acceder o modificar varios recursos dentro de Experience Platform, debe tener los permisos de control de acceso adecuados. Los administradores del sistema pueden concederle la permisos que necesita. Obtenga más información en la sección acerca de administrar credenciales de API para un rol.

Encontrará información detallada sobre cómo un administrador del sistema puede conceder los permisos necesarios para acceder a los recursos de la plataforma a través de la API en el siguiente tutorial de vídeo:

Usar Postman para autenticar y probar llamadas a la API use-postman

Postman es una herramienta popular que permite a los desarrolladores explorar y probar las API de RESTful. Puede utilizar las colecciones y los entornos de Experience Platform Postman para acelerar el trabajo con las API de Experience Platform. Más información sobre uso de Postman en Experience Platform e introducción a colecciones y entornos.

Encontrará información detallada sobre el uso de Postman con colecciones y entornos de Experience Platform en los videotutoriales que se muestran a continuación:

Descargar e importar un entorno de Postman para utilizarlo con las API de Experience Platform

Uso de una colección Postman para generar tokens de acceso

Descargue la Colección Postman del servicio Identity Management y vea el siguiente vídeo para aprender a generar tokens de acceso.

Descargar colecciones de Postman de API de Experience Platform e interactuar con las API

Administradores del sistema: Conceder control de acceso a API y desarrollador con permisos de Experience Platform grant-developer-and-api-access-control

Antes de crear integraciones en la consola de Adobe Developer, la cuenta debe tener permisos de desarrollador y usuario para un perfil de producto de Experience Platform en Adobe Admin Console.

Añadir desarrolladores al perfil del producto add-developers-to-product-profile

Vaya a Admin Console e inicie sesión con su Adobe ID.

Seleccionar Productos, luego seleccione Adobe Experience Platform de la lista de productos.

Desde el Perfiles de producto pestaña, seleccione AEP-Default-All-Users. También puede utilizar la barra de búsqueda para buscar el perfil del producto introduciendo el nombre.

Seleccione el Desarrolladores pestaña, luego seleccione Agregar desarrollador.

Introduzca el del desarrollador Correo electrónico o nombre de usuario. Un válido Correo electrónico o nombre de usuario mostrará los detalles del desarrollador. Seleccione Guardar.

El desarrollador se ha añadido correctamente y aparece en Desarrolladores pestaña.

Asignar API a un rol

Un administrador del sistema puede asignar API a funciones en la interfaz de usuario del Experience Platform.

Seleccionar Permisos y la función a la que desea agregar la API. Seleccione el Credenciales de API pestaña, luego seleccione Añadir credenciales de API.

Seleccione la API que desee añadir a la función y, a continuación, seleccione Guardar.

Se le devolverá a la Credenciales de API , donde se muestra la API recién agregada.

Recursos adicionales additional-resources

Consulte los recursos adicionales vinculados a continuación para obtener más ayuda sobre la introducción a las API de Experience Platform

Pasos siguientes next-steps

Al leer este documento, ha recopilado y probado correctamente sus credenciales de acceso para las API de Platform. Ahora puede seguir junto con las llamadas de API de ejemplo proporcionadas a través de documentación.

Además de los valores de autenticación recopilados en este tutorial, muchas API de plataforma también requieren un {SANDBOX_NAME} se proporcionará como encabezado. Consulte la información general sobre las zonas protegidas para obtener más detalles.