DocumentazioneWorkfrontAdobe Workfront Fusion

Modulo HTTP > Make an OAuth 2.0 request

Last update: Thu Jan 23 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 > Make an OAuth 2.0 request

  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 Connection del modulo fare clic su Add.

  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
    Connection name 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.
    Flow type

    Seleziona il flusso per ottenere i token.

    • Authorization Code: immetti Authorize URI e Token URI dalla documentazione API del servizio.
    • Implicit: immetti Authorize URI dalla documentazione API del servizio.
    Scope Aggiungere singoli ambiti. Puoi trovare queste informazioni nella documentazione per gli sviluppatori (API) del servizio specificato.
    Scope separator

    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.
    Client ID Immetti l'ID client. Hai ottenuto l’ID client quando hai creato un client OAuth nel servizio che desideri connettere.
    Client Secret Immetti il segreto client. Il segreto client è stato ottenuto quando hai creato un client OAuth nel servizio che desideri connettere.
    Authorize parameters

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

    Parametri standard:

    • response_type

      code per Authorization Code flow e token per Implicit flow

    • 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
    Access token parameters

    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

    • 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.
    Refresh token parameters

    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 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.
    Custom Headers

    Specificare 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

    Selezionare se inviare il token in header, query string o in entrambi durante la connessione all'URL specificato.

    I token vengono generalmente inviati nell’intestazione della richiesta.
    Header token name Immetti il nome del token di autorizzazione nell’intestazione. Impostazione predefinita: Bearer.
    Query string parameter name Immetti il nome del token di autorizzazione nella stringa di query. Impostazione predefinita: access_token.

  7. Fare clic su Continue per salvare la connessione e tornare al modulo.

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

Istruzioni per creare una connessione a Google in HTTP >Make an OAuth 2.0 request module

Nell'esempio seguente viene illustrato come utilizzare il modulo di richiesta HTTP > Make an 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 il modulo HTTP > Make an OAuth 2.0 request.

  3. Fare clic su Add 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 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name 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.
    Flow type Authorization Code
    Authorize URI https://accounts.google.com/o/oauth2/v2/auth
    Token URI https://www.googleapis.com/oauth2/v4/token
    Scope Aggiungere singoli ambiti. Per ulteriori informazioni sugli ambiti, consulta Ambiti OAuth 2.O per Google API nella documentazione di Google.
    Scope separator SPACE
    Client ID

    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.
    Client Secret

    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.
    Authorize parameters

    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. Fare clic su Continue 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 > Make an OAuth 2.0 request, 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.
Evaluate all states as errors (except for 2xx and 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"}
Query String
Immetti le coppie chiave-valore di query desiderate.
Body type

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 una forma 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 è destinato ai dati POST 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 HTTP multipart 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.

      Mappare il file che si desidera caricare dal modulo precedente (ad esempio HTTP >Get a File) oppure immettere manualmente il nome del file e i dati del file.

Parse response

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.
Share cookies with other HTTP modules
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.
Reject connections that are using unverified (self-signed) certificates
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.
Follow all redirects
Abilita questa opzione per seguire i reindirizzamenti URL con tutti i codici di risposta.
Disable serialization of multiple same query string keys as arrays
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.
Request compressed content

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

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

Use Mutual TLS

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