Configuración de la autenticación para Adobe Target API
El Adobe Target Las API de administrador, que incluyen Recommendations Admin Las API de están protegidas con autenticación para garantizar que solo los usuarios autorizados las utilicen para acceder a Adobe Target. Utilice el Consola de Adobe Developer para administrar esta autenticación para todos Adobe Experience Cloud solutions, incluido Adobe Target.
Estos son los pasos preliminares necesarios para generar los tokens de autenticación JWT heredados necesarios para interactuar correctamente con Adobe Target API:
- Cree un proyecto (anteriormente denominado integración) en Adobe Developer Console.
- Exporte los detalles del proyecto a Postman.
- Genere un token de acceso de portador.
- Pruebe el token de acceso al portador.
Requisitos previos
En el resto de esta guía se da por hecho que está familiarizado con los siguientes recursos:
Creación de un proyecto de Adobe I/O
En esta sección, accederá a las Adobe Developer Console y cree un proyecto para Adobe Target. Para obtener más información, consulte documentación sobre proyectos.
<!—(1. Genere su clave privada y certificado público, según el documentación sobre autenticación. // [//]: # (como se describe en Paso 1 de Cómo configurar la E/S de Adobe: autenticación: paso a paso. Después de completar el paso 1, vuelva a esta guía y reanude el paso 2 que aparece a continuación. // El resultado de esta etapa debe ser la creación de un private.key
archivo y a certificate_pub.crt
archivo. Vuelva a esta guía una vez que haya generado estos dos archivos.)—>
-
En el Adobe Admin Console, asegúrese de que Adobe La cuenta de usuario de se ha concedido tanto Administrador de productos y Desarrollador acceso de nivel a Target.
-
En el Consola de Adobe Developer, seleccione la Organización Experience Cloud para el que desea crear esta integración. (Tenga en cuenta que es probable que solo tenga acceso a un único Organización Experience Cloud.)
-
Clic Crear nuevo proyecto.
-
Clic Añadir API para agregar una API de REST al proyecto para acceder a Adobe servicios y productos.
-
Seleccionar Adobe Target como el Adobe servicio con el que desea integrar. Haga clic en Siguiente botón que aparece.
-
Seleccione una opción para asociar claves públicas y privadas con la integración de cuentas de servicio que está creando para Target. Para este ejemplo, seleccione Opción 1: generar un par de claves y haga clic en Generar par de claves.
-
Según las instrucciones, tome nota del archivo de configuración descargado automáticamente (
config
), que contiene su clave privada. Haga clic en Siguiente. -
En el sistema de archivos, compruebe la ubicación de
config
, que es el archivo de configuración comprimido creado en el paso anterior. De nuevo, estoconfig
contiene su clave privada, que necesitará más adelante. La ubicación exacta dentro del sistema de archivos puede diferir de la que se muestra aquí. -
Vuelva a la consola de Adobe Developer y seleccione. perfil(es) de producto correspondiente a las propiedades en las que utiliza Adobe Recommendations. (Si no utiliza las propiedades, seleccione la opción Espacio de trabajo predeterminado.) Clic Guardar API configurada.
-
Clic Crear integración. Debería recibir un mensaje temporal que indique que su API se ha configurado correctamente.
-
Finalmente, cambie el nombre del proyecto por uno más significativo que el original
Project 1
. Para ello, vaya al proyecto utilizando la ruta de navegación como se muestra y haga clic en Editar proyecto para acceder a Editar proyecto modal y cambie el nombre del proyecto.
Exportar detalles del proyecto
Ahora que tiene un proyecto de Adobe que puede utilizar para acceder a Target, debe asegurarse de enviar los detalles de ese proyecto junto con sus solicitudes de API de Adobe. Estos detalles son necesarios para interactuar con varias API de Adobe, incluidas varias Target API. Por ejemplo, los detalles de la integración incluyen la información de autorización y autenticación requerida por el Target API de administrador. Por lo tanto, para utilizar las API con Postman, debe introducir esos detalles en Postman.
Existen muchas formas de especificar los detalles del proyecto en Postman, pero en esta sección, aprovechamos algunas funciones y colecciones creadas previamente. En primer lugar (en esta sección), exportará los detalles de su integración a un entorno de Postman. A continuación (en la siguiente sección), se genera un token de acceso al portador para concederle acceso a los recursos de Adobe necesarios.
-
Todavía en el Consola de Adobe Developer, navegue hasta ver el de su nuevo proyecto Cuenta de servicio (JWT) credenciales. Utilice la navegación izquierda o la Credenciales como se muestra.
Entrada Detalles de credenciales, tenga en cuenta que puede ver su Clave(s) pública(es), ID de cliente y otra información relacionada con su cuenta de servicio.
-
Haga clic aquí para desplazarse a la información acerca de Adobe Target API. Utilice la navegación izquierda o la Productos y servicios conectados como se muestra.
-
Clic Descargar para Postman > Cuenta de servicio (JWT) para crear un archivo JSON que capture la información de autenticación para un entorno de Postman.
Anote el archivo JSON en su sistema de archivos.
-
En Postman, haga clic en el icono de engranaje para administrar los entornos y, a continuación, haga clic en Importar para importar el archivo JSON (entorno).
-
Seleccione el archivo y haga clic en Abrir.
-
En Postman Administrar entornos modal, haga clic en el nombre del entorno recién importado para inspeccionarlo. (El nombre de su entorno puede ser diferente del que se muestra aquí. Edite el nombre como desee. No necesariamente tiene que coincidir con el nombre del Adobe proyecto.)
-
Nota
CLIENT_SECRET
yAPI_KEY
(junto con otras variables) tienen sus valores rellenados previamente, tomados de la integración tal como se define en la consola de Adobe Developer. (El PostmanCLIENT_SECRET
debe coincidir con el valor deCLIENT SECRET
credenciales de Adobe tal como se muestran en Developer Console, yAPI_KEY
en Postman debe coincidir del mismo modoCLIENT ID
en Developer Console). Por el contrario, anotePRIVATE_KEY
,JWT_TOKEN
, yACCESS_TOKEN
están en blanco. Empecemos por proporcionar lo siguientePRIVATE_KEY
valor. -
En el sistema de archivos, abra
config
y abra el archivo.private
archivo de clave. -
Seleccione y copie todo el contenido del
private
archivo de clave. -
En Postman, pegue el valor de clave privada en VALOR INICIAL y VALOR ACTUAL campos.
-
Clic Actualizar y cierre el modal Environments.
Generar el token de acceso al portador
En esta sección, se genera el token de acceso al portador, que es necesario para autenticar la interacción con Adobe Target API. Para generar el token de acceso de portador, debe enviar los detalles de la integración (establecidos en las secciones anteriores) a Adobe Servicio de Identity Management (IMS). Hay varias formas de hacerlo, pero en esta guía aprovechamos una colección de Postman que contiene una llamada de IMS prediseñada que hace que el proceso sea directo y fácil. Una vez importada la colección, puede volver a utilizarla cuando sea necesario para generar nuevos tokens, no solo para Adobe Target, pero también otras API de Adobe.
-
Vaya a Llamadas de muestra de API del servicio Identity Management de Adobe.
-
Haga clic en Adobe I/O Acceso Generación de tokens Colección Postman.
-
Obtenga el JSON sin procesar de esta colección haciendo clic en Raw y, a continuación, copie el JSON resultante en el portapapeles. (Como alternativa, puede guardar el JSON sin procesar como archivo .json).
-
En Postman, importe la colección pegando y enviando el JSON sin procesar desde el portapapeles. (Como alternativa, puede cargar el archivo .json que ha guardado). Haga clic en Continuar.
-
Seleccione el IMS: JWT Generate + Auth mediante token de usuario en la colección Postman de generación de tokens de acceso a Adobe I/O, asegúrese de que su entorno esté seleccionado y haga clic en Enviar para generar el token.
note note NOTE Este token de acceso al portador será válido durante 24 horas. Vuelva a enviar la solicitud siempre que necesite generar un nuevo token. -
Abra de nuevo el modal Administrar entornos y seleccione su entorno.
-
Tenga en cuenta
ACCESS_TOKEN
yJWT_TOKEN
Los valores de ahora se rellenan.
Pregunta: ¿Tengo que usar la colección Postman de generación de tokens de acceso a Adobe I/O para generar el token web JSON (JWT) y el token de acceso al portador?
Respuesta: No. La colección de Postman de generación de tokens de acceso a Adobe I/O está disponible para facilitar la generación del token de acceso al portador y JWT en Postman. También puede utilizar las funcionalidades de la consola de Adobe Developer para generar manualmente el token de acceso del portador.
Prueba del token de acceso al portador
En este ejercicio, utilizará el nuevo token de acceso al portador enviando una solicitud de API que recupera una lista de actividades de su Target cuenta. Una respuesta correcta indica su Adobe El proyecto y la autenticación funcionan según lo esperado para utilizar la API.
-
Importe el Adobe Target Recopilación de Postman de API de administrador. Siga todas las indicaciones hasta que la colección se importe en Postman.
-
Expanda la colección y observe la Enumerar actividades solicitud.
-
Tenga en cuenta que las variables como
{{access_token}}
no se han resuelto inicialmente. Esto se puede resolver de varias formas diferentes; por ejemplo, se puede definir una nueva variable de colección llamada{{access_token}}
—pero en esta guía, cambiará la solicitud de API para aprovechar el entorno de Postman que estaba utilizando anteriormente. Esto permitirá que el entorno siga funcionando como una única consolidación coherente de todas las variables comunes en las API de Adobe. -
Escriba para reemplazar
{{access_token}}
con{{ACCESS_TOKEN}}
. -
Escriba para reemplazar
{{api_key}}
con{{API_KEY}}
. -
Escriba para reemplazar
{{tenant}}
con{{TENANT_ID}}
. Nota{{TENANT_ID}}
aún no se reconoce. -
Abra el modal Administrar entornos y seleccione su entorno.
-
Escriba para añadir una nueva
{{TENANT_ID}}
variable de entorno. Copie y pegue su valor de ID de inquilino en VALOR INICIAL y VALOR ACTUAL campos para el nuevoTENANT_ID
variable de entorno.note note NOTE El ID de inquilino es diferente al de Target clientcode
. El ID de inquilino existe en la dirección URL cuando inicia sesión en Target. Para obtener su ID de inquilino, inicie sesión en Adobe Experience Cloud y abra Targety haga clic en la tarjeta Target. Utilice el valor ID de inquilino como se indica en el subdominio URL. Por ejemplo, si su dirección URL al iniciar sesión en Adobe Target es<https://mycompany.experiencecloud.adobe.com/...>
a continuación, su ID de inquilino es "mycompany". -
Envíe la solicitud, después de asegurarse de que ha seleccionado el entorno correcto. Debe recibir una respuesta que contenga su lista de actividades.
Ahora que ha comprobado la autenticación de Adobe, puede utilizarla para interactuar con Adobe Target API (así como otras API de Adobe). Por ejemplo, puede Uso de API de Recommendations para crear o administrar recomendaciones, o puede utilizarlo con el API de envío de Target.