Primeros pasos

Información general

En esta página se describe cómo autenticarse y empezar a usar Adobe Experience Platform Destination SDK. Incluye instrucciones sobre cómo obtener las credenciales de autenticación de Adobe I/O, un nombre de simulador de pruebas y el permiso de control de acceso de creación de destino.

Terminología

Esta guía utiliza conceptos específicos de la plataforma, como organización de IMS y entornos limitados. Consulte la glosario del Experience Platform para las definiciones de estos y otros términos.

Obtenga las credenciales de autenticación necesarias

Destination SDK utiliza la variable Adobe I/O puerta de enlace para la autenticación. Para realizar llamadas de API a extremos de Destination SDK, debe proporcionar ciertos encabezados en las llamadas de API. Trabaje con el equipo de Adobe Exchange para configurar la autenticación para usted en el Adobe Developer Console.

Para realizar llamadas correctamente a puntos finales de API de Destination SDK, siga la tutorial de autenticación de Experience Platform. Inicie el tutorial desde el "Generar una clave de API, el ID de organización de IMS y el secreto del cliente". El equipo de Adobe Exchange se encargará de los pasos anteriores. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en las llamadas a la API de Destination SDK, como se muestra a continuación:

  • x-api-key: {API_KEY}, también denominado ID de cliente
  • x-gw-ims-org-id: {IMS_ORG}, también denominado ID de organización
  • Authorization: Bearer {ACCESS_TOKEN}. El token de acceso tiene una caducidad de 24 horas, expresada en milisegundos, por lo que tendrá que actualizarlo. Para actualizar el token de acceso, repita los pasos descritos en el tutorial de autenticación.

Propiedad de destino y entornos limitados

Todos los recursos del Experience Platform están aislados en entornos limitados virtuales específicos. Las solicitudes para Destination SDK requieren encabezados que especifiquen el nombre del simulador para pruebas en el que se realiza la operación:

  • x-sandbox-name: {SANDBOX_NAME}

El equipo de Adobe Exchange le proporciona su nombre de simulador de pruebas, que debe utilizar en llamadas a puntos finales de API de Destination SDK.

Control de acceso basado en roles (RBAC)

Para utilizar los extremos de la API de Destination SDK descritos en la sección documentación de referencia, necesita el Creación de destinos permiso de control de acceso. Trabaje con el equipo de Adobe Exchange para obtener este permiso asignado en Adobe Admin Console.

Permiso de creación de destino

Para obtener más información, lea los siguientes documentos de Control de acceso del Experience Platform:

Consideraciones adicionales

  • Cualquier cambio que realice en las configuraciones de destino, tanto si crea como si edita una configuración de destino, debe revisarse y aprobarse por Adobe. Los cambios solo se reflejan en los destinos una vez que se haya realizado la revisión.
  • Solo los usuarios que pertenecen a la misma organización y tienen acceso al simulador para pruebas pueden editar la configuración de destino.

Pasos siguientes

Al seguir los pasos de este artículo, obtuvo las credenciales de autenticación en Adobe I/O, un nombre de simulador de pruebas y el permiso de control de acceso de creación de destino. A continuación, puede configurar un destino con Destination SDK.

En esta página