Configurazione di Epic EHR

Questa pagina descrive come registrare e configurare un'app Epic prima di creare il datastore EHR Epic. La tua organizzazione registra la propria app Epic. In genere, questi passaggi vengono completati dall'analista Epic.

Registra l'app Epic

Registra un'app per Gemini Enterprise in Epic on FHIR e rendila disponibile nei tuoi ambienti Epic. Utilizza le seguenti impostazioni:

Impostazione Valore
Pubblico dell'applicazione Medici o utenti amministrativi
API in entrata Le API R4 elencate in Abilita le API Epic
API in uscita Nessuno
Questa app registrerà client dinamici? No
Is Confidential Client Sì
Richiede l'accesso permanente Sì
Utilizza token di aggiornamento a rotazione Sì
URL del set JWK Lascia vuoto
Versione SMART on FHIR R4
Versione SMART Scope SMART v1
Schema di generazione degli ID FHIR Utilizza ID FHIR limitati a 64 caratteri per le risorse FHIR USCDI

Le impostazioni di accesso permanente della tua organizzazione per l'app determinano la durata dell'autorizzazione di un utente. Al termine, l'utente autorizza nuovamente il connettore.

Imposta gli URI di reindirizzamento

Nell'app, registra entrambi i seguenti URI di reindirizzamento esattamente come mostrato:

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

Abilita le API Epic

Nell'app, abilita le API di lettura e ricerca R4 per le seguenti risorse FHIR: Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization e Procedure.

Alcune risorse, come Observation e Condition, hanno un'API separata per ogni categoria, ad esempio laboratori e parametri vitali. Attiva le categorie che vuoi che gli utenti possano interrogare. Non abilitare le API di scrittura.

Se un'API non è abilitata, solo le azioni che la utilizzano non andranno a buon fine.

Ottieni l'ID client e il client secret

Epic emette un ID client non di produzione e un ID client di produzione per l'app. Utilizza l'ID client corrispondente all'ambiente Epic a cui puntano i tuoi URL. Poiché l'app è un client riservato, ha anche un client secret. Inserisci l'ID client e il client secret quando crei il datastore.

Trova gli endpoint Epic

Per creare il datastore, hai bisogno di tre URL del tuo ambiente Epic: l'URL di base FHIR R4, l'URL di autorizzazione e l'URL del token. Il tuo analista Epic può fornirteli. La configurazione SMART della tua organizzazione, all'indirizzo FHIR_BASE_URL/.well-known/smart-configuration, elenca anche l'URL di autorizzazione (authorization_endpoint) e l'URL del token (token_endpoint). Sostituisci FHIR_BASE_URL con l'URL di base FHIR R4.

Inserisci ogni URL con https:// e senza barra finale. Ad esempio, la sandbox pubblica di Epic utilizza i seguenti URL:

URL Esempio di sandbox Epic
URL di base FHIR R4 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
URL di autorizzazione https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
URL del token https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

Risoluzione dei problemi

La tabella seguente elenca i problemi comuni e come risolverli:

Problema Risoluzione
La console mostra uno dei seguenti messaggi:
  • "L'URL Epic FHIR R4 deve essere un URL https:// senza barra finale."
  • "L'URL di autorizzazione Epic deve essere un URL https:// senza barra finale."
  • "L'URL del token Epic deve essere un URL https:// senza barra finale."
 Inserisci l'URL con https:// e senza una barra finale.
La console mostra "Impossibile recuperare il token di aggiornamento". Nell'app Epic, seleziona Is Confidential Client (È un client riservato) e Requires Persistent Access (Richiede accesso permanente) e salva le modifiche. Poi, nella console Google Cloud , fai di nuovo clic su Verifica autenticazione.
Epic segnala che l'URI di reindirizzamento non corrisponde. Registra entrambi gli URI di reindirizzamento esattamente come mostrato in Imposta gli URI di reindirizzamento.
Epic mostra il messaggio "Richiesta OAuth 2.0 non valida" durante l'accesso. Ogni link di accesso a Epic funziona una sola volta, quindi ricaricando la finestra di accesso viene visualizzato questo errore. Chiudi la finestra e accedi di nuovo senza ricaricare. Se l'errore persiste, verifica che l'app disponga delle API per gli ambiti richiesti.
Resi epici invalid_client. L'ID client o il client secret sono errati, contengono spazi aggiuntivi o appartengono all'altro ambiente Epic. Inserisci l'ID client e il client secret per l'ambiente a cui puntano i tuoi URL.
La finestra di accesso non torna a Gemini Enterprise o il connettore non è autorizzato dopo l'accesso. Chiudi la finestra di accesso, ricarica Gemini Enterprise e autorizza di nuovo il connettore.
Un'azione non va a buon fine, mentre le altre funzionano. L'API Epic per questa azione non è abilitata. Attivalo nell'app e chiedi all'utente di autorizzare nuovamente il connettore.
Gemini Enterprise dice "Mi dispiace, sembra che tu non abbia l'autorizzazione per eseguire questa operazione. Contatta un amministratore." a un utente che ha autorizzato il connettore in precedenza. L'autorizzazione Epic dell'utente è terminata. L'utente autorizza nuovamente il connettore.
Gemini Enterprise non trova un paziente per nome. Aggiungi la data di nascita o utilizza l'MRN o l'ID paziente Epic.
Gemini Enterprise indica che non è stato possibile recuperare alcuni record. Epic Security nasconde questi record all'utente. Gli utenti vedono solo i record che Epic consente loro di vedere.
Il testo di un report o di una nota non è disponibile. Il documento è un PDF o un altro formato che il connettore non può leggere. Apri il documento in Epic.
L'autorizzazione continua a non riuscire in una sola app. Rimuovi il datastore Epic EHR dall'app, aggiungilo di nuovo e autorizza nuovamente il connettore.

Passaggi successivi