Chiamare l’API REST di MS Graph
Molti servizi web di Microsoft sono accessibili tramite l’API di Microsoft Graph. Puoi creare una connessione all’API di Microsoft Graph utilizzando Workfront Fusion HTTP > Creare un modulo di richiesta OAuth 2.0.
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:
| 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: qualsiasi |
| Prodotto |
Nuovo:
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 licenze di Adobe Workfront Fusion, vedere Licenze di Adobe Workfront Fusion.
Registrazione di Workfront Fusion nel portale di registrazione delle applicazioni Microsoft
Per creare una connessione all’API REST di Microsoft Graph, devi prima registrare Adobe Workfront Fusion.
-
Inizia a registrare una nuova applicazione come descritto in Registra un'applicazione con Microsoft identity platform nella documentazione di Microsoft.
Come parte della registrazione, Microsoft richiede le seguenti informazioni:
Nome applicazione Immettere un nome per l'applicazione, ad esempio "Applicazione Workfront Fusion personale". Reindirizza URL https://app.workfrontfusion.com/oauth/cb/oauth2 -
Dopo aver completato la registrazione dell’app, annota l’ID applicazione.
IMPORTANTPer configurare la connessione in Workfront Fusion è necessario disporre dell'ID applicazione. -
Genera un segreto client. Prendi nota di questo segreto.
Per istruzioni, vedere Registrare un'applicazione con Microsoft identity platform nella documentazione di Microsoft.
IMPORTANTPer configurare la connessione in Workfront Fusion è necessario il segreto client. -
Configura le autorizzazioni per l’applicazione.
Per informazioni specifiche su come individuare e configurare questi campi, vedere la sezione "Configurare le autorizzazioni per Microsoft Graph" in Ottenere l'accesso senza un utente nella documentazione di Microsoft.
Che tipo di autorizzazioni richiede l’applicazione?SelezionareDelegated permissions.Seleziona autorizzazioniSeleziona le seguenti autorizzazioni:
-
offline_access -
openid -
Qualsiasi altra autorizzazione richiesta dalle integrazioni (Esempio:
User.Read)
Importante: per configurare la connessione in Workfront Fusion sono necessarie le autorizzazioni selezionate.
-
-
Continua con Configurare la connessione API di MS Graph in Workfront Fusion.
Configurare la connessione API di MS Graph in Workfront Fusion
Dopo aver registrato Workfront Fusion come descritto in Registrare Workfront Fusion nel portale di registrazione delle applicazioni Microsoft, è possibile configurare la connessione nel modulo di richiesta HTTP > Crea OAuth 2.0.
-
Aggiungi un HTTP > Effettua una chiamata OAuth 2.0 al tuo scenario.
-
Fai clic su Aggiungi accanto al campo di connessione.
-
Configura i campi di connessione come segue:
Nome connessioneImmettere un nome per la connessione.AmbienteSeleziona se ti connetti a un account di produzione o non di produzione.TipoSpecificare se ci si connette a un account di servizio o a un account personale.Tipo di flussoSelezionareAuthorization Code.Autorizza URIImmetterehttps://login.microsoftonline.com/common/oauth2/v2.0/authorize.URI tokenImmetterehttps://login.microsoftonline.com/common/oauth2/v2.0/token.LimiteImmettere le autorizzazioni selezionate durante la registrazione, come descritto in Registra Workfront Fusion nel portale di registrazione applicazioni di Microsoft.
Per ogni ambito, fare clic su Aggiungi e digitare l'autorizzazione.
Esempio:
offline_access.Separatore ambitoSelezionareSPACE.ID clientImmettere l'ID applicazione dal passaggio 2 in Registra Workfront Fusion nel portale di registrazione applicazioni Microsoft.Segreto clientImmettere il segreto client generato al passaggio 3 in Registra Workfront Fusion nel portale di registrazione applicazioni Microsoft.Autorizza parametriAggiungi i seguenti parametri di autorizzazione. Per ogni parametro che si sta aggiungendo, fare clic su Aggiungi elemento e immettere quanto segue:
-
Chiave:
response_modeValore:query -
Chiave:
promptValore:consent
Parametri del token di accessoNon è necessario immettere alcun valore in questo campo.Aggiorna parametri token-
Fare clic su Aggiungi elemento.
-
Nel campo Chiave immettere
scope. -
Nel campo Valore immettere tutti gli ambiti immessi nel campo di ambito, separati da spazi.
Esempio:
offline_access openid User.Read
Intestazioni personalizzateNon è necessario immettere alcun valore in questo campo.Posizionamento tokenIn the header -
-
Fai clic su Continua.
-
Nella finestra visualizzata, fai clic su Accetta per completare la connessione e tornare al modulo.