DocumentazioneWorkfrontAdobe Workfront Fusion

HTTP > Crea una richiesta OAuth 2.0

Last update: Tue Mar 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:
NOTE
Adobe Workfront Fusion richiede una licenza Adobe Workfront Fusion oltre a una licenza Adobe Workfront.

Per effettuare una richiesta HTTP(S) Adobe Workfront Fusion 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, vedere Il framework di autorizzazione OAuth 2.0.

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

Requisiti di accesso

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront Qualsiasi
Licenza Adobe Workfront

Nuovo: Standard

Oppure

Corrente: Lavoro o versione successiva
Licenza Adobe Workfront Fusion**

Corrente: nessun requisito di licenza Workfront Fusion.

Oppure

Legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro
Prodotto

Nuovo:

  • Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion.
  • Pacchetto Ultimate Workfront: è incluso Workfront Fusion.

Oppure

Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

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

Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

Crea una connessione per una richiesta OAuth

Istruzioni generali per la creazione di una connessione nel modulo HTTP > Crea una richiesta OAuth 2.0

  1. Creare un client OAuth nel servizio target con cui si desidera che Adobe Workfront Fusion comunichi. Questa opzione si trova probabilmente nella sezione Developer del servizio specificato.

    1. Durante la creazione di un client, immettere l'URL appropriato nel campo Redirect URL o Callback URL:

      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 chiamano questi 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 Authorize URI e Token URI nella documentazione API del servizio specificato. Si tratta di indirizzi URL tramite i quali Workfront Fusion comunica con il servizio target. Gli indirizzi vengono utilizzati per l’autorizzazione OAuth.

    note note
    NOTE
    Se il servizio utilizza il flusso implicito, sarà necessario solo Authorize URI.

  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 HTTP > Crea un modulo di richiesta OAuth 2 allo scenario.

  5. Nel campo Connessione del modulo fare 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 17-row-2 18-row-2 layout-auto html-authored no-header
    Nome connessione Immettere il nome della connessione.
    Environment Seleziona se utilizzi un ambiente di produzione o non di produzione.
    Type Seleziona se utilizzi un account di servizio o un account personale.
    Tipo di flusso

    Seleziona il flusso per ottenere i token.

    • Codice di autorizzazione: immetti Authorize URI e Token URI nella documentazione API del servizio.
    • Implicit: immetti 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.

    Avviso: se il separatore non è impostato correttamente, Workfront Fusion non riesce a creare la connessione e viene visualizzato 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 Flusso codice di autorizzazione 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 durante la 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

    • code: 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 il metodo client_secret_post. Pertanto, questi parametri vengono automaticamente inclusi nel corpo della richiesta del token.

    Per ulteriori informazioni sull'autenticazione OAuth 2.0, vedere Il 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 ci si connette

    • client_id: l'ID client ricevuto durante la 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 il metodo client_secret_post. Pertanto, questi parametri vengono automaticamente inclusi nel corpo della richiesta del token.

    Per ulteriori informazioni sull'autenticazione OAuth 2.0, vedere Il 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 il metodo client_secret_basic. 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, vedere Il 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. Impostazione predefinita: Bearer.
    Nome parametro stringa query Immetti il nome del token di autorizzazione nella stringa di query. Impostazione predefinita: access_token.

  7. Fai clic su Continua per salvare la connessione e tornare al modulo.

  8. Continua con Configurare il modulo di richiesta Make a OAuth 2.0.

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

Nell'esempio seguente viene illustrato come utilizzare HTTP > Creare un modulo di richiesta OAuth 2.0 per connettersi a Google.

  1. Assicurati di aver creato un progetto, configurato le impostazioni OAuth e generato le tue credenziali come descritto nell'articoloConnetti Adobe Workfront Fusion a Google Services utilizzando un client OAuth personalizzato.

  2. Apri HTTP > Crea una richiesta OAuth 2.0.

  3. In qualsiasi modulo, fai clic su Aggiungi accanto alla casella 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 9-row-2 10-row-2 layout-auto html-authored no-header
    Nome connessione Immettere un nome per la connessione.
    Environment Seleziona se utilizzi un ambiente di produzione o non di produzione.
    Type Seleziona se utilizzi un account di servizio o un account personale.
    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 nella documentazione di Google.
    Separatore ambito SPACE
    ID client

    Immetti l'ID client Google.

    Per creare un ID client, vedi Creare credenziali OAuth nell'articolo da Connect Adobe Workfront Fusion a Google Services utilizzando un client OAuth personalizzato.
    Segreto client

    Immetti il segreto client Google.

    Per creare un segreto client, vedere Creare credenziali OAuth nell'articolo Connect Adobe Workfront Fusion per Google Servizi tramite 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 la coppia chiave-valore prompt - consent .

  5. Fai clic su Continua per salvare le impostazioni di connessione.

  6. Continua con Configurare il modulo di richiesta Make a OAuth 2.0.

Configurare il modulo di richiesta Make an OAuth 2.0

Dopo aver stabilito una connessione OAuth 2.0, 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 configuri il modulo HTTP > Esegui una richiesta OAuth 2.0, 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, vedere Mappare le informazioni da un modulo all'altro in Adobe Workfront Fusion.

Attiva/Disattiva mappa

Connection
Per informazioni sulla configurazione di una connessione, vedere Creare 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, vedere Gestione degli errori.

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, vedere Metodi di richiesta HTTP.
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 pubblicare 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 la chiave e il valore.

    Per i dati binari, use multipart/form-data.

    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.

    • Testo

      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 > Get a 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
Per utilizzare un certificato autofirmato o una chiave privata per TLS, fai clic su Estrai e specifica il file e la password del certificato o della chiave privata.
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.

Aggiunge un'intestazione Accept-Encoding per richiedere contenuto compresso.

Usa TLS reciproco

Abilita questa opzione per utilizzare Mutual TLS nella richiesta HTTP.

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3