Esercizio - Uso di API Graph da un connettore personalizzato

Completato

In questo esercizio un connettore personalizzato verrà creato e configurato per l'accesso all'API di Microsoft Graph usando l'autenticazione di Microsoft Entra ID. Poiché l'argomento principale su cui verte l'esercizio è l'autenticazione, verrà configurata solo una singola azione chiamata Ultimo utilizzo.

Importante

Usare un ambiente di test in cui sia stato effettuato il provisioning di Microsoft Dataverse. Se non si dispone di un ambiente di test, è possibile iscriversi al piano della community.

Attività 1 - Creazione di una nuova soluzione

Per creare una nuova soluzione, effettuare i seguenti passaggi:

  1. Accedere a Power Apps Maker Portal e assicurarsi di essere nell'ambiente corretto.

  2. Selezionare Soluzioni > + Nuova soluzione.

  3. Immettere Grafico Contoso nel campo Nome visualizzato, selezionare CDS Default Publisher nel campo Autore, quindi scegliere Crea. Nota: quando si lavora con un progetto reale, è preferibile creare un autore personalizzato.

    Screenshot della finestra di creazione di una nuova soluzione.

  4. Non chiudere questa pagina dopo aver selezionato Crea.

Attività 2 - Uso di Graph explorer per il testing dell'API

In questa attività verrà usato Graph explorer per eseguire un'azione API che verrà configurata nel connettore personalizzato.

  1. In una nuova scheda del browser andare a Graph explorer.

  2. Selezionare Accedi.

    Screenshot del pulsante di accesso a Graph explorer.

  3. Effettuare l'accesso specificando le informazioni utente corrette.

  4. Leggere le condizioni di autorizzazione richieste e quindi accettarle per continuare.

  5. Assicurarsi che GET sia selezionato per il verbo, aggiungere /insights/used all'URL, quindi selezionare Esegui query.

    Screenshot del menu GET, URL e pulsante Esegui query.

  6. Verrà restituito un errore 403 a indicare che Graph explorer non dispone dell'autorizzazione necessaria per eseguire questa azione.

  7. Selezionare la scheda Modifica autorizzazioni per concedere l'autorizzazione a Graph explorer.

  8. Selezionare Consenso per Sites.Read.All.

  9. Leggere le condizioni di autorizzazione richieste e quindi accettarle per continuare.

  10. Selezionare di nuovo Esegui query.

    Verrà visualizzato lo stato OK - 200.

    Screenshot dell'anteprima della risposta della query.

  11. Aprire una scheda per una nuova sessione del browser.

  12. Passare a Spazio di archiviazione OneDrive cloud personale ed eseguire l'accesso.

  13. Selezionare + Nuovo e selezionare Documento Word. Il nuovo documento creato consentirà di avere alcuni contenuti nell'elenco Ultimo utilizzo.

    Screenshot del pulsante di creazione di un nuovo documento di Word.

  14. Immettere del testo di prova nel file di Word. Il documento verrà salvato automaticamente.

  15. Tornare alla finestra Graph explorer.

  16. Eseguire di nuovo la stessa query.

    Verrà visualizzata una risposta con valori. Se non si ottiene una risposta, tornare al documento creato in OneDrive e apportare le modifiche, quindi tornare indietro ed eseguire di nuovo la query.

  17. Selezionare il codice JSON della risposta, fare clic con il pulsante destro del mouse, selezionare Copia e quindi salvare il file.

    Screenshot della risposta JSON selezionata con la funzione Copia.

    Questa risposta sarà necessaria più avanti in questo esercizio perché verrà usata per la configurazione della risposta nel connettore personalizzato.

Attività 3 - Registrazione di una nuova applicazione e aggiunta delle autorizzazioni

In questa attività si configurerà una nuova applicazione che verrà usata per accedere all'API Graph dal connettore personalizzato. Si configureranno inoltre le autorizzazioni per le specifiche azioni dell'API Graph in modo analogo alla modifica delle autorizzazioni eseguita in Graph explorer.

  1. Passare a Microsoft Azure ed effettuare l'accesso usando le credenziali dell'utente amministratore.

  2. Selezionare Mostra menu Portale, quindi selezionare Microsoft Entra ID.

    Screenshot del pulsante di spostamento di Microsoft Entra ID.

  3. Selezionare Registrazione app > + Nuova registrazione.

    Screenshot del pulsante di creazione di una nuova registrazione dell'applicazione.

  4. Immettere Learn last used connector nel campo Nome, selezionare Web, immettere https://global.consent.azure-apim.net/redirect nel campo URI di reindirizzamento e quindi selezionare Registra.

    Screenshot della finestra Registra un'applicazione.

  5. Selezionare Autorizzazioni API e quindi selezionare + Aggiungi un'autorizzazione.

  6. Selezionare Microsoft Graph.

  7. Selezionare Autorizzazioni delegate.

  8. Cercare ed espandere la voce Siti.

  9. Selezionare Sites.Read.All, Sites.ReadWrite.All e quindi selezionare Aggiungi autorizzazioni.

    Screenshot della finestra di selezione delle autorizzazioni.

  10. Saranno ora disponibili tre autorizzazioni API. Selezionare Certificati e segreti.

    Screenshot del menu Certificati e segreti con tre autorizzazioni API.

  11. Selezionare + Nuovo segreto client.

    Screenshot del pulsante Nuovo segreto client.

  12. Immettere Last used connector action nel campo Descrizione, selezionare 90 giorni nel campo Scadenza e quindi selezionare Aggiungi.

  13. Copiare il contenuto del campo Valore e salvarlo per l'uso futuro perché non verrà più visualizzato. Il segreto utente copiato verrà usato durante la creazione del connettore.

    Screenshot della finestra Segreti client.

  14. Selezionare Panoramica.

  15. Copiare il valore del campo ID applicazione (client) e salvalo in un blocco note. L'ID client copiato verrà usato durante la creazione del connettore.

    Screenshot dell'ID dell'applicazione (client) con la funzione di copia.

Attività 4 - Creazione di un connettore personalizzato

Per creare un connettore personalizzato, effettuare i passaggi seguenti:

  1. Passare al portale di amministrazione di Power Apps e verificare di trovarsi nell'ambiente corretto.

  2. Selezionare Soluzioni, quindi selezionare la soluzione Contoso graph creata nell'Attività 1 - Creazione di una nuova soluzione.

  3. Selezionare + Nuovo > Automazione > Connettore personalizzato.

    Screenshot del menu Nuovo con l'opzione Connettore personalizzato selezionata.

  4. Immettere Grafico Contoso nel campo Nome connettore.

    Screenshot della voce Grafico Contoso immessa come nome del connettore.

  5. Scorrere verso il basso, immettere graph.microsoft.com nel campo Host e /v1.0 nel campo URL di base.

  6. Selezionare Sicurezza.

    Screenshot dei campi Host e URL di base con il pulsante Sicurezza.

  7. Selezionare OAuth 2.0 nel campo Autenticazione.

  8. Selezionare Microsoft Entra ID nel campo Provider di identità.

  9. Incollare l'ID copiato in Azure nel campo ID client e quindi incollare il valore copiato in Azure nel campo Segreto client.

  10. Immettere https://graph.microsoft.com nel campo URL risorsa e quindi selezionare Crea connettore.

    Screenshot del pulsante Crea connettore.

  11. Rimanere su questa pagina.

Attività 5 - Aggiunta dell'azione

In questa attività si configurerà il suggerimento relativo all'ultima azione usata denominata API Graph.

  1. Selezionare Definizione > + Nuova azione.

    Screenshot del pulsante Nuova azione nella finestra Definizione.

  2. Immettere Ultimo utilizzo nel campo Riepilogo e LastUsed nel campo ID operazione.

  3. Passare alla sezione Richiesta e selezionare + Importa da esempio.

    Screenshot del pulsante Importa da esempio nella sezione Richiesta.

  4. Selezionare GET per il verbo, immettere /me/insights/used nel campo URL e quindi selezionare Importa.

  5. Scorrere verso il basso e selezionare la risposta predefinita.

    Screenshot della risposta predefinita nella sezione Risposta.

  6. Selezionare + Importa da esempio.

    Screenshot del pulsante Importa da esempio.

  7. Incollare la risposta copiata in Graph explorer nel campo Corpo e quindi selezionare Importa.

    Screenshot della risposta nel campo Corpo e il pulsante Importa.

  8. Selezionare Aggiorna connettore.

  9. Rimanere su questa pagina.

Attività 6: verifica del connettore

Per verificare il funzionamento del connettore, effettuare i passaggi seguenti:

  1. Selezionare la scheda Test e quindi selezionare + Nuova connessione.

    Screenshot del pulsante Nuova connessione nella scheda Test.

  2. Specificare le credenziali.

  3. Leggere le condizioni di autorizzazione richieste e quindi accettarle per continuare.

  4. Selezionare Aggiorna per aggiornare le connessioni.

  5. Selezionare Verifica operazione.

    Screenshot del pulsante Verifica operazione evidenziato.

    Viene visualizzato lo stato 200 e la risposta dovrebbe essere simile a quella illustrata nella figura seguente.

    Screenshot dello stato 200 e dell'esempio di risposta.