Condividi tramite

Registrazione dell'applicazione client per API di Azure per FHIR

  • Articolo

Importante

L'API di Azure per FHIR verrà ritirata il 30 settembre 2026. Seguire le strategie di migrazione per passare al servizio FHIR® di Servizi per i dati sanitari di Azure entro tale data. A causa del ritiro dell'API di Azure per FHIR, le nuove distribuzioni non saranno consentite a partire dal 1° aprile 2025. Il servizio FHIR di Servizi per i dati sanitari di Azure è la versione evoluta dell'API di Azure per FHIR che consente ai clienti di gestire i servizi FHIR, DICOM e MedTech con integrazioni in altri servizi di Azure.

Nell'esercitazione precedente è stata distribuita e configurata l'API di Azure per FHIR. Una volta completata la configurazione di API di Azure per FHIR, verrà registrata un'applicazione client pubblica. Per informazioni dettagliate o per la risoluzione dei problemi, è possibile leggere l'intera guida pratica su come registrare un'app client pubblica, ma in questo articolo vengono illustrati i passaggi principali per questa esercitazione.

  1. Passare a Microsoft Entra ID

  2. Selezionare Registrazione dell'app -->+ Nuova registrazione

  3. Assegnare un nome all'applicazione

  4. Selezionare Client pubblico/nativo (per dispositivi mobili e desktop) e impostare l'URL di reindirizzamento su https://www.getpostman.com/oauth2/callback.

    Screenshot del riquadro Registra un'applicazione con un nome applicazione e un URL di reindirizzamento di esempio.

Impostazioni applicazione client

Dopo aver registrato l'applicazione client, copiare l'ID applicazione (client) e l'ID tenant dalla pagina Panoramica. Questi due valori saranno necessari in un secondo momento per accedere al client.

Screenshot del riquadro delle impostazioni dell'applicazione client con l'ID applicazione e l'ID directory evidenziati.

Stabilire la connessione con l'app Web

Se l'app Web è stata scritta per connettersi con API di Azure per FHIR, occorre anche impostare le opzioni di autenticazione corrette.

  1. Nel menu a sinistra, in Gestisci, selezionare Autenticazione.

  2. Per aggiungere una nuova configurazione della piattaforma, selezionare Web.

  3. Configurare l'URI di reindirizzamento in preparazione della creazione dell'applicazione Web nella quarta parte di questa esercitazione. A tale scopo, aggiungere https://\<WEB-APP-NAME>.azurewebsites.net all'elenco degli URI di reindirizzamento. Se si sceglie un nome diverso durante il passaggio in cui si scrive l'app Web, sarà necessario tornare indietro e aggiornare questo valore.

  4. Selezionare le caselle di controllo Token di accesso e Token ID.

    Screenshot del pannello delle impostazioni di autenticazione dell'app in cui sono evidenziati i passaggi per aggiungere una piattaforma.

Aggiungere le autorizzazioni API

Dopo aver configurato l'autenticazione corretta, impostare le autorizzazioni API:

  1. Selezionare Autorizzazioni API e quindi Aggiungi un'autorizzazione.
  2. In API usate dall'organizzazione cercare le Servizi per i dati sanitari di Azure.
  3. Selezionare user_impersonation e quindi Aggiungi autorizzazioni.

Screenshot del pannello Autorizzazioni API con i passaggi per aggiungere le autorizzazioni API evidenziati.

Passaggi successivi

È ora disponibile un'applicazione client pubblica. Nell'esercitazione successiva verranno illustrate le procedure per eseguire i test e ottenere l'accesso a questa applicazione tramite Postman.

Testare l'applicazione client in Postman

FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.