Documentazione Workfront Guida di Workfront

Crea applicazioni OAuth2 per Workfront integrazioni

Ultimo aggiornamento: 10 ottobre 2024

Argomenti:

Creato per:

Amministratore

In qualità di amministratore Adobe Workfront, puoi creare applicazioni OAuth2 per l'istanza di Workfront, che consentono ad altre applicazioni di accedere a Workfront. Gli utenti potranno quindi concedere a queste altre applicazioni l'autorizzazione di accesso ai propri dati di Workfront. In questo modo, puoi integrare con applicazioni di tua scelta, incluse quelle interne.

Quando si crea un'applicazione OAuth2, vengono generati un ID client e un segreto client. Gli utenti possono quindi utilizzare l’ID client nelle chiamate API per l’integrazione con l’applicazione creata.

NOTE

Nel contesto di OAuth2, "creazione di un'app" si riferisce al processo di creazione di questo tipo di collegamento di accesso tra un'app e un server come Workfront.

Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 con le credenziali utente (flusso del codice di autorizzazione), vedere Configurare e utilizzare le applicazioni OAuth 2 personalizzate della propria organizzazione utilizzando il flusso del codice di autorizzazione.
Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 tramite l'autenticazione del server (flusso JWT), consulta Configurare e utilizzare le applicazioni OAuth 2 personalizzate della tua organizzazione tramite il flusso JWT.
Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 tramite PKCE, vedere Configurare e utilizzare le applicazioni OAuth 2 personalizzate della propria organizzazione utilizzando il flusso PKCE.

Requisiti di accesso

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

Per eseguire i passaggi descritti in questo articolo, è necessario disporre dei seguenti diritti di accesso:

Adobe Workfront piano

Qualsiasi

Adobe Workfront licenza

Nuovo: Standard

Oppure

Corrente:Plan

Configurazioni del livello di accesso

Devi essere un amministratore Workfront.

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

Panoramica di OAuth2

Si supponga che un'applicazione debba richiamare alcune informazioni specifiche da Workfront. Un'applicazione che richiede informazioni viene definita client. In questo esempio, il nome del client è ClientApp. ClientApp deve accedere alle informazioni di un utente specifico e quindi deve accedere a Workfront come tale utente. Se l’utente assegna a ClientApp il nome utente e la password, ClientApp potrebbe accedere a tutti i dati a cui l’utente può accedere. Si tratta di un rischio per la sicurezza, perché ClientApp richiede solo un set di informazioni piccolo e specifico.

Quando crei un'app OAuth2 per ClientApp, in sostanza stai dicendo a Workfront che ClientApp è autorizzata ad accedere a Workfront, ma solo se l'utente al quale accede l'account ClientApp concede l'autorizzazione per l'accesso.

Creare un’applicazione OAuth2

Quando crei un’applicazione OAuth2, scegli il tipo di applicazione che meglio soddisfa le esigenze della tua integrazione.

Tipo di applicazione	Ideale per	Metodo di autenticazione
Applicazione machine-to-machine	Consigliato per CLI, daemon o script in esecuzione sul server Esempi: Shell Python	Autenticazione tramite token web JSON con codifica per coppia di chiavi pubblica/privata.
Applicazione web a pagina singola	Consigliato per applicazioni per dispositivi mobili o applicazioni web a pagina singola Esempi: Javascript Angular React Vue	Autenticazione tramite flusso Codice di autenticazione OAuth 2.0 con Proof Key for Code Exchange (PKCE).
Applicazione web	Consigliato per applicazioni lato server che gestiscono credenziali e token sul server Esempi: Go Java ASP.Net Node.js PHP	Autenticazione tramite flusso Codice di autorizzazione OAuth 2.0.

Tipo di applicazione

Ideale per

Metodo di autenticazione

Applicazione machine-to-machine

Consigliato per CLI, daemon o script in esecuzione sul server

Esempi:

Shell
Python

Autenticazione tramite token web JSON con codifica per coppia di chiavi pubblica/privata.

Applicazione web a pagina singola

Consigliato per applicazioni per dispositivi mobili o applicazioni web a pagina singola

Esempi:

Javascript
Angular
React
Vue

Autenticazione tramite flusso Codice di autenticazione OAuth 2.0 con Proof Key for Code Exchange (PKCE).

Applicazione web

Consigliato per applicazioni lato server che gestiscono credenziali e token sul server

Esempi:

Go
Java
ASP.Net
Node.js
PHP

Autenticazione tramite flusso Codice di autorizzazione OAuth 2.0.

NOTE

Puoi avere fino a un totale di dieci applicazioni OAuth2 alla volta.

Creare un’applicazione OAuth2 utilizzando l’autenticazione del server (flusso JWT)
Creare un'applicazione OAuth2 utilizzando le credenziali utente (flusso del codice di autorizzazione)
Creare un’applicazione web OAuth2 a pagina singola utilizzando PKCE

Creare un’applicazione OAuth2 utilizzando l’autenticazione del server (flusso JWT)

Fai clic sull'icona Main Menu nell'angolo superiore destro di Adobe Workfront oppure, se disponibile, fai clic sull'icona Main Menu nell'angolo superiore sinistro, quindi fai clic sull'icona Setup .
Nel pannello di navigazione a sinistra, fai clic su Sistema, quindi seleziona Applicazioni OAuth2.
Fai clic su Crea integrazione app.
Viene visualizzata la casella Nuova applicazione OAuth2.
Nella casella Nuova applicazione OAuth2 selezionare Applicazione da computer a computer.
Immettere un nome per la nuova applicazione, ad esempio "Workfront per ClientApp".
Fai clic su Crea.

Compila i campi per la nuova app.

ID client	Questo campo viene generato automaticamente.
Segreto client	Questo campo viene generato automaticamente IMPORTANTE: Copiare il contenuto di questo campo in un altro file protetto prima di chiudere la pagina. La chiave segreta non sarà più visibile. Se perdi questa chiave, eliminala e crea un Segreto client. Fai clic sull'icona Delete per eliminare il segreto client corrente. Fare clic su Add client secret per generare un nuovo segreto client.
Public Keys	Le app server-to-server utilizzano chiavi pubbliche e private per l'autenticazione. Esegui una delle operazioni seguenti: Fare clic su Add a public key e immettere la chiave pubblica dell'altra applicazione. Fai clic su Generate a public/private keypair, quindi condividi la chiave pubblica con l'altra applicazione.
Name	Questo è lo stesso nome che hai assegnato all’app. Questo campo non può essere vuoto.
Descrizione	Immetti una descrizione per l’integrazione.

Fai clic su Salva.

Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 con le credenziali utente (flusso del codice di autorizzazione), consulta Configurare e utilizzare le applicazioni OAuth 2 personalizzate della tua organizzazione utilizzando il flusso JWT.

Creare un'applicazione OAuth2 utilizzando le credenziali utente (flusso del codice di autorizzazione)

NOTE

Se stai creando un’applicazione per connettersi a Workfront Fusion, utilizza uno dei seguenti URL di reindirizzamento:

https://app.workfrontfusion.com/oauth/cb/workfront-workfront
https://app-eu.workfrontfusion.com/oauth/cb/workfront-workfront (centro dati UE)
https://app-az.workfrontfusion.com/oauth/cb/workfront-workfront (data center di Azure)

Fai clic sull'icona Main Menu nell'angolo superiore destro di Adobe Workfront oppure, se disponibile, fai clic sull'icona Main Menu nell'angolo superiore sinistro, quindi fai clic sull'icona Setup .
Nel pannello di navigazione a sinistra, fai clic su Sistema, quindi seleziona Applicazioni OAuth2.
Fai clic su Crea integrazione app.

Viene visualizzata la nuova applicazione OAuth2.
Nella casella Nuova applicazione OAuth2 selezionare Applicazione Web.
Immettere un nome per la nuova applicazione OAuth2, ad esempio "Workfront per ClientApp."
Fai clic su Crea.

Compila i campi per la nuova app.

ID client	Questo campo viene generato automaticamente.
Segreto client	Questo campo viene generato automaticamente IMPORTANTE: Copiare il contenuto di questo campo in un altro file protetto prima di chiudere la pagina. La chiave segreta non sarà più visibile. Se perdi questa chiave, eliminala e crea un Segreto client. Fai clic sull'icona Delete per eliminare il segreto client corrente. Fare clic su Add client secret per generare un nuovo segreto client.
URL di reindirizzamento	Gli utenti verranno reindirizzati a questo percorso dopo l'autenticazione con Workfront.
Aggiorna rotazione token	Abilita questa opzione affinché, ogni volta che viene utilizzato il token di aggiornamento, ne venga emesso uno nuovo. L’applicazione deve archiviare il nuovo token di aggiornamento dopo ogni aggiornamento.
Scadenza token di aggiornamento assoluto di	Seleziona il periodo di tempo per il quale desideri che esista un token di aggiornamento prima della scadenza. Quando scade, gli utenti devono accedere di nuovo all’integrazione. Seleziona "Nessuna scadenza" se non desideri che il token di aggiornamento scada.
Scadenza token di aggiornamento inattività	Seleziona il periodo di tempo dopo il quale, se l’utente non è stato attivo nel sistema, il token di aggiornamento scade. Ad esempio, se la scadenza del token di aggiornamento per inattività è di 6 mesi e l’utente non effettua l’accesso per 6 mesi, il token di aggiornamento scade anche se la scadenza del token di aggiornamento assoluto può essere impostata per un periodo più lungo.
Logo	Puoi aggiungere un logo per rendere questa app più identificabile.
Name	Questo è lo stesso nome che hai assegnato all’app. Questo campo non può essere vuoto.
Descrizione	Immetti una descrizione per l’integrazione.
URL descrizione app	Può trattarsi di un collegamento a una pagina "Chi siamo" o di una pagina con ulteriori informazioni sull’integrazione.

Fai clic su Salva.

Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 con le credenziali utente (flusso del codice di autorizzazione), vedere Configurare e utilizzare le applicazioni OAuth 2 personalizzate della propria organizzazione utilizzando il flusso del codice di autorizzazione.

Creare un’applicazione web OAuth2 a pagina singola utilizzando PKCE

Fai clic sull'icona Main Menu nell'angolo superiore destro di Adobe Workfront oppure, se disponibile, fai clic sull'icona Main Menu nell'angolo superiore sinistro, quindi fai clic sull'icona Setup .
Nel pannello di navigazione a sinistra, fai clic su Sistema, quindi seleziona Applicazioni OAuth2.
Fai clic su Crea integrazione app.

Viene visualizzata la casella Nuova applicazione OAuth2.
Nella casella Nuova applicazione OAuth2 selezionare Applicazione Web a pagina singola.
Immettere un nome per la nuova applicazione OAuth2, ad esempio "Workfront per ClientApp."
Fai clic su Crea.

Compila i campi per la nuova app.

ID client	Questo campo viene generato automaticamente.
URL di reindirizzamento	Gli utenti verranno reindirizzati a questo percorso dopo l’autenticazione con Workfront.
Ruota token di aggiornamento ogni volta che viene utilizzato	Abilita questa opzione affinché, ogni volta che viene utilizzato il token di aggiornamento, ne venga emesso uno nuovo. L’applicazione deve archiviare il nuovo token di aggiornamento dopo ogni aggiornamento.
scadenza assoluta	Seleziona il periodo di tempo per il quale desideri che esista un token di aggiornamento prima della scadenza. Quando scade, gli utenti devono accedere di nuovo all’integrazione. Seleziona "Nessuna scadenza" se non desideri che il token di aggiornamento scada.
scadenza inattività	Seleziona il periodo di tempo dopo il quale, se l’utente non è stato attivo nel sistema, il token di aggiornamento scade. Ad esempio, se la scadenza del token di aggiornamento per inattività è di 6 mesi e l’utente non effettua l’accesso per 6 mesi, il token di aggiornamento scade anche se la scadenza del token di aggiornamento assoluto può essere impostata per un periodo più lungo.
Logo	Puoi aggiungere un logo per rendere questa app più identificabile.
Name	Questo è lo stesso nome che hai assegnato all’app. Questo campo non può essere vuoto.
Descrizione	Immetti una descrizione per l’integrazione.
Nome sviluppatore	Questo è il nome dello sviluppatore che sta configurando l’applicazione OAuth2.
Indirizzo e-mail sviluppatore	Questo è l’indirizzo e-mail dello sviluppatore che sta configurando l’applicazione OAuth2.
URL criteri di privacy	Questo è il collegamento in cui l’organizzazione memorizza l’informativa sulla privacy.

Fai clic su Salva.

Configurare e utilizzare l’applicazione OAuth2 creata

L’ulteriore configurazione e utilizzo dell’applicazione OAuth2 creata richiede alcune conoscenze tecniche, tra cui le chiamate API.

Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 con le credenziali utente (flusso del codice di autorizzazione), vedere Configurare e utilizzare le applicazioni OAuth 2 personalizzate della propria organizzazione utilizzando il flusso del codice di autorizzazione.
Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 tramite l'autenticazione del server (flusso JWT), consulta Configurare e utilizzare le applicazioni OAuth 2 personalizzate della tua organizzazione tramite il flusso JWT.
Per istruzioni sulla configurazione e l'utilizzo dell'applicazione OAuth2 tramite PKCE, vedere Configurare e utilizzare le applicazioni OAuth 2 personalizzate della propria organizzazione utilizzando il flusso PKCE.

Processi OAuth2 per il flusso del codice di autorizzazione

NOTE

Gli utenti accedono all'applicazione OAuth2 tramite l'API. Questa sezione descrive la funzionalità in termini generali ed è fornita solo a scopo informativo.

Per istruzioni specifiche sull'utilizzo dell'applicazione OAuth2, incluse chiamate API specifiche, vedere Configurare e utilizzare le applicazioni OAuth 2 personalizzate della propria organizzazione utilizzando il flusso del codice di autorizzazione.

Autorizzazione con codice di autorizzazione e token di accesso

ClientApp richiede alcune informazioni da Workfront, pertanto invia una richiesta all'endpoint /authorize dell'API Workfront. La richiesta include response_type code, che indica che la richiesta deve restituire un codice di autorizzazione.
In questo modo Workfront viene attivato per inviare una richiesta di autenticazione all'utente. L'utente può immettere le proprie credenziali nel prompt, che concede a Workfront l'autorizzazione per comunicare con ClientApp. Se l'utente ha già effettuato l'accesso a Workfront, questo passaggio potrebbe essere ignorato.
L'API Workfront invia un codice di autorizzazione a ClientApp.
ClientApp invia le seguenti informazioni in una richiesta all'API /token di Workfront endpoint:
- Il codice di autorizzazione inviato a ClientApp nel passaggio 3. Questo identifica l’istanza specifica dell’autorizzazione utente.
- Segreto client generato durante la configurazione dell'app ClientApp OAuth2 in Workfront. Ciò consente a Workfront di sapere che la richiesta proviene da ClientApp.
Se il codice di autorizzazione e il segreto client sono corretti, Workfront invia un token di accesso a ClientApp. Questo token di accesso viene inviato direttamente da Workfront a ClientApp e non può essere visualizzato, copiato o utilizzato da altri utenti o applicazioni client.
ClientApp invia il token di accesso a Workfront insieme alla richiesta specifica di informazioni.
Poiché il token di accesso è corretto, Workfront invia le informazioni a ClientApp.

Aggiornamento dei token di accesso

Per motivi di sicurezza, i token di accesso scadono dopo un breve periodo di tempo. Per ottenere nuovi token di accesso senza dover immettere ogni volta le credenziali, OAuth2 utilizza i token di aggiornamento. I token di aggiornamento vengono memorizzati dal client.

Il processo di acquisizione di un token di aggiornamento è lo stesso descritto nella sezione Autorizzazione con codice di autorizzazione e token di accesso. La richiesta del codice di autorizzazione include l'ambito offline_access, che indica che la richiesta deve restituire un token di richiesta insieme al codice di autorizzazione.

recommendation-more-help