Introducción

Información general overview

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

Terminología terminology

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

Obtener las credenciales de autenticación requeridas obtain-authentication-credentials

El Destination SDK utiliza la puerta de enlace Adobe I/O 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 en Adobe Developer Console.

Para realizar llamadas correctamente a los extremos de la API de Destination SDK, siga el tutorial de autenticación de Experience Platform. Inicie el tutorial desde el paso "Generar una clave de API, ID de organización y secreto de cliente". El equipo de Adobe Exchange se encargará de los pasos anteriores. Al completar el tutorial de autenticación, se proporcionan los valores de cada uno de los encabezados necesarios en las llamadas de 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: {ORG_ID}, también denominado ID de organización
  • Authorization: Bearer {ACCESS_TOKEN}. El token de acceso tiene un tiempo de caducidad de 24 horas, expresado 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 del destino y zonas protegidas destination-ownership

Todos los recursos de Experience Platform están aislados para zonas protegidas virtuales específicas. Las solicitudes al Destination SDK requieren encabezados que especifiquen el nombre de la zona protegida en la que se realiza la operación:

  • x-sandbox-name: {SANDBOX_NAME}

El equipo de Adobe Exchange le proporciona su nombre de zona protegida, que debe utilizar en las llamadas a los extremos de la API de Destination SDK.

Control de acceso basado en roles (RBAC) rbac

Para usar los extremos de la API de Destination SDK descritos en la documentación de referencia, necesita el permiso de control de acceso de Creación de destinos. Trabaje con el equipo de Adobe Exchange para que se le asigne este permiso en Adobe Admin Console.

Permiso de creación de destino

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

Consideraciones adicionales additional-considerations

  • En el caso de los destinos públicos o de producción, cualquier cambio que realice en las configuraciones de destino, tanto si crea o edita una configuración de destino, debe revisarse y aprobarse por Adobe. Los cambios se reflejarán en los destinos solo después de que se haya realizado la revisión. Esto no se aplica a destinos privados que solo están disponibles para usted.
  • Solo los usuarios que pertenecen a la misma organización y tienen acceso a la zona protegida pueden editar la configuración de destino.

Pasos siguientes next-steps

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6