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 términos. Consulte el glosario de Destination SDK para ver los términos relacionados directamente con esta funcionalidad.
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 clientex-gw-ims-org-id: {ORG_ID}, también denominado ID de organizaciónAuthorization: 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.
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.
-
Lea las siguientes guías de configuración, según el tipo de destino:
-
Para todas las operaciones, consulte la documentación de la API de creación de destino.
-
Use la colección de Postman de la API de creación de destino para configurar el destino mediante los extremos de la API de Destination SDK. Para empezar a usar Postman, vea los pasos para importar entornos y colecciones y una guía de vídeo para crear el entorno de Postman.