DocumentazioneAEM as a Cloud ServiceGuida utente

[AEM Forms]{class="badge positive" title="Si applica ad AEM Forms)."}

Autenticazione server-to-server OAuth

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

Creato per:

  • Amministratore
  • Sviluppatore
  • Utente

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.

Prerequisiti

Prima di iniziare, accertati di soddisfare i seguenti prerequisiti:

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. Fai clic su Salva

    Edit Project Name

Per passare al progetto esistente

  1. Fai clic su Tutti i progetti da Adobe Developer Console

    Progetti di ricerca

  2. Individua il progetto e fai clic su per aprirlo.

    Individua Progetti

​2. Aggiungere API Forms

Aggiungi API Forms in base a ciò che desideri fare:

  • API di AEM Forms Communications: da utilizzare quando è necessario generare, convertire, assemblare o proteggere documenti (PDF e formati correlati).
  • API Forms Runtime adattive: da utilizzare quando è necessario eseguire il rendering, inviare o elaborare Forms adattivi in fase di esecuzione.
Per le API di comunicazione di AEM Forms

  1. Fai clic su Aggiungi API

    Aggiungi API

  2. Seleziona API di comunicazione Forms

    1. Nella finestra di dialogo Aggiungi API, filtra per Experience Cloud

    2. Seleziona "API di comunicazione Forms"

      Aggiungi API di comunicazione Forms

    3. Fai clic su Avanti

    4. Seleziona il metodo di autenticazione da server a server OAuth

      Seleziona metodo di autenticazione

Per le API runtime di Forms adattivi

  1. Fai clic su Aggiungi API

    Aggiungi API

  2. Seleziona l'API di AEM Forms Delivery e Runtime

    1. Nella finestra di dialogo Aggiungi API, filtra per Experience Cloud

    2. Seleziona "AEM Forms Delivery and Runtime API"
      Aggiungi API di comunicazione Forms

    3. Fai clic su Avanti

    4. Selezionare il metodo di autenticazione da server a server OAuth.
      Seleziona metodo di autenticazione

Puoi anche aggiungere l'API e il metodo di autenticazione al progetto esistente facendo clic su Aggiungi al progetto > API
Aggiungi API al progetto esistente

​3. Aggiungi profilo prodotto

Il profilo di prodotto fornisce le autorizzazioni (o autorizzazioni) per le credenziali di accesso alle risorse di AEM.

  1. Seleziona il profilo prodotto che corrisponde all'URL dell'istanza di AEM (https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com).

    • Tipo di servizio - specifica i servizi o le autorizzazioni associati all'istanza di AEM

    • Tipo di ambiente - specifica se l'ambiente è per il servizio Author o Publish

    • Programma XXX - identifica l'ID del programma Cloud Manager

    • Ambiente XXX - identifica l'ID ambiente specifico all'interno di tale programma

    note note
    NOTE
    I profili di prodotto sono legati a un’istanza AEM specifica (programma + ambiente). Scegli sempre il profilo che corrisponde all’URL dell’istanza.

  2. Fai clic su Salva API configurata. L’API e il profilo di prodotto vengono aggiunti al progetto

    Seleziona configurazione progetto

​4. Generare e salvare le credenziali

  1. Passare al progetto in Adobe Developer Console

  2. Fai clic sulle credenziali da server a server OAuth

  3. Visualizza la sezione Dettagli credenziali

    Visualizza credenziali

Registra credenziali 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. Generazione token di accesso

Genera il token di accesso manualmente o a livello di programmazione:

Per test

Generare manualmente i token di accesso in Adobe Developer Console:

  1. Accedi al progetto

    1. In Adobe Developer Console, apri il progetto
    2. Fai clic su Server-to-Server OAuth

  2. Genera token di accesso

    1. Fai clic sul pulsante "Genera token di accesso" nella sezione API del progetto
    2. Copia il token di accesso generato

    Genera token di accesso

    note note
    NOTE
    Il token di accesso è valido solo per 24 ore
Per La Produzione

Genera i token a livello di programmazione utilizzando l'API Adobe IMS:

Credenziali richieste:

  • ID client
  • Segreto client
  • Ambiti (in genere: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Endpoint token:

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

Richiesta di esempio (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'

Risposta:

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

Ora puoi utilizzare il token di accesso generato per effettuare chiamate API per ambienti di sviluppo, stage o produzione.

Best practice: gestione delle credenziali per lo sviluppo, la gestione temporanea e la produzione

  • Utilizza sempre credenziali separate per Sviluppo, Staging e Produzione.

  • Mappa ciascuna credenziale all’URL dell’ambiente AEM corretto.

  • Archivia i segreti in modo sicuro e non esegui mai il commit nel controllo del codice sorgente.

  • Tieni traccia della validità dei token di accesso, in quanto i token sono validi solo per 24 ore.

Passaggi successivi

Per informazioni su come impostare l'ambiente per le API di comunicazione sincrona di Forms, vedere Elaborazione sincrona di AEM Forms as a Cloud Service Communications.

Articoli correlati

Scopri come impostare l’ambiente per le API di comunicazione Forms sincrone (su richiesta) e asincrone (in batch):

API sincrone

API di comunicazione AEM Forms - Sincrono

Scopri come impostare l’ambiente per le API di comunicazione Forms sincrone (on-demand) che generano o elaborano documenti all’istante.

Ulteriori informazioni

API asincrone

API di comunicazione AEM Forms - Asincrono (batch)

Scopri come impostare l’ambiente per le API di comunicazione Forms asincrone (in batch) che generano o elaborano più documenti in modo pianificato.

Ulteriori informazioni

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