Configuración de la HCE de Epic

En esta página, se describe cómo registrar y configurar una app de Epic antes de crear el almacén de datos de EHR de Epic. Tu organización registra su propia app de Epic. Por lo general, tu analista de Epic completa estos pasos.

Registra la app de Epic

Registra una app para Gemini Enterprise en Epic on FHIR y haz que esté disponible en tus entornos de Epic. Usa la siguiente configuración:

Configuración Valor
Público de la aplicación Usuarios clínicos o administrativos
APIs entrantes Las APIs de R4 que se indican en Habilita las APIs de Epic
APIs salientes Ninguno
¿Esta app registrará clientes dinámicos? No
Es un cliente confidencial Sí
Requiere acceso persistente Sí
Usa tokens de actualización rotativos Sí
URL del conjunto de JWK Deja esta opción en blanco
Versión de SMART on FHIR R4
Versión del permiso de SMART SMART v1
Esquema de generación de IDs de FHIR Usa IDs de FHIR con un límite de 64 caracteres para los recursos de FHIR de USCDI

La configuración de acceso persistente de tu organización para la app determina cuánto dura la autorización de un usuario. Cuando finaliza, el usuario vuelve a autorizar el conector.

Configura los URIs de redireccionamiento

En la app, registra los siguientes URIs de redireccionamiento exactamente como se muestra:

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

Habilita las APIs de Epic

En la app, habilita las APIs de lectura y búsqueda de R4 para los siguientes recursos de FHIR: Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization y Procedure.

Algunos recursos, como Observation y Condition, tienen una API independiente para cada categoría, por ejemplo, laboratorios y signos vitales. Habilita las categorías que quieres que consulten los usuarios. No habilites las APIs de escritura.

Si una API no está habilitada, solo fallarán las acciones que la usen.

Obtén el ID de cliente y el secreto del cliente

Epic emite un ID de cliente que no es de producción y un ID de cliente de producción para la app. Usa el ID de cliente que coincida con el entorno de Epic al que apuntan tus URLs. Como la app es un cliente confidencial, también tiene un secreto del cliente. Ingresa el ID de cliente y el secreto del cliente cuando creas el almacén de datos.

Encuentra tus extremos de Epic

Para crear el almacén de datos, necesitas tres URLs de tu entorno de Epic: la URL base de FHIR R4, la URL de autorización y la URL del token. Tu analista de Epic puede proporcionarlos. La configuración de SMART de tu organización, en FHIR_BASE_URL/.well-known/smart-configuration, también enumera la URL de autorización (authorization_endpoint) y la URL del token (token_endpoint). Reemplaza FHIR_BASE_URL por tu URL base de FHIR R4.

Ingresa cada URL con https:// y sin una barra diagonal final. Por ejemplo, la zona de pruebas pública de Epic usa las siguientes URLs:

URL Ejemplo de zona de pruebas de Epic
URL base de FHIR R4 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
URL de autorización https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
URL del token https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

Solucionar problemas

En la siguiente tabla, se enumeran los problemas habituales y cómo resolverlos:

Problema Solución
La consola muestra uno de los siguientes mensajes:
  • "La URL de Epic FHIR R4 debe ser una URL https:// sin una barra diagonal al final".
  • "La URL de autorización de Epic debe ser una URL https:// sin una barra final".
  • "La URL del token de Epic debe ser una URL https:// sin una barra final".
 Ingresa la URL con https:// y sin una barra diagonal final.
En la consola, se muestra el mensaje "No se pudo obtener el token de actualización". En la app de Epic, selecciona Is Confidential Client y Requires Persistent Access, y guarda los cambios. Luego, en la consola de Google Cloud , vuelve a hacer clic en Verificar autenticación.
Epic informa que el URI de redireccionamiento no coincide. Registra ambos URIs de redireccionamiento exactamente como se muestra en Configura los URIs de redireccionamiento.
Epic muestra el mensaje "Solicitud de OAuth 2.0 no válida" durante el acceso. Cada vínculo de acceso de Epic funciona solo una vez, por lo que, si vuelves a cargar la ventana de acceso, se mostrará este error. Cierra la ventana y vuelve a iniciar el acceso sin volver a cargar. Si el error persiste, verifica que la app tenga las APIs para los permisos solicitados.
Epic devuelve invalid_client. El ID de cliente o el secreto del cliente son incorrectos, tienen espacios adicionales o pertenecen al otro entorno de Epic. Ingresa el ID de cliente y el secreto del cliente para el entorno al que apuntan tus URLs.
La ventana de acceso no vuelve a Gemini Enterprise o el conector no está autorizado después de acceder. Cierra la ventana de acceso, vuelve a cargar Gemini Enterprise y autoriza el conector de nuevo.
Una acción falla y otras funcionan. La API de Epic para esa acción no está habilitada. Habilítala en la app y, luego, haz que el usuario vuelva a autorizar el conector.
Gemini Enterprise dice "Lo siento, parece que no tienes permiso para realizar esta operación. Comunícate con un administrador" a un usuario que ya haya autorizado el conector. Finalizó la autorización de Epic del usuario. El usuario vuelve a autorizar el conector.
Gemini Enterprise no encuentra un paciente por su nombre. Agrega la fecha de nacimiento o usa el MRN o el ID de paciente de Epic.
Gemini Enterprise indica que no se pudieron recuperar algunos registros. La seguridad de Epic oculta estos registros al usuario. Los usuarios solo ven los registros que Epic les permite ver.
El texto de un informe o una nota no está disponible. El documento está en formato PDF o en otro formato que el conector no puede leer. Abre el documento en Epic.
La autorización sigue fallando en una sola app. Quita el almacén de datos de Epic EHR de la app, vuelve a agregarlo y autoriza el conector de nuevo.

¿Qué sigue?