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 la Glosario del Experience Platform para obtener definiciones de estos y otros términos.
Obtener las credenciales de autenticación requeridas obtain-authentication-credentials
El Destination SDK utiliza el Adobe I/O puerta de enlace para 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 intercambio de Adobe para configurar la autenticación en el Consola de Adobe Developer.
Para realizar llamadas correctamente a los extremos de la API de Destination SDK, siga las tutorial de autenticación de Experience Platform. Inicie el tutorial desde el "Generar una clave de API, un ID de organización y un secreto de cliente" paso. El equipo de intercambio de Adobe 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 sección documentación de referencia, necesita el Creación de destino permiso de control de acceso. Trabaje con el equipo de intercambio de Adobe 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 API de creación de destino.
-
Utilice el Colección 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, consulte las pasos para importar entornos y colecciones y una guía de vídeo para crear el entorno de Postman.