Introduzione ad API di Azure per FHIR
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.
Questo articolo illustra i passaggi di base per iniziare a usare l'API di Azure per FHIR®. L'API di Azure per FHIR è un'API gestita, basata su standard e conforme per i dati clinici in ambito sanitario che consente di creare soluzioni per l'analisi operativa e l'apprendimento automatico.
Come prerequisito, è necessaria una sottoscrizione di Azure e sono state concesse le autorizzazioni appropriate per creare gruppi di risorse di Azure e distribuire le risorse di Azure. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
Creare una risorsa di Azure
Per iniziare a usare API di Azure per FHIR, è necessario creare una risorsa nel portale di Azure. Immettere API di Azure per FHIR nella casella Cerca servizi e marketplace.
Dopo aver individuato la risorsa API di Azure per FHIR, selezionare Crea.
Distribuire l'API di Azure per FHIR
Vedere la procedura descritta nella Guida introduttiva per distribuire un'istanza di API di Azure per FHIR usando il portale di Azure. È anche possibile distribuire un'istanza di API di Azure per FHIR usando PowerShell, l'interfaccia della riga di comando e un modello di ARM.
Accesso ad API di Azure per FHIR
Quando si lavora con i dati sanitari, è importante assicurarsi che i dati siano sicuri e non possano essere accessibili da utenti o applicazioni non autorizzati. I server FHIR usano OAuth 2.0 per garantire la protezione dei dati. Il servizio API di Azure per FHIR è protetto tramite Microsoft Entra ID, che è un esempio di provider di identità OAuth 2.0. L'articolo Configurazione di Microsoft Entra ID per API di Azure per FHIR offre una panoramica dell'autorizzazione del server FHIR e dei passaggi necessari per ottenere un token di accesso a tale server. Anche se questi passaggi si applicano a qualsiasi server FHIR e a qualsiasi provider di identità, questo articolo illustra l'API di Azure per FHIR come server FHIR e l'ID Microsoft Entra come provider di identità. Per altre informazioni sull'accesso ad API di Azure per FHIR, vedere Panoramica del controllo di accesso.
Convalida del token di accesso
Il modo in cui l'API di Azure per FHIR convalida il token di accesso dipende dall'implementazione e dalla configurazione. L'articolo API di Azure per FHIR guida la convalida dei token di accesso tramite i passaggi di convalida, che possono essere utili per la risoluzione dei problemi di accesso.
Registrare l'applicazione client
Per consentire a un'applicazione di interagire con Microsoft Entra ID, deve essere registrata. Nel contesto del server FHIR, esistono due tipologie di registrazione dell'applicazione:
- Registrazioni dell'applicazione di risorse,
- Registrazioni dell'applicazione client.
Per altre informazioni sui due tipi di registrazione dell'applicazione, vedere Registrare le app Microsoft Entra per API di Azure per FHIR.
Configurare il controllo degli accessi in base al ruolo di Azure per FHIR
L'articolo Configurare il controllo degli accessi in base al ruolo di Azure per FHIR descrive come usare il controllo degli accessi in base al ruolo di Azure per assegnare l'accesso al piano dati di API di Azure per FHIR. Il controllo degli accessi in base al ruolo di Azure è il metodo preferito per assegnare l'accesso al piano dati quando gli utenti del piano dati vengono gestiti nel tenant di Microsoft Entra associato alla sottoscrizione di Azure. Se si usa un tenant di Microsoft Entra esterno, vedere Informazioni di riferimento sull'assegnazione del controllo degli accessi in base al ruolo locale.
Passaggi successivi
Questo articolo ha illustrato i passaggi di base per iniziare a usare API di Azure per FHIR. Per altre informazioni su API di Azure per FHIR, vedere
Nota
FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.