Configurar la autenticación para las API de Adobe Target
Las API de administrador de Adobe Target, incluidas las API de Recommendations Admin, están protegidas con autenticación para garantizar que solo los usuarios autorizados las usen para acceder a Adobe Target. Use Adobe Developer Console para administrar esta autenticación en todos los Adobe Experience Cloud solutions, incluido Adobe Target.
IMPORTANTEstos son los pasos preliminares necesarios para generar los tokens de autenticación JWT heredados necesarios para interactuar correctamente con las API Adobe Target:
- 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
| Recurso | Detalles |
|---|---|
| Postman | Para completar estos pasos correctamente, obtiene la aplicación de Postman para tu sistema operativo. Postman basic es gratuito con la creación de cuentas. Aunque no es necesario para usar las API Adobe Target en general, Postman facilita los flujos de trabajo de las API y Adobe Target proporciona varias colecciones de Postman para ayudar a ejecutar sus API y conocer su funcionamiento. El resto de esta guía supone conocimientos prácticos de Postman. Para obtener ayuda, consulte la documentación de Postman. |
| Referencias |
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, tendrá acceso a Adobe Developer Console y creará un proyecto para Adobe Target. Para obtener más información, consulte la documentación sobre proyectos.
<!—(1) Genere su clave privada y certificado público, según la documentación sobre autenticación. //[/]: # (como se describe en el 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 este paso debe ser la creación de un archivo private.key y un archivo certificate_pub.crt. Vuelva a esta guía una vez que haya generado estos dos archivos.)—>
-
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 deconfigcontiene 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.
NOTEExportar detalles del proyecto
Ahora que tiene un proyecto de Adobe que puede usar 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 API de Target. Por ejemplo, los detalles de la integración incluyen la información de autorización y autenticación requerida por las API de administrador de Target. 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.
NOTE-
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_SECRETyAPI_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 PostmanCLIENT_SECRETdebe coincidir con la credencial de AdobeCLIENT SECRETtal como se muestra en Developer Console, yAPI_KEYen Postman debe coincidir del mismo modo conCLIENT IDen Developer Console). Por el contrario, las notasPRIVATE_KEY,JWT_TOKENyACCESS_TOKENestán en blanco. Empecemos por proporcionar el valorPRIVATE_KEY.
-
En el sistema de archivos, abra el archivo de
configy abra el archivo de claveprivate.
-
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.
Generar el token de acceso al portador
En esta sección, genera su token de acceso al portador, que es necesario para autenticar su interacción con las API de Adobe Target. Para generar el token de acceso al portador, debe enviar los detalles de su integración (que se describen en las secciones anteriores) al Servicio Identity Management de Adobe (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 siempre que sea necesario para generar nuevos tokens no solo para Adobe Target, sino también para otras API de Adobe.
-
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.
NOTEEste 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 que los valores
ACCESS_TOKENyJWT_TOKENse han rellenado.
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. Como alternativa, puede utilizar las funcionalidades de Adobe Developer Console para generar manualmente el token de acceso al portador.
