È possibile connettere l'implementazione OAuth di Studio tramite Postman, un'applicazione che semplifica lo sviluppo di API. Prima di iniziare qualsiasi passaggio di questo articolo, verificare di avere accesso a Postman in un browser web o di averlo scaricato e installato, e di avere accesso a un account Studio in grado di generare un ID client e un segreto OAuth. Per ulteriori informazioni sull'API di Studio, consultare la documentazione dell'API pubblica di Studio .
Nota: le integrazioni che utilizzano l'URI di reindirizzamento urn:ietf:wg:oauth:2.0:oob nel flusso OAuth devono aggiungerlo esplicitamente all'elenco degli URI di reindirizzamento nella chiave sviluppatore.
Apri Postman
In Postman, fai clic sull'icona Raccolte [1].
Fai clic sull'icona Più [2] e poi fai clic sull'opzione Raccolta vuota [3].
Crea collezione
Inserisci un nome per la collezione.
Apri la scheda Autorizzazione
Nella raccolta, fai clic sulla scheda Autorizzazione [1].
Fai clic sul menu a discesa Tipo di autorizzazione [2] e seleziona l'opzione OAuth 2.0 [3].
Scorri fino alla sezione Configura nuovo token e inserisci un nome per il token.
Nota: se si utilizza l'applicazione desktop di Postman, potrebbe essere necessario selezionare la casella di controllo "Autorizza tramite browser".
Open Canvas
Per individuare l'URL di autenticazione e l'URL del token di accesso, apri Canvas in una nuova finestra del browser. In Canvas, fai clic sul collegamento Admin [1], quindi fai clic sul nome del tuo account [2].
Apri la scheda App
Nella navigazione dell'account, fai clic sul collegamento Impostazioni [1], quindi fai clic sulla scheda App [2].
Fai clic sul pulsante Visualizza configurazioni app [3].
Trova l'app Studio
Nell'elenco delle app esterne, individua Studio. Quindi, fai clic sul pulsante Impostazioni [1] e seleziona l'opzione Modifica [2].
Visualizza i dettagli di configurazione dell'app
Nella finestra Modifica app, copia l' URL di avvio fino alla prima barra dopo il nome host, esclusa quest'ultima.
Aggiungere URL in Postman
In Postman, incolla l'URL di avvio di Studio sia nel campo URL di autenticazione che nel campo URL del token di accesso.
Alla fine del campo URL di autenticazione [1], aggiungere /api/public/oauth/authorize all'URL.
Alla fine del campo URL del token di accesso [2], aggiungere /api/public/oauth/token all'URL.
Copia URL di callback
Per creare una chiave sviluppatore in Studio, avrai bisogno dell'URL di callback di Postman. Copia l'URL di callback.
Studio aperto
Apri Studio, sia tramite la tua istanza Studio autonoma che tramite Canvas.
In Studio, fai clic sul collegamento Impostazioni [1] e poi sulla scheda Chiavi sviluppatore [2]. Per aggiungere una nuova chiave sviluppatore, fai clic sul pulsante Aggiungi chiave sviluppatore [3].
Crea la chiave sviluppatore di Studio
Nella finestra Impostazioni tasto, immettere un nome per il tasto nel campo Nome [1].
Nel campo URI di reindirizzamento [2], incolla l'URL di callback che hai copiato da Postman.
Una volta definiti i dettagli della chiave, fai clic sul pulsante Salva chiave [3].
Nota: le integrazioni che utilizzano l'URI di reindirizzamento urn:ietf:wg:oauth:2.0:oob nel flusso OAuth devono aggiungerlo esplicitamente all'elenco degli URI di reindirizzamento nella chiave sviluppatore.
Copia ID client e segreto
La nuova chiave sviluppatore viene visualizzata in Studio. Copia l' ID client [1]. Per visualizzare il segreto, fai clic sul pulsante Mostra [2] e poi copia il segreto [2].
Ottieni un nuovo token di accesso
In Postman, incolla l'ID client e il segreto client da Studio nei campi corrispondenti [1]. I campi rimanenti sono facoltativi.
Dopo aver inserito tutti i dettagli del token, fai clic sul pulsante Ottieni nuovo token di accesso [2].
Accedi a Studio
Si aprirà una finestra pop-up o una nuova scheda che ti chiederà di accedere a Studio. Puoi accedere utilizzando le credenziali del tuo account Studio autonomo [1] oppure utilizzando le credenziali di Canvas [2].
Autorizzare il postino
Studio ti chiederà di autorizzare l'accesso a Postman. Nella finestra di Studio, fai clic sul pulsante Autorizza .
Visualizza la scadenza del token
Dopo aver confermato l'autorizzazione per il token, Postman visualizza i dettagli del token. I token hanno una disponibilità limitata. Nella sezione "Token corrente" vengono visualizzati l'ora e la data di scadenza del token.
