DocumentazioneIA per la gestione dei contenuti AEM

Configurare un progetto Adobe Developer Console configure-adc-project

Ultimo aggiornamento: 4 giugno 2026

Creato per:

  • Beginner
  • Developer
  • Admin

Per richiamare l’API di AEM Content AI Services, è necessario disporre delle credenziali emesse da un progetto Adobe Developer Console (ADC). Questa pagina illustra come creare il progetto, selezionare un metodo di autenticazione e generare le credenziali incluse in ogni richiesta API.

Vai a Adobe Developer Console per iniziare la tua organizzazione.

Prerequisiti prerequisites

Prima di iniziare, verifica quanto segue:

  • Hai accesso a Adobe Developer Console per la tua organizzazione.
  • Sei stato aggiunto come Sviluppatore nel profilo di prodotto di AEM Content AI Services in Adobe Admin Console. Senza questo ruolo, la scheda API AEM Content AI Services risulta disabilitata e l’opzione di autenticazione Server-to-Server è nascosta.
  • Si conoscono i numeri del programma e dell’ambiente per il profilo di prodotto che si desidera selezionare (ad esempio, AEM User - publish - Program 12345 - Environment 67890).

Scegli un metodo di autenticazione choose-auth

AEM Content AI Services supporta due metodi di autenticazione. Scegli quello che corrisponde alla tua integrazione:

Metodo
Ideale per
Server-to-Server
Servizi di back-end che chiamano l’API senza interazione dell’utente. Restituisce un token di accesso di breve durata.
Chiave API
Integrazioni lato client o basate su browser che chiamano direttamente l’API. Restituisce una chiave di lunga durata con ambito nei domini consentiti.

Autenticazione server-to-server s2s-auth

  1. Seleziona API e servizi, quindi API.

    Developer Console con API e servizi

  2. Filtra per AEM Content AI Services, quindi seleziona Crea progetto per avviare un nuovo progetto oppure Aggiungi API se aggiungi il servizio a un progetto esistente.

    note
    NOTE
    Se la scheda API è disabilitata e viene visualizzato il messaggio "Licenza richiesta", l’ambiente AEM as a Cloud Service potrebbe non essere modernizzato. Consulta Modernizzazione dell'ambiente AEM as a Cloud Service.

  3. Nella finestra di dialogo Configura API, selezionare Autenticazione da server a server.

    Finestra di dialogo Configura API con selezione server-to-server

    note tip
    TIP
    Se l’opzione Server-to-Server non è disponibile, l’utente che configura l’integrazione non viene aggiunto come Sviluppatore al profilo di prodotto. Vedere Abilitare l'autenticazione server-to-server.

  4. Se necessario, rinominare le credenziali. Seleziona Avanti.

    Passaggio Adobe Developer Console per rinominare le nuove credenziali server-to-server prima di selezionare Next

  5. Seleziona l’utente AEM - pubblicazione - programma XXX - ambiente XXX e/o utente AEM - autore - programma XXX - ambiente XXX profilo prodotto, quindi seleziona Salva.

    Selezione profili di prodotto con i profili di pubblicazione e creazione degli utenti di AEM per il programma e l'ambiente di destinazione

  6. Controlla l’API e la configurazione dell’autenticazione.

    Schermata di revisione che riepiloga l'API selezionata, il tipo di autenticazione e il nome delle credenziali

    Dettagli della schermata di revisione che mostrano i profili di prodotto assegnati per le credenziali

Generare un token di accesso generate-token

  1. Nel progetto ADC, vai a Credenziali e seleziona Genera token di accesso.

    Pagina Credenziali con il pulsante Genera token di accesso evidenziato

  2. Includi il token nell’intestazione Authorization di ogni richiesta API:

    code language-http 
    Authorization: Bearer YOUR_ACCESS_TOKEN
    note warning
    WARNING
    Memorizza il token in modo sicuro. Scade e deve essere rigenerato periodicamente.

Autenticazione chiave API api-key-auth

  1. Quando aggiungi l’API di AEM Content AI Services al progetto, seleziona Chiave API nella finestra di dialogo Seleziona tipo di autenticazione.

    Seleziona tipo di autenticazione chiave API

  2. Conferma le credenziali della chiave API.

    Aggiungi credenziali chiave API

  3. Per limitare le origini che possono utilizzare la chiave, configura i domini consentiti.

    Configura domini consentiti

  4. La chiave API (ID client) viene visualizzata in Credenziali collegate. Seleziona Copia.

    Copia chiave API da credenziali connesse

  5. Includi la chiave in ogni richiesta API:

    code language-http 
    x-api-key: YOUR_API_KEY

    Il progetto è ora pronto. Utilizza la chiave con ogni richiesta di AEM Content AI Services.

Passaggi successivi next-steps

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