DocumentaciónAEM as a Cloud ServiceGuía del usuario

[AEM Forms]{class="badge positive" title="Applies to AEM Forms)."}

OAuth Server-to-Server Authentication

Last update: Fri Apr 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Administrador
  • Desarrollador
  • Usuario

OAuth Server-to-Server Authentication allows secure, token-based access to AEM Forms Communications APIs without requiring user interaction. OAuth server-to-server authentication is supported by Adobe Developer Console.

Requisitos previos

Before you begin, make sure the following prerequisites are met:

How to Generate an Access Token Using OAuth Server-to-Server Authentication?

Follow the steps below to generate an access token from the Adobe Developer console, and make your first API call through OAuth Server-to-Server Authentication.

1. Adobe Developer Console Project Setup

  1. Navigate to Adobe Developer Console

  2. Log in with your Adobe ID

  3. Create New Project or navigate to your existing project

To create a new project

  1. From the Quick Start section, click Create new project

  2. A new project is created with a default name

    Create ADC Project

  3. Click Edit project in the top right corner

    Edit Project

  4. Provide a meaningful name (e.g., "formsproject")

  5. Haga clic en Guardar.

    Edit Project Name

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

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