In questa esercitazione viene illustrato come registrare un file Swagger che descrive un'API di Azure Resource Manager (ARM e come connettersi ad esso in PowerApps.

Prerequisiti

Abilitare l'autenticazione in Azure Active Directory

Per prima cosa è necessario creare un'applicazione di Azure Active Directory (AAD) che eseguirà l'autenticazione quando viene chiamato l'endpoint dell'API di ARM.

  1. Accedere al portale di Azure. Se si usano più tenant Azure Active Directory, controllare il nome utente in alto a destra per verificare di essere connessi alla directory corretta.

    Nome utente

  2. Fare clic su Altri servizi nel menu a sinistra. Digitare Azure Active Directory nella casella di testo Filtro e quindi fare clic su Azure Active Directory.

    Azure Active Directory

    Si apre il pannello di Azure Active Directory.

  3. Nel menu del pannello di Azure Active Directory fare clic su Registrazioni per l'app.

    Registrazioni per l'app

  4. Nell'elenco delle applicazioni registrate fare clic su Aggiungi.

    Pulsante Aggiungi

  5. Digitare un nome per l'applicazione, lasciare selezionato App Web/API, quindi per URL di accesso digitare https://login.windows.net. Fare clic su Crea.

    Nuovo modulo di app

  6. Fare clic sulla nuova applicazione nell'elenco.

    Nuova app nell'elenco

    Viene visualizzato il pannello App registrata. Prendere nota dell'ID applicazione. Sarà necessario in un secondo tempo.

  7. A questo punto dovrebbe aprirsi anche il pannello Impostazioni. Se non si è aperto, fare clic sul pulsante Impostazioni.

    Pulsante Impostazioni

  8. Nel pannello Impostazioni fare clic su URL di risposta. Nell'elenco di URL aggiungere https://msmanaged-na.consent.azure-apim.net/redirect e fare clic su Salva.

    URL di risposta

  9. Tornare al pannello Impostazioni e fare clic su Autorizzazioni necessarie. Fare clic su Aggiungi nel pannello Autorizzazioni necessarie.

    Autorizzazioni necessarie

    Viene visualizzato il pannello Aggiungi accesso all'API.

  10. Fare clic su Selezionare un'API. Nel pannello visualizzato fare clic sull'opzione per l'API Gestione dei servizi di Azure e quindi su Seleziona.

    Selezionare un'API

  11. Fare clic su Selezionare le autorizzazioni. In Autorizzazioni delegate fare clic su Access Azure Service Management as organization users (Accesso a gestione dei servizi di Azure come utenti dell'organizzazione), quindi fare clic su Seleziona.

    Autorizzazioni delegate

  12. Nel pannello Aggiungi accesso all'API fare clic su Chiudi.

  13. Tornare al pannello Impostazioni e fare clic su Chiavi. Nel pannello Chiavi digitare una descrizione della chiave, selezionare un periodo di scadenza e quindi fare clic su Salva. Verrà visualizzata la nuova chiave. Prendere nota del valore della chiave, che sarà anch'esso necessario in un secondo momento. Ora è possibile chiudere il portale di Azure.

    Creare una chiave

Aggiungere la connessione in PowerApps

Completata la configurazione dell'applicazione di AAD, è possibile aggiungere l'API personalizzata.

  1. In powerapps.com fare clic su Connessioni nel menu a sinistra. Quindi fare clic su Nuova connessione in alto a destra.

    Suggerimento:

    Se non si trova il menu, è possibile che sia sotto un pulsante hamburger nell'angolo superiore sinistro dei browser per dispositivi mobili.

  2. Fare clic su Personalizzato per visualizzare l'elenco delle connessioni personalizzate, quindi fare clic su Nuova API personalizzata.

    Nuova API personalizzata

  3. Digitare un nome per la connessione e quindi caricare il file Swagger di ARM di esempio. Fare clic su Avanti.

    Connettersi a un nuovo endpoint API

  4. Nella schermata successiva, dato che il file Swagger usa l'applicazione di AAD per l'autenticazione, è necessario inserire alcune informazioni sull'applicazione in PowerApps. In ID client digitare l'ID applicazione di AAD annotato in precedenza. Usare la chiave per il segreto client. Infine per URL risorsa digitare https://management.core.windows.net/.

    Importante:

    Assicurarsi di includere l'URL risorsa esattamente come è stato scritto in precedenza, inclusa la barra finale.

    Impostazioni OAuth

  5. L'API personalizzata è ora registrata e può essere usata all'interno di PowerApps o Microsoft Flow.

    API personalizzata aggiunta

Nota:

Il file Swagger di esempio non definisce l'intero set di operazioni di ARM e attualmente contiene solo l'operazione di elenco di tutte le sottoscrizioni. È possibile modificare questo Swagger o creare un altro file Swagger con l'editor online di Swagger.

Questo processo può essere usato per accedere a qualsiasi API RESTful autenticata usando AAD.

Passaggi successivi

Per informazioni dettagliate su come creare un'app, vedere l'argomento relativo alla creazione di un'app da dati.

Per altre informazioni sull'uso di un flusso in un'app, vedere l'argomento relativo all'avvio di un flusso in un'app.

Per eventuali domande o commenti sulle API personalizzate, entrare nella community.