Autenticación de servidor a servidor OAuth

La autenticación de servidor a servidor OAuth permite un acceso seguro y basado en tokens a las API de comunicaciones de AEM Forms sin que sea necesaria la interacción del usuario. Adobe Developer Console admite la autenticación de servidor a servidor OAuth.

Requisitos previos

Antes de empezar, asegúrese de que se cumplen los siguientes requisitos previos:

Cómo generar un token de acceso mediante la autenticación de servidor a servidor OAuth

Siga los pasos a continuación para generar un token de acceso desde la consola de Adobe Developer y realizar la primera llamada de API mediante la autenticación de servidor a servidor OAuth.

​1. Configuración del proyecto Adobe Developer Console

  1. Vaya a Adobe Developer Console

  2. Inicie sesión con su Adobe ID

  3. Cree un nuevo proyecto o vaya al proyecto existente

Para crear un nuevo proyecto
  1. En la sección Inicio rápido, haga clic en Crear nuevo proyecto

  2. Se crea un nuevo proyecto con un nombre predeterminado

    Crear proyecto ADC

  3. Haga clic en Editar proyecto en la esquina superior derecha

    Editar proyecto

  4. Proporcione un nombre significativo (por ejemplo, "formsproject")

  5. Haga clic en Guardar.

    Editar nombre de proyecto

Para navegar a su proyecto existente
  1. Haga clic en Todos los proyectos desde Adobe Developer Console

    Buscar proyectos

  2. Busque el proyecto y haga clic en para abrirlo.

    Localizar proyectos

​2. Añadir API de Forms

Agregue las API de Forms en función de lo que desee hacer:

  • API de comunicaciones de AEM Forms: utilícelas cuando necesite generar, convertir, ensamblar o proteger documentos (PDF y formatos relacionados).
  • API de tiempo de ejecución de Forms adaptable: utilícelas cuando necesite procesar, enviar o procesar Forms adaptable durante la ejecución.
Para las API de comunicaciones de AEM Forms
  1. Haga clic en Agregar API

    Agregar API

  2. Seleccionar API de comunicación de Forms

    1. En el cuadro de diálogo Agregar API, filtrar por Experience Cloud

    2. Seleccione "API de comunicación de Forms"

      Agregar API de comunicación de Forms

    3. Haga clic en Siguiente

    4. Seleccione el método de autenticación OAuth Server-to-Server

      Seleccionar método de autenticación

Para las API de tiempo de ejecución de Forms adaptables
  1. Haga clic en Agregar API

    Agregar API

  2. Seleccionar API de tiempo de ejecución y entrega de AEM Forms

    1. En el cuadro de diálogo Agregar API, filtrar por Experience Cloud

    2. Seleccione "API de tiempo de ejecución y entrega de AEM Forms"
      Agregar API de comunicación de Forms

    3. Haga clic en Siguiente

    4. Seleccione el método de autenticación OAuth Server-to-Server.
      Seleccionar método de autenticación

También puede agregar la API y el método de autenticación a su proyecto existente haciendo clic en Agregar al proyecto > API
Agregar API al proyecto existente

​3. Añadir perfil de producto

El perfil de producto proporciona permisos (o autorización) para que las credenciales accedan a los recursos de AEM.

  1. Seleccione el perfil de producto que coincida con la dirección URL de la instancia de AEM (https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com).

    • Tipo de servicio: especifica servicios o permisos asociados con la instancia de AEM

    • Tipo de entorno: especifica si el entorno es para el servicio de creación o publicación

    • Programa XXX - identifica el ID del programa de Cloud Manager

    • Entorno XXX - identifica el ID de entorno específico dentro de ese programa

    note note
    NOTE
    Los perfiles de producto están vinculados a una instancia de AEM específica (programa + entorno). Elija siempre el perfil que coincida con la dirección URL de su instancia.
  2. Haga clic en Guardar API configurada. La API y el perfil de producto se añaden al proyecto

    Seleccionar configuración del proyecto

​4. Generar y guardar credenciales

  1. Vaya al proyecto en Adobe Developer Console

  2. Haga clic en la credencial OAuth Server-to-Server

  3. Ver la sección Detalles de credenciales

    Ver credenciales

Registrar credenciales de API

    API Credentials:
    ================
    Client ID: <your_client_id>
    Client Secret: <your_client_secret>
    Technical Account ID: <tech_account_id>
    Organization ID: <org_id>
    Scopes: AdobeID,openid,read_organizations

​5. Generación de token de acceso

Genere el token de acceso manualmente o mediante programación:

Para Pruebas

Genere los tokens de acceso manualmente en Adobe Developer Console:

  1. Vaya a su proyecto

    1. En Adobe Developer Console, abra el proyecto
    2. Haga clic en Servidor a servidor de OAuth
  2. Generar token de acceso

    1. Haga clic en el botón "Generar token de acceso" en la sección de API del proyecto
    2. Copiar el token de acceso generado

    Generar token de acceso

    note note
    NOTE
    El token de acceso es válido solamente por 24 horas
Para Producción

Generar tokens mediante programación usando la API Adobe IMS:

Credenciales requeridas:

  • ID del cliente
  • Secreto de cliente
  • Ámbitos (normalmente: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Extremo de token:

code language-none
https://ims-na1.adobelogin.com/ims/token/v3

Solicitud de ejemplo (curl):

code language-bash
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<YOUR_CLIENT_ID>' \
-d 'client_secret=<YOUR_CLIENT_SECRET>' \
-d 'scope=AdobeID,openid,read_organizations'

Respuesta:

code language-json
    {
    "access_token": "eyJhbGciOiJSUz...",
    "token_type": "bearer",
    "expires_in": 86399
    }

Ahora puede utilizar el token de acceso generado para hacer una llamada de API a entornos de desarrollo, fase o producción.

Prácticas recomendadas: Administrar credenciales para desarrollo, ensayo y producción

  • Utilice siempre credenciales independientes para desarrollo, ensayo y producción.

  • Asigne cada credencial a la URL de entorno de AEM correcta.

  • Almacene los secretos de forma segura y nunca los comprometa con el control de código fuente.

  • Rastree la validez del token de acceso, ya que los tokens solo son válidos durante 24 horas.

Próximos pasos

Para obtener información sobre cómo configurar el entorno para las API de comunicación sincrónica de Forms, consulte Procesamiento sincrónico de comunicaciones de AEM Forms as a Cloud Service.

Artículos relacionados

Obtenga información sobre cómo establecer el entorno para las API de comunicaciones de Forms sincrónicas (bajo demanda) y asincrónicas (por lotes):

API sincrónicas

API de comunicaciones de AEM Forms: sincrónicas

Aprenda a configurar un entorno para las API de comunicaciones de Forms sincrónicas (bajo demanda) que generan o procesan documentos al instante.

Más información

API asíncronas

API de comunicaciones de AEM Forms: asincrónicas (por lotes)

Aprenda a configurar el entorno para las API de comunicaciones de Forms asincrónicas (por lotes) que generan o procesan varios documentos de forma programada.

Más información

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab