DocumentazioneWorkfrontGuida di Workfront

HTTP > Effettuare una richiesta OAuth 2.0 modulo

Last update: Fri Feb 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
NOTE
Adobe Workfront Fusion richiede un Adobe Workfront Fusion licenza oltre a un Adobe Workfront licenza.

Al fine di creare un Adobe Workfront Fusion richiesta HTTP(S) ai server che richiedono un’autorizzazione OAuth 2.0, devi innanzitutto creare una connessione OAuth. Adobe Workfront Fusion garantisce che tutte le chiamate effettuate con questa connessione dispongano delle intestazioni di autorizzazione appropriate e aggiornino automaticamente i token associati quando necessario.

Workfront Fusion supporta i seguenti flussi di autenticazione OAuth 2.0:

  • Flusso codice di autorizzazione
  • Flusso implicito

Altri flussi, come il flusso delle credenziali della password del proprietario della risorsa e il flusso delle credenziali del client, non sono automaticamente supportati da questo modulo.

Per ulteriori informazioni sull’autenticazione OAuth 2.0, consulta Framework di autorizzazione OAuth 2.0.

NOTE
Se ti stai connettendo a un prodotto di Adobe che al momento non dispone di un connettore dedicato, ti consigliamo di utilizzare il modulo Adobe Authenticator.
Per ulteriori informazioni, consulta Modulo Adobe Authenticator.

Requisiti di accesso

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Fabbisogno di licenza corrente: No Workfront Fusion requisito di licenza.

Oppure

Requisito licenza legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone di Select o Prime Adobe Workfront Pianifica, la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo. Workfront Fusion è incluso in Ultimate Workfront piano.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare Workfront amministratore.

Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze

Creazione di una connessione per un OAuth richiesta

Istruzioni generali per la creazione di una connessione in HTTP > Effettuare una richiesta OAuth 2.0 modulo

  1. Creare un client OAuth in target servizio con cui desideri Adobe Workfront Fusion per comunicare. Questa opzione si trova probabilmente in Sviluppatore del servizio specificato.

    1. Quando crei un client, immetti l’URL appropriato nella sezione Redirect URL o Callback URL campo:

      table 0-row-2 1-row-2
      Americhe/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    2. Dopo aver creato il client, il servizio specificato visualizza 2 chiavi: Client ID e Client Secret. Alcuni servizi li chiamano App Key e App Secret . Salvare la chiave e il segreto in un percorso sicuro, in modo da poterli fornire quando si crea la connessione in Workfront Fusion.

  2. Trova il Authorize URI e Token URI nella documentazione API del servizio specificato. Si tratta di indirizzi URL attraverso i quali Workfront Fusion comunica con target servizio. Gli indirizzi vengono utilizzati per l’autorizzazione OAuth.

    note note
    NOTE
    Se il servizio utilizza il flusso implicito, sarà necessario solo il Authorize URI.
    note info
    INFO
    Esempio: Indirizzi Yahoo:
    • URI autorizzazione:
    https://api.login.yahoo.com/oauth2/request_auth
    • URI token:
    https://api.login.yahoo.com/oauth2/get_token

  3. (Condizionale) Se il servizio di destinazione utilizza ambiti (diritti di accesso), controlla in che modo il servizio separa i singoli ambiti e assicurati di impostare di conseguenza il separatore nelle impostazioni avanzate. Se il separatore non è impostato correttamente, Workfront Fusion non riesce a creare la connessione e viene visualizzato un errore di ambito non valido.

  4. Dopo aver completato i passaggi precedenti, puoi iniziare a creare la connessione OAuth in Workfront Fusion. Aggiungi il modulo di elaborazione delle richieste e delle risposte HTTP(S) OAuth 2.0 allo scenario.

  5. Nel campo Connection del modulo, fai clic su Aggiungi.

  6. Compila i campi seguenti per creare una connessione:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 layout-auto html-authored no-header
    Nome connessione Immettere il nome della connessione.
    Tipo di flusso

    Seleziona il flusso per ottenere i token.

    • Codice autorizzazione: immetti il Authorize URI e Token URI dalla documentazione API del servizio.
    • implicito: immetti il Authorize URI dalla documentazione API del servizio.
    Ambito Aggiungere singoli ambiti. Puoi trovare queste informazioni nella documentazione per gli sviluppatori (API) del servizio specificato.
    Separatore ambito

    Seleziona gli ambiti inseriti sopra da separare con. Puoi trovare queste informazioni nella documentazione per gli sviluppatori (API) del servizio specificato.

    Avvertenza: se il separatore non è impostato correttamente, Workfront Fusion impossibile creare la connessione. si riceve un errore di ambito non valido.
    ID client Immetti l'ID client. Hai ottenuto l’ID client quando hai creato un client OAuth nel servizio che desideri connettere.
    Segreto client Immetti il segreto client. Il segreto client è stato ottenuto quando hai creato un client OAuth nel servizio che desideri connettere.
    Autorizza parametri

    Aggiungi eventuali parametri da includere nella chiamata di autorizzazione. I seguenti parametri standard sono sempre inclusi automaticamente e non è necessario aggiungerli.

    Parametri standard:

    • tipo_risposta

      code per Codice di autorizzazione flusso e token per Flusso implicito

    • redirect_uri

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      Americhe/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id

      ID client ricevuto al momento della creazione dell’account
    Parametri token di accesso

    Aggiungi eventuali parametri da includere nella chiamata del token. I seguenti parametri standard sono sempre inclusi automaticamente e non è necessario aggiungerli.

    Parametri standard:

    • grant_type: authorization_code

    • redirect_uri:

      table 0-row-2 1-row-2 layout-auto html-authored no-header
      Americhe/APAC https://app.workfrontfusion.com/oauth/cb/oauth2
      EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2

    • client_id: l’ID client ricevuto al momento della creazione dell’account viene incluso automaticamente nel corpo della richiesta

    • client_secret: il segreto client ricevuto durante la creazione dell’account viene incluso automaticamente nel corpo della richiesta

    • codice: codice restituito dalla richiesta di autorizzazione

    Nota:

    Lo standard OAuth 2.0 supporta almeno 2 metodi di autenticazione client durante questo passaggio (client_secret_basic e client_secret_post). Workfront Fusion invia automaticamente l'ID client e il segreto specificati tramite client_secret_post metodo. Pertanto, questi parametri vengono automaticamente inclusi nel corpo della richiesta del token.

    Per ulteriori informazioni sull’autenticazione OAuth 2.0, consulta Framework di autorizzazione OAuth 2.0.
    Aggiorna parametri token

    Aggiungi eventuali parametri da includere nella chiamata del token. I seguenti parametri standard sono sempre inclusi automaticamente e non è necessario aggiungerli.

    Parametri standard:

    • grant_type: refresh_token

    • refresh_token: token di aggiornamento più recente ottenuto dal servizio a cui ti stai connettendo

    • client_id: l’ID client ricevuto al momento della creazione dell’account viene incluso automaticamente nel corpo della richiesta

    • client_secret: il segreto client ricevuto durante la creazione dell’account viene incluso automaticamente nel corpo della richiesta

    Nota:

    Lo standard OAuth 2.0 supporta almeno 2 metodi di autenticazione client durante questo passaggio (client_secret_basic e client_secret_post). Workfront Fusion invia automaticamente l'ID client e il segreto specificati tramite client_secret_post metodo. Pertanto, questi parametri vengono automaticamente inclusi nel corpo della richiesta del token.

    Per ulteriori informazioni sull’autenticazione OAuth 2.0, consulta Framework di autorizzazione OAuth 2.0.
    Intestazioni personalizzate

    Specifica le chiavi e i valori aggiuntivi da includere nell'intestazione dei passaggi Token e Refresh Token.

    Nota:

    Lo standard OAuth 2.0 supporta almeno 2 metodi di autenticazione client durante questo passaggio (client_secret_basic e client_secret_post). Workfront Fusion non supporta automaticamente client_secret_basic metodo. Se il servizio a cui ti stai connettendo prevede che l’ID client e il segreto client vengano combinati in una singola stringa e quindi codificati in base64 nell’intestazione Autorizzazione, devi aggiungere qui l’intestazione e il valore della chiave.

    Per ulteriori informazioni sull’autenticazione OAuth 2.0, consulta Framework di autorizzazione OAuth 2.0.
    Token placement

    Seleziona se inviare il token nell'intestazione , nella stringa di query o in entrambe durante la connessione all'URL specificato.

    I token vengono generalmente inviati nell’intestazione della richiesta.
    Nome token intestazione Immetti il nome del token di autorizzazione nell’intestazione. Predefinito: Bearer.
    Nome parametro stringa query Immetti il nome del token di autorizzazione nella stringa di query. Predefinito: access_token.

  7. Clic Continua per salvare le impostazioni di connessione.

  8. Continua con Configurazione del modulo di richiesta OAuth 2.0.

Istruzioni per la creazione di una connessione a Google nel HTTP >Creare un modulo di richiesta OAuth 2.0

L'esempio seguente mostra come utilizzare il HTTP > Creare un OAuth 2.0 modulo di richiesta a cui connettersi Google.

  1. Assicurati di aver creato un progetto, configurato le impostazioni OAuth e generato le credenziali come descritto in Connetti Adobe Workfront Fusion a Google Services utilizzo di un client OAuth personalizzato.

  2. Apri HTTP >Effettuare una richiesta OAuth 2.0 modulo.

  3. Clic Aggiungi accanto alla casella di connessione.

  4. Immetti i seguenti valori:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header
    Nome connessione Immettere il nome della connessione.
    Tipo di flusso Codice autorizzazione
    Autorizza URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Ambito Aggiungere singoli ambiti. Per ulteriori informazioni sugli ambiti, consulta Ambiti OAuth 2.O per Google API nel Google documentazione.
    Separatore ambito SPACE
    ID client

    Immetti il Google ID client.

    Per creare un ID client, consulta Crea credenziali OAuth in Connect Adobe Workfront Fusion a Google Services utilizzo di un client OAuth personalizzato.
    Segreto client

    Immetti il Google Segreto client.

    Per creare un segreto client, vedi Crea credenziali OAuth in Connect Adobe Workfront Fusion a Google Servizi che utilizzano un client OAuth personalizzato.
    Autorizza parametri

    Aggiungi access_type - offline coppia chiave-valore.

    Nota: in caso di problemi di autenticazione, ad esempio con l’aggiornamento del token, prova ad aggiungere prompt - consent coppia chiave-valore.

  5. Clic Continua per salvare le impostazioni di connessione.

  6. Continua con Configurazione del modulo di richiesta OAuth 2.0.

Istruzioni per la connessione a Microsoft Graph API tramite HTTP > Effettuare una richiesta OAuth 2.0 modulo

Per istruzioni relative a Microsoft Graph API, vedi Chiama il MS Graph REST API tramite Adobe Workfront Fusion HTTP > Effettuare una richiesta OAuth 2.0 modulo.

Configurazione del modulo di richiesta OAuth 2.0

Quando hai stabilito un Oauth 2connessione .0 come descritto in Creazione di una connessione per un OAuth richiesta, continua a configurare il modulo come desiderato. Tutti i token di autorizzazione vengono inclusi automaticamente in questa richiesta e in qualsiasi altra richiesta che utilizza la stessa connessione.

Quando si configura HTTP >Effettuare una richiesta OAuth 2.0 modulo, Workfront Fusion visualizza i campi elencati di seguito. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo all’altro in Adobe Workfront Fusion.

Connection
Per informazioni sulla configurazione di una connessione, vedere Creazione di una connessione per una richiesta OAuth in questo articolo.
Valuta tutti gli stati come errori (tranne 2xx e 3xx)

Utilizza questa opzione per configurare la gestione degli errori.

Per ulteriori informazioni, consulta Gestione degli errori in Adobe Workfront Fusion.

URL
Immetti l’URL a cui desideri inviare una richiesta, ad esempio un endpoint API, un sito web, ecc.
Method
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP in Adobe Workfront Fusion.
Headers
Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard. Ad esempio: {"Content-type":"application/json"}
Stringa Di Query
Immetti le coppie chiave-valore di query desiderate.
Tipo di corpo

Il corpo HTTP è costituito dai byte di dati trasmessi in un messaggio di transazione HTTP immediatamente dopo le intestazioni, se ve ne sono altre da utilizzare.

  • Raw

    Il tipo di corpo Raw è generalmente adatto per la maggior parte delle richieste HTTP body, anche in situazioni in cui la documentazione per gli sviluppatori non specifica i dati da inviare.

    Specificare un tipo di analisi dei dati nel campo Content type.

    Nonostante il tipo di contenuto selezionato, i dati vengono immessi in qualsiasi formato stabilito o richiesto dalla documentazione per gli sviluppatori.

  • Application/x-www-form-urlencoded

    Questo tipo di corpo deve POST i dati utilizzando application/x-www-form-urlencoded.

    Per application/x-www-form-urlencoded, il corpo del messaggio HTTP inviato al server è essenzialmente una stringa di query. Le chiavi e i valori sono codificati in coppie chiave-valore separate da & e con un = tra chiave e valore.

    Per i dati binari: use multipart/form-data invece.

    Esempio:

    Esempio del formato di richiesta HTTP risultante:

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data è una richiesta multipart HTTP utilizzata per inviare file e dati. Viene comunemente utilizzato per caricare file sul server.

    Aggiungi i campi da inviare nella richiesta. Ogni campo deve contenere una coppia chiave-valore.

    • Text

      Immetti la chiave e il valore da inviare nel corpo della richiesta.

    • File

      Immetti la chiave e specifica il file di origine da inviare nel corpo della richiesta.

      Mappa il file che desideri caricare dal modulo precedente (ad esempio HTTP >Ottieni un file o Google Drive >Scarica un file), oppure immetti manualmente il nome del file e i dati del file.

Analizza risposta

Abilita questa opzione per analizzare automaticamente le risposte e convertire le risposte JSON e XML in modo da non dover utilizzare i moduli JSON > Parse JSON o XML > Parse XML.

Prima di poter utilizzare contenuti JSON o XML analizzati, esegui il modulo una volta manualmente in modo che possa riconoscere il contenuto della risposta e consentirti di mapparlo nei moduli successivi.

Timeout
Immetti il timeout della richiesta in secondi (1-300). Il valore predefinito è 40 secondi.
Condividi i cookie con altri moduli HTTP
Abilita questa opzione per condividere i cookie dal server con tutti i moduli HTTP nel tuo scenario.
Self-signed certificate
Carica il certificato se desideri utilizzare TLS con il certificato autofirmato.
Rifiuta le connessioni che utilizzano certificati non verificati (autofirmati)
Abilita questa opzione per rifiutare le connessioni che utilizzano certificati TLS non verificati.
Follow redirect
Abilita questa opzione per seguire i reindirizzamenti URL con risposte 3xx.
Segui tutti i reindirizzamenti
Abilita questa opzione per seguire i reindirizzamenti URL con tutti i codici di risposta.
Disattiva la serializzazione di più chiavi di stringa di query come matrici
Per impostazione predefinita, Workfront Fusion gestisce più valori per la stessa chiave di parametro della stringa di query URL come array. Ad esempio: www.test.com?foo=bar&foo=baz verrà convertito in www.test.com?foo[0]=bar&foo[1]=baz. Attiva questa opzione per disabilitare questa funzione.
Richiedi contenuto compresso

Abilita questa opzione per richiedere una versione compressa del sito web.

Questo aggiunge un Accept-Encoding per richiedere contenuti compressi.

Usa TLS reciproco

Abilita questa opzione per utilizzare Mutual TLS nella richiesta HTTP.

Per ulteriori informazioni su Mutual TLS, vedi Utilizzare Mutual TLS nei moduli HTTP in Adobe Workfront Fusion.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43