DocumentazioneAEM as a Cloud ServiceGuida utente

Autenticazione server-to-server OAuth

Last update: Wed Jan 14 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 consente l'accesso sicuro e basato su token alle API di AEM Forms Communications senza richiedere l'interazione dell'utente. L'autenticazione server-to-server OAuth è supportata da Adobe Developer Console.

Prerequisiti

Prima di iniziare, accertati di soddisfare i seguenti prerequisiti:

Come si genera un token di accesso utilizzando l’autenticazione server-to-server di OAuth?

Segui i passaggi seguenti per generare un token di accesso dalla console Adobe Developer ed effettua la prima chiamata API tramite l’autenticazione server-to-server OAuth.

​1. Configurazione del progetto Adobe Developer Console

  1. Passa a Adobe Developer Console

  2. Accedi con il tuo Adobe ID

  3. Crea un nuovo progetto o accedi al progetto esistente

Per creare un nuovo progetto

  1. Dalla sezione Guida rapida, fai clic su Crea nuovo progetto

  2. Viene creato un nuovo progetto con un nome predefinito

    Crea progetto ADC

  3. Fai clic su Modifica progetto nell'angolo superiore destro

    Modifica progetto

  4. Fornisci un nome significativo (ad esempio, "formsproject")

  5. Fai clic su Salva

    Modifica nome progetto

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