Configuración de un proyecto de Adobe Developer Console configure-adc-project

Para llamar a la API de servicios de inteligencia artificial aplicada al contenido de AEM, necesita las credenciales emitidas por un proyecto de Adobe Developer Console (ADC). Esta página le explica cómo crear el proyecto, seleccionar un método de autenticación y generar las credenciales que incluye con cada solicitud de API.

Vaya a Adobe Developer Console para que su organización comience.

Requisitos previos prerequisites

Antes de empezar, asegúrese de lo siguiente:

  • Tiene acceso a Adobe Developer Console para su organización.
  • Se le ha agregado como Desarrollador en el perfil de producto de los servicios de inteligencia artificial aplicada al contenido de AEM en Adobe Admin Console. Sin esta función, la tarjeta de API AEM Content AI Services aparece deshabilitada y la opción de autenticación Servidor a servidor está oculta.
  • Conoce los números de programa y entorno del perfil de producto que desea seleccionar (por ejemplo, AEM User - publish - Program 12345 - Environment 67890).
  • Usted tiene el rol de Administrador del sistema en Admin Console para el programa. Esta función le permite administrar perfiles de producto y asignar usuarios al entorno.

Elegir un método de autenticación choose-auth

Los servicios de inteligencia artificial aplicada al contenido de AEM admiten dos métodos de autenticación. Elija el que coincida con su integración:

Método
Ideal para
Servidor a servidor
Servicios back-end que llaman a la API sin interacción del usuario. Devuelve un token de acceso de corta duración.
Clave API
Integraciones del lado del cliente o basadas en explorador que llaman directamente a la API de. Devuelve una clave de larga duración con ámbitos de dominios permitidos.

Autenticación de servidor a servidor s2s-auth

  1. Seleccione API y servicios, luego API.

    Developer Console muestra API y servicios

  2. Filtre por Servicios de inteligencia artificial aplicada al contenido de AEM y, a continuación, seleccione Crear proyecto para iniciar un nuevo proyecto o Agregar API si agrega el servicio a un proyecto existente.

    note
    NOTE
    Si la tarjeta API está deshabilitada con el mensaje "Se requiere licencia", es posible que el entorno de AEM as a Cloud Service no se actualice. Consulte Modernización del entorno de AEM as a Cloud Service.
  3. En el cuadro de diálogo Configurar API, seleccione la autenticación de servidor a servidor.

    Cuadro de diálogo Configurar API con selección de servidor a servidor

    note tip
    TIP
    Si la opción Servidor a servidor no está disponible, el usuario que configura la integración no se agrega como Desarrollador al Perfil del producto. Consulte Habilitar la autenticación de servidor a servidor.
  4. Si es necesario, cambie el nombre de la credencial. Seleccione Siguiente.

    Paso de Adobe Developer Console para cambiar el nombre de la nueva credencial de servidor a servidor antes de seleccionar Siguiente

  5. Seleccione el perfil de producto Usuario de AEM - publicar - Programa XXX - Entorno XXX y/o Usuario de AEM - autor - Programa XXX - Entorno XXX y, a continuación, seleccione Guardar.

    Selector de perfil de producto que muestra los perfiles de publicación y creación de usuarios de AEM para el programa y el entorno de destino

  6. Revise la configuración de la API y la autenticación.

    Pantalla de revisión que resume la API, el tipo de autenticación y el nombre de credencial seleccionados

    Revise los detalles de pantalla que muestran los perfiles de producto asignados para la credencial

Generar un token de acceso generate-token

  1. En su proyecto ADC, vaya a Credenciales y seleccione Generar token de acceso.

    Página de credenciales con el botón Generar token de acceso resaltado

  2. Incluya el token en el encabezado Authorization de cada solicitud de API:

    code language-http
    Authorization: Bearer YOUR_ACCESS_TOKEN
    
    note warning
    WARNING
    Guarde el token de forma segura. Caduca y debe regenerarse periódicamente.

Autenticación de clave API api-key-auth

  1. Al agregar la API de AEM Content AI Services a su proyecto, seleccione Clave de API en el cuadro de diálogo Seleccionar tipo de autenticación.

    Seleccionar tipo de autenticación de clave API

  2. Confirme la credencial de la clave API.

    Agregar credencial de clave API

  3. Para restringir qué orígenes pueden utilizar la clave, configure los dominios permitidos.

    Configurar dominios permitidos

  4. Su clave API (ID de cliente) aparece en Credenciales conectadas. Seleccione Copiar.

    Copiar clave API de las credenciales conectadas

  5. Incluya la clave en cada solicitud de API:

    code language-http
    x-api-key: YOUR_API_KEY
    

    El proyecto ya está listo. Utilice la clave con cada solicitud a los servicios de IA de contenido de AEM.

Próximos pasos next-steps

recommendation-more-help
experience-manager-content-ai-help-content-ai