Moduli Azure DevOps

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront	Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront. Workfront Ultimate Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion.
Licenze Adobe Workfront	Standard Work o successiva
Licenza di Adobe Workfront Fusion	Basato su operazioni: disponibile per le organizzazioni con licenze basate su operazioni Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration
Prodotto	Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.

Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.

Espandi per visualizzare le istruzioni per la connessione di Azure DevOps ad Adobe Workfront Fusion tramite una connessione federata.

note
NOTE
La configurazione di questa connessione richiede due visite al centro di amministrazione di Microsoft Entra. Registra prima l’app, quindi crea la connessione in Workfront Fusion, quindi torna a Microsoft Entra ID per aggiungere le credenziali federate. Ciò si verifica perché le credenziali federate hanno identificato una connessione specifica e tale identificatore non esiste fino alla creazione della connessione. A questa connessione si applicano gli stessi limiti della connessione dell'entità servizio. Un numero limitato di azioni a livello di amministratore, come la gestione delle licenze utente, richiede ancora una connessione a un account personale.

• Prerequisiti per la connessione di Azure DevOps a Workfront Fusion tramite una connessione federata
• Creare la registrazione dell’app in Microsoft Entra ID (connessione federata)
• Raccogliere i dettagli di connessione (connessione federata)
• Creare la connessione in Workfront Fusion (connessione federata)
• Aggiungere le credenziali federate in Microsoft Entra ID
• Verifica la connessione (connessione federata)

Prerequisiti per la connessione di Azure DevOps a Workfront Fusion tramite una connessione federata

Per creare questa connessione, è necessario disporre dei seguenti elementi:

• Accesso Amministratore globale o Amministratore applicazione in Microsoft Entra ID, per registrare l’app e aggiungere le credenziali federate. Se non disponi di questo accesso, chiedi a qualcuno del tuo team IT o di identità di completare questi passaggi al posto tuo.
• Accesso amministratore della raccolta di progetti nell’organizzazione Azure DevOps, per aggiungere l’entità servizio come membro. Spesso si tratta di una persona diversa da quella che gestisce l’Entra ID di Microsoft.
• Nome dell’organizzazione Azure DevOps. È possibile trovarlo nell’URL di Azure DevOps: dev.azure.com/<your organization name>.

Creare la registrazione dell’app in Microsoft Entra ID (connessione federata)

1. Accedi al centro di amministrazione di Microsoft Entra.
2. Vai a Registrazioni app > Nuova registrazione.
3. Assegna all’app un nome chiaro e riconoscibile. Ad esempio, Workfront Fusion Azure DevOps Integration.
4. Lascia vuoto URI di reindirizzamento. Questa connessione non comporta l’accesso tramite un browser.
5. Seleziona Registra.
6. Non creare un segreto client. Una connessione federata non ne utilizza una.
7. Continua con Raccogliere i dettagli della connessione.

Raccogliere i dettagli di connessione (connessione federata)

1. Nella pagina Panoramica della registrazione dell’app, prendi nota dei seguenti valori. Immetti questi valori durante la creazione della connessione nel modulo.

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   ID tenant	Nella pagina Panoramica, con etichetta ID directory (tenant).
   ID client	Nella pagina Panoramica, etichettato ID applicazione (client).
   Organizzazione	Il nome della tua organizzazione Azure DevOps. Ad esempio, se l'URL è dev.azure.com/yourorg, immettere yourorg.

2. Continua con Crea la connessione in Workfront Fusion.

note
NOTE
Come per la connessione dell’entità servizio, puoi saltare l’area delle autorizzazioni API per la registrazione dell’app. Nella procedura successiva, l’accesso ad Azure DevOps viene concesso all’interno di Azure DevOps.

Creare la connessione in Workfront Fusion (connessione federata)

1. Nella schermata di configurazione della connessione del modulo, seleziona il tipo di connessione federata.

2. Immetti il codice seguente:

   • ID tenant
   • ID client
   • Organizzazione

3. Seleziona Crea.

   In Workfront Fusion vengono visualizzati tre valori. Lascia aperta questa pagina, poiché questi valori saranno necessari in un secondo momento durante la creazione della connessione.

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   Emittente	https://oidc.automations.adobe.com.
   Subject	Questo identifica questa connessione. È fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. È diversa per ogni connessione creata.
   Audience	api://AzureADTokenExchange.

   note important
   IMPORTANT
   Non chiudere il pannello e non selezionare Annulla. La connessione non viene completata fino a quando non si completa il resto della procedura. Se chiudi il pannello, devi eliminare la connessione e riavviarla, perché a una nuova connessione viene assegnato un nuovo Oggetto.

4. Copia il valore Subject.

5. Continuare con Aggiungere le credenziali federate nell’ID Entra di Microsoft.

Aggiungere le credenziali federate in Microsoft Entra ID

Questa procedura sostituisce il segreto client. Indica a Microsoft Entra ID di accettare i token che Workfront Fusion genera per questa connessione.

1. In una nuova scheda del browser, torna al centro di amministrazione di Microsoft Entra e apri la registrazione all’app.

2. Vai a Certificati e segreti > Credenziali federate.

3. Seleziona Aggiungi credenziali.

4. In Scenario credenziali federate selezionare Altro emittente.

5. Immetti il codice seguente:

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   Emittente	https://oidc.automations.adobe.com
   Subject identifier	Oggetto copiato da Workfront Fusion. Incollalo esattamente, senza spazi aggiunti.
   Nome	Un nome che identifica la connessione, in modo da poterla trovare in un secondo momento. Ad esempio, workfront-fusion-connection-28964.
   Audience	api://AzureADTokenExchange. Questo di solito è compilato per te. Lascia il valore predefinito.

6. Fai clic su Aggiungi.

7. Continua con Verifica la connessione.

note
NOTE
Microsoft Entra ID consente un massimo di 20 credenziali federate in una singola registrazione di app e l’identificatore Subject deve corrispondere esattamente. I caratteri jolly non sono supportati. Poiché ogni connessione Workfront Fusion ha il proprio oggetto, ogni connessione ha bisogno delle proprie credenziali federate. Se prevedi più di 20 connessioni, registra più di un’app e distribuisci le connessioni tra di esse.

Verifica la connessione (connessione federata)

1. Tornare alla scheda del browser Workfront Fusion, dove il pannello di connessione è ancora aperto.

2. Fai clic su Salva.

   • Se tutto è configurato correttamente, la connessione viene convalidata correttamente e puoi procedere con la configurazione del modulo.
   • Se la verifica non riesce, il pannello rimane aperto e visualizza l’errore. Correggi il problema in Microsoft Entra ID o Azure DevOps e seleziona nuovamente Salva. Non è necessario ricreare la connessione e l’oggetto non cambia.

note
NOTE
L'attivazione di una credenziale federata aggiunta in Microsoft Entra ID può richiedere un breve tempo. Se la verifica non riesce subito dopo aver aggiunto le credenziali, attendi un minuto e seleziona nuovamente Salva prima di approfondire l’analisi.

Risoluzione dei problemi

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Impossibile verificare la connessione a causa di un client non valido o di un errore di richiesta non valido	L’ID dell’endpoint Microsoft non può corrispondere al token per una credenziale federata. Verificare che l'autorità emittente sia esattamente https://oidc.automations.adobe.com senza barra finale e che l'identificatore dell'oggetto sia identico al carattere indicato in Workfront Fusion. La causa più comune è un oggetto copiato da una connessione diversa.
La connessione viene verificata, ma i moduli restituiscono 401 o 403 da Azure DevOps	L’identità è attendibile, ma non ha accesso ai dati Azure DevOps. Conferma di aver completato Aggiungere l'entità servizio all'organizzazione Azure DevOps e che l'entità servizio è assegnata al progetto specifico utilizzato dal modulo.
Impossibile aggiungere un'altra credenziale federata	Hai raggiunto il limite di 20 credenziali federate per la registrazione dell’app. Registra un’app aggiuntiva e crea ulteriori connessioni.

Espandi per visualizzare le istruzioni per la connessione di Azure DevOps a Workfront Fusion tramite EntraApp

1. Aggiungi un modulo Azure DevOps allo scenario.

2. Fai clic su Aggiungi accanto al campo Connessione.

3. Nel campo Tipo di connessione, selezionare il tipo di connessione che si desidera utilizzare.

   note
   NOTE
   Azure DevOps (EntraApp) consente di richiedere tutti gli ambiti per la connessione.

4. Compila i campi seguenti:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection name (Nome della connessione)	Immettere un nome per la connessione che si sta creando.
   Organizzazione	Immettere il nome dell'organizzazione con cui è stata creata l'applicazione Azure DevOps.
   ID app	Immettere l'ID dell'applicazione DevOps a cui ci si connette.
   Client Secret (Segreto client)	Immettere il segreto client per le applicazioni DevOps a cui ci si connette.
   Richiedi tutti gli ambiti	Se si utilizza il tipo di connessione Azure DevOps (EntraApp), abilitare questa opzione per richiedere tutti gli ambiti per la connessione.

5. Per immettere un ID app Azure DevOps o un segreto client, fai clic su Mostra impostazioni avanzate e immettili nei campi aperti.

6. Fai clic su Continua per completare la configurazione della connessione e continuare a creare lo scenario.

Espandi per visualizzare le istruzioni per la connessione di Azure DevOps ad Adobe Workfront Fusion utilizzando un’entità servizio.

note
NOTE
L’autenticazione dell’entità servizio non supporta tutte le funzioni DevOps di Azure. Un numero limitato di azioni a livello di amministratore, come la gestione delle licenze utente, richiede ancora una connessione a un account personale. Utilizza l’autenticazione dell’entità servizio se è necessaria solo per elementi di lavoro, bacheche, repository o pipeline.

• Prerequisiti per la connessione di Azure DevOps a Workfront Fusion tramite un’entità servizio
• Creare la registrazione dell’app in Microsoft Entra ID
• Creare un segreto client
• Raccogliere i dettagli di connessione
• Aggiungere l’entità servizio all’organizzazione Azure DevOps
• Creare la connessione

Prerequisiti per la connessione di Azure DevOps a Workfront Fusion tramite un’entità servizio

Per creare questa connessione, è necessario disporre dei seguenti elementi:

• Accesso Amministratore globale o Amministratore applicazioni in Microsoft Entra ID, per registrare l’app. Se non disponi di questo accesso, chiedi a qualcuno del tuo team IT o di identità di completare quel passaggio al posto tuo.
• Accesso Amministratore raccolta progetti nell’organizzazione Azure DevOps per aggiungere l’entità servizio come membro. Spesso si tratta di una persona diversa da quella che gestisce l’Entra ID di Microsoft.
• Nome dell’organizzazione Azure DevOps. È possibile trovarlo nell’URL di Azure DevOps: dev.azure.com/<your organization name>.

Creare la registrazione dell’app in Microsoft Entra ID (entità servizio)

1. Accedere al centro di amministrazione Microsoft Entra.
2. Vai a Registrazioni app > Nuova registrazione.
3. Assegna all’app un nome chiaro e riconoscibile. Ad esempio, Workfront Fusion Azure DevOps Integration.
4. Lascia vuoto URI reindirizzamento. Questa connessione non comporta l’accesso tramite un browser.
5. Seleziona Registra.
6. Continua con Crea un segreto client.

Creare un segreto client

1. Nella tua nuova registrazione all’app, vai a Certificati e segreti.
2. Seleziona Nuovo segreto client, aggiungi una descrizione e scegli un periodo di scadenza.
3. Seleziona Aggiungi.
4. Copia immediatamente il Valore del segreto. Viene visualizzato una sola volta. Se esci prima di copiarlo, devi crearne uno nuovo.
5. Continua con Raccogliere i dettagli della connessione.

Raccogliere i dettagli di connessione (entità servizio)

1. Nella pagina Panoramica della registrazione dell’app, prendi nota dei seguenti valori. Immetti questi valori durante la creazione della connessione nel modulo.

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   ID tenant	Nella pagina Panoramica, con etichetta ID directory (tenant).
   ID client	Nella pagina Panoramica, etichettato ID applicazione (client).
   Client Secret (Segreto client)	Il valore copiato in Crea un segreto client.
   Organizzazione	Il nome della tua organizzazione Azure DevOps. Ad esempio, se l'URL è dev.azure.com/yourorg, immettere yourorg.

   note
   NOTE
   Puoi saltare l'area Autorizzazioni API della registrazione dell'app. Se aggiungi Azure DevOps, sono disponibili solo autorizzazioni delegate. Le autorizzazioni dell'applicazione sono visualizzate in grigio. Ciò è previsto, perché Azure DevOps non supporta questa modalità di concessione dell’accesso. Nella parte successiva, l’accesso viene concesso direttamente all’interno di Azure DevOps.

2. Continua con Aggiungi l’entità servizio alla tua organizzazione Azure DevOps.

Aggiungere l’entità servizio all’organizzazione Azure DevOps

La registrazione dell’app in Microsoft Entra ID ne crea solo l’identità. Non fornisce ancora all’app alcun accesso ai dati Azure DevOps. Questa procedura consente l’accesso.

1. Accedi alla tua organizzazione Azure DevOps all’indirizzo dev.azure.com/<your organization name>.

2. Seleziona Impostazioni organizzazione in basso a sinistra, quindi seleziona Utenti.

3. Selezionare Aggiungi utenti.

4. Nella casella di ricerca, cerca in base al nome visualizzato dell’app, che è il nome che le hai assegnato quando hai registrato l’app. Non eseguire ricerche in base all’ID client.

5. Selezionare un livello di accesso:

   • Base è in genere sufficiente per leggere e scrivere elementi di lavoro, bacheche e repository.
   • Se il flusso di lavoro deve sfogliare i processi disponibili, ad esempio i modelli Agile, Scrum o personalizzati, come parte della configurazione, aggiungi l’entità servizio al gruppo Amministratori raccolta progetti. Si tratta di un livello di accesso più ampio, quindi concedilo solo se hai bisogno di tale funzionalità.

6. Assegna l’entità servizio al progetto o ai progetti specifici necessari, seguendo le consuete procedure di accesso dell’organizzazione.

7. Seleziona Aggiungi.

8. Continua con Crea la connessione in Workfront Fusion.

Creare la connessione in Workfront Fusion (entità servizio)

1. Nella schermata di configurazione della connessione del modulo, selezionare il tipo di connessione Entità servizio.

2. Immetti il codice seguente:

   • ID tenant
   • ID client
   • Segreto client
   • Organizzazione

3. Salva la connessione.

   Se tutto è configurato correttamente, la connessione viene convalidata correttamente.