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.

IMPORTANT
Las credenciales de la cuenta de servicio (JWT) descritas en este artículo quedarán obsoletas en favor de las nuevas credenciales de servidor a servidor de OAuth.
Las credenciales de la cuenta de servicio (JWT) seguirán funcionando hasta el 1 de enero de 2025. Debe migrar la aplicación o integración para utilizar la nueva credencial de servidor a servidor OAuth antes del 1 de enero de 2025.
Para obtener más información e instrucciones paso a paso para migrar su integración, consulte Migración de la credencial de cuenta de servicio (JWT) a la credencial de servidor a servidor OAuth en el Developer Console documentación.
Para obtener información sobre cómo configurar nuevas credenciales de OAuth, consulte Implementación de credenciales de servidor a servidor OAuth en el Developer Console documentación.

Estos son los pasos preliminares necesarios para generar los tokens de autenticación JWT heredados necesarios para interactuar correctamente con Adobe Target API:

  1. Cree un proyecto (anteriormente denominado integración) en Adobe Developer Console.
  2. Exporte los detalles del proyecto a Postman.
  3. Genere un token de acceso de portador.
  4. Pruebe el token de acceso al portador.

Requisitos previos

Recurso
Detalles
Postman
Para completar estos pasos correctamente, obtenga el aplicación de Postman para su sistema operativo. Postman basic es gratuito con la creación de cuentas. Aunque no es necesario para utilizar Adobe Target API en general, Postman facilita los flujos de trabajo de las API y Adobe Target proporciona varias colecciones Postman para ayudarle a ejecutar sus API y aprender cómo funcionan. El resto de esta guía supone conocimientos prácticos de Postman. Si necesita 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, 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.)—>

  1. 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.

  2. 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.)

    configure-io-target-createproject2.png

  3. Clic Crear nuevo proyecto.

    configure-io-target-createproject3.png

  4. Clic Añadir API para agregar una API de REST al proyecto para acceder a Adobe servicios y productos.

    Añadir API

  5. Seleccionar Adobe Target como el Adobe servicio con el que desea integrar. Haga clic en Siguiente botón que aparece.

    configure-io-target-createproject5

  6. 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.

    configure-io-target-createproject6

  7. Según las instrucciones, tome nota del archivo de configuración descargado automáticamente (config), que contiene su clave privada. Haga clic en Siguiente.

    configure-io-target-createproject7

  8. 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, esto 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í.

    configure-io-target-createproject8

  9. 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.

    configure-io-target-createproject9

  10. Clic Crear integración. Debería recibir un mensaje temporal que indique que su API se ha configurado correctamente.

  11. 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.

    configure-io-target-createproject11

NOTE
En este ejemplo, damos el nombre a nuestro proyecto "Target Integración". Si prevé utilizar el proyecto para algo más que Adobe Target, tal vez desee ponerle el nombre correspondiente. Por ejemplo, puede elegir llamarlo "API de Adobe" o "API de Experience Cloud", ya que puede utilizarse con otras soluciones en Adobe Experience Cloud.

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.

NOTE
Para instrucciones de vídeo aplicables a cualquier solución de Experience Cloud, incluyendo Target, consulte Uso de Postman con API de Experience Platform. Las siguientes secciones son relevantes para la Target API: 1. Cree y exporte la API de Experience Platform a Postman 2. Genere un token de acceso con Postman. Estos pasos también se proporcionan a continuación.
  1. 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.

    JWT1

    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.

    JWT1a

  2. 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.

    JWT2

  3. 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.

    JWT3

    Anote el archivo JSON en su sistema de archivos.

    JWT3a

  4. 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).

    JWT4

  5. Seleccione el archivo y haga clic en Abrir.

    JWT5

  6. 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.)

    JWT6

  7. 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 la consola de Adobe Developer. (El Postman CLIENT_SECRET debe coincidir con el valor de CLIENT SECRET credenciales de Adobe tal como se muestran en Developer Console, y API_KEY en Postman debe coincidir del mismo modo CLIENT ID en Developer Console). Por el contrario, anote PRIVATE_KEY, JWT_TOKEN, y ACCESS_TOKEN están en blanco. Empecemos por proporcionar lo siguiente PRIVATE_KEY valor.

    JWT7

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

    JWT8

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

    JWT9

  10. En Postman, pegue el valor de clave privada en VALOR INICIAL y VALOR ACTUAL campos.

    JWT10

  11. 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.

  1. Vaya a Llamadas de muestra de API del servicio Identity Management de Adobe.

    token1

  2. Haga clic en Adobe I/O Acceso Generación de tokens Colección Postman.

    token2

  3. 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).

    token3

  4. 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.

    token4

  5. 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.

    token5

    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.
  6. Abra de nuevo el modal Administrar entornos y seleccione su entorno.

    token6

  7. Tenga en cuenta ACCESS_TOKEN y JWT_TOKEN Los valores de ahora se rellenan.

    token7

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.

  1. 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.

    testtoken1

  2. Expanda la colección y observe la Enumerar actividades solicitud.

    testtoken1

  3. 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.

    testtoken2

  4. Escriba para reemplazar {{access_token}} con {{ACCESS_TOKEN}}.

    testtoken3

  5. Escriba para reemplazar {{api_key}} con {{API_KEY}}.

    testtoken4

  6. Escriba para reemplazar {{tenant}} con {{TENANT_ID}}. Nota {{TENANT_ID}} aún no se reconoce.

    testtoken4

  7. Abra el modal Administrar entornos y seleccione su entorno.

    JWT11

  8. 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 nuevo TENANT_ID variable de entorno.

    testtoken5

    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".
  9. 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.

    testtoken6

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.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3