DocumentazioneWorkfrontGuida di Workfront

Configurare e utilizzare le applicazioni OAuth 2 personalizzate della tua organizzazione utilizzando il flusso JWT

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Per eseguire l’integrazione con Workfront e consentire all’app client di comunicare con Workfront per conto dell’utente, è necessario:

  • Creare un’applicazione OAuth2
  • Creare un certificato a chiave pubblica
  • Creare un token web JSON (JWT)

Creare un'applicazione OAuth2

Per istruzioni sulla creazione dell'applicazione OAuth2, vedere Creare un'applicazione OAuth2 utilizzando l'autenticazione del server (flusso JWT) in Creare applicazioni OAuth2 per le integrazioni Workfront

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

Creare un certificato a chiave pubblica

Per poter essere incluso nella richiesta di accesso, il JWT deve essere firmato e codificato in base 64. Le librerie JWT forniscono le funzioni necessarie per eseguire queste attività.

Il token deve essere firmato utilizzando la chiave privata per un certificato di firma digitale. In tal caso, puoi utilizzare la chiave privata di qualsiasi certificato associato per firmare il tuo JWT.

L'algoritmo utilizzato è RS256 (firma RSA con SHA-256). Si tratta di un algoritmo asimmetrico che utilizza una coppia di chiavi pubblica/privata. Il provider di identità ha una chiave privata (segreta) utilizzata per generare la firma e il consumatore del JWT ottiene una chiave pubblica per convalidarla.

Per generare la chiave pubblica, eseguire one delle operazioni seguenti.

  • Apri il terminale MacOS/Linux ed esegui il comando seguente, quindi carica certificate_pub.crt utilizzando il pulsante Aggiungi chiave pubblica nella configurazione dell'applicazione OAuth2 in Workfront.

    code language-none 
    openssl req -x509 -sha256 -nodes -newkey rsa:2048 -keyout private.key -out certificate_pub.crt

  • Utilizza il pulsante Genera una coppia di chiavi pubblica/privata nella configurazione dell'applicazione OAuth2 in Workfront per generare l'RSA.

Creare un token web JSON

Un token web JSON per l’autenticazione dell’account di servizio richiede un set particolare di attestazioni e deve essere firmato utilizzando un certificato di firma digitale valido. È consigliabile utilizzare una delle librerie o degli strumenti disponibili al pubblico per creare il codice JWT.

La tabella seguente contiene informazioni sui campi che potrebbero essere necessari durante la configurazione del token JWT.

exp

Obbligatorio. Il parametro di scadenza è un parametro obbligatorio che misura il tempo assoluto dal 01/01/1970 GMT. Assicurati che la scadenza sia successiva alla data del rilascio. Trascorso questo periodo, il JWT non è più valido.

Nota: ti consigliamo di disporre di un token di durata molto breve (pochi minuti), in modo che scada subito dopo essere stato scambiato per un token di accesso. Ogni volta che è necessario un nuovo token di accesso, viene firmato e scambiato un JWT. Si tratta di un approccio più sicuro. È sconsigliato utilizzare token di durata maggiore riutilizzati per ottenere i token di accesso in base alle esigenze.

iss
Obbligatorio. L’emittente è il tuo ID cliente dai dettagli dell’app OAuth2.
sub
Obbligatorio. L'oggetto è l'ID utente che ha creato la chiave pubblica nella configurazione.

Scambia il JWT per recuperare un token di accesso

  1. Invia una richiesta POST a:

    code language-none 
    https://yourdomain.my.workfront.com/integrations/oauth2/api/v1/jwt/exchange

  2. Il corpo della richiesta deve contenere parametri codificati in URL con ID client, Segreto client e JWT:

    code language-none 
    client_id={client_id_value}&client_secret={client_secret_value}&jwt_token={base64_encoded_JWT}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43