Configurar la autenticación para las API de Adobe Target

En Adobe Admin Console, asegúrese de que su cuenta de usuario Adobe tenga acceso de nivel Administrador de productos y Desarrollador a Target.

En Adobe Developer Console, seleccione el Experience Cloud Organization para el que desea crear esta integración. (Tenga en cuenta que es probable que solo tenga acceso a un(a) Experience Cloud Organization.)

Haga clic en Create new project.

Haga clic en Add API para agregar una API de REST a su proyecto y poder acceder a los servicios y productos de Adobe.

Seleccione Adobe Target como el servicio Adobe con el que desea integrar. Haga clic en el botón Next que aparece.

Seleccione una opción para asociar claves públicas y privadas con la integración de cuenta de servicio que está creando para Target. Para este ejemplo, seleccione Option 1: Generate a key pair y haga clic en Generate keypair.

Según las instrucciones, anote el archivo de configuración descargado automáticamente (config), que contiene su clave privada. Haga clic en Next.

En su sistema de archivos, compruebe la ubicación de config, que es el archivo de configuración comprimido creado en el paso anterior. De nuevo, este archivo de config 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í.

De nuevo en Adobe Developer Console, seleccione los perfiles de producto correspondientes a las propiedades en las que está usando Adobe Recommendations. (Si no utiliza las propiedades, seleccione la opción Workspace predeterminado.) Haga clic en Save configured API.

Haga clic en Create Integration. Debería recibir un mensaje temporal que indique que su API se ha configurado correctamente.

Finalmente, cambie el nombre del proyecto a un nombre más significativo que el original Project 1. Para ello, navegue hasta el proyecto utilizando la ruta de navegación como se muestra, haga clic en Edit project para acceder al modal Edit Project y cambie el nombre del proyecto.

Aún en Adobe Developer Console, vaya a ver las credenciales de Service Account (JWT) de su nuevo proyecto. Utilice la navegación izquierda o la sección Credentials como se muestra.

En Credential details, tenga en cuenta que puede ver su Public key(s), Client ID y otra información relacionada con su cuenta de servicio.

Haga clic para ir a la información sobre la API Adobe Target. Utilice la sección de navegación izquierda o la sección Productos y servicios conectados como se muestra a continuación.

Haga clic en Download for Postman > Service Account (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 Import para importar el archivo JSON (entorno).

Elija su archivo y haga clic en Open.

En el modal Postman Administrar entornos, 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 tiene que coincidir necesariamente con el nombre del proyecto Adobe).

Nota CLIENT_SECRET y API_KEY (junto con otras variables) tienen sus valores rellenados previamente, tomados de la integración tal como se define en Adobe Developer Console. (La variable de Postman CLIENT_SECRET debe coincidir con la credencial de Adobe CLIENT SECRET tal como se muestra en Developer Console, y API_KEY en Postman debe coincidir del mismo modo con CLIENT ID en Developer Console). Por el contrario, las notas PRIVATE_KEY, JWT_TOKEN y ACCESS_TOKEN están en blanco. Empecemos por proporcionar el valor PRIVATE_KEY.

En el sistema de archivos, abra el archivo de config y abra el archivo de clave private.

Seleccione y copie todo el contenido del archivo de clave private.

En Postman, pegue el valor de clave privada en los campos INITIAL VALUE y CURRENT VALUE.

Haga clic en Update y cierre el modal Entornos.

Vaya a Llamadas de ejemplo a la API del servicio Identity Management de Adobe.

Haga clic en Adobe I/O Access Token Generation Postman collection.

Obtenga el JSON sin procesar de esta colección haciendo clic en Raw y copiando 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 Continue.

Seleccione la solicitud IMS: JWT Generate + Auth via User Token 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 Send para generar el token.

Abra de nuevo el modal Administrar entornos y seleccione su entorno.

Tenga en cuenta que los valores ACCESS_TOKEN y JWT_TOKEN se han rellenado.

Importe la Adobe Target colección Postman de API de administrador. Siga todas las indicaciones hasta que la colección se importe en Postman.

Expanda la colección y anote la solicitud List activities.

Tenga en cuenta que variables como {{access_token}} no se han resuelto inicialmente. Puede resolver esto de varias formas (por ejemplo, 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}}. La nota {{TENANT_ID}} aún no se reconoce.

Abra el modal Administrar entornos y seleccione su entorno.

Escriba para agregar una nueva variable de entorno {{TENANT_ID}}. Copie y pegue su valor de ID de inquilino en los campos INITIAL VALUE y CURRENT VALUE para la nueva variable de entorno TENANT_ID.

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.