Comparteix a través de

Configuración de un conector para importar datos de auditoría de Epic EHR (versión preliminar)

  • Article

Puede configurar un conector de datos para importar registros de auditoría para la actividad del usuario en el sistema Epic Electronic Healthcare Records (EHR) de su organización. Los registros de auditoría del sistema EPIC EHR incluyen registros de eventos relacionados con el acceso a los registros de salud de un paciente. La solución Microsoft Purview Insider Risk Management puede usar los registros de auditoría de EPIC EHR para ayudar a proteger su organización frente al acceso no autorizado a la información de los pacientes.

La configuración de un conector epic consta de las siguientes tareas:

  • La creación de una aplicación en Microsoft Entra ID para acceder a un punto de conexión de API que acepta un archivo de texto separado por tabulaciones que contiene registros de auditoría de Epic EHR.

  • Crear un archivo de texto con todos los campos necesarios tal como se define en el esquema del conector.

  • Creación de una instancia del conector de Epic en el portal de Microsoft Purview o en la portal de cumplimiento Microsoft Purview.

  • Ejecución de un script para insertar registros de auditoría de Epic EHR en el punto de conexión de API.

  • Opcionalmente, puede programar el script para que se ejecute automáticamente para importar registros de auditoría.

Si desea participar en la versión preliminar, póngase en contacto con el equipo en dcfeedback@microsoft.com.

Sugerencia

Si no es cliente de E5, use la prueba de 90 días de soluciones de Microsoft Purview para explorar cómo las funcionalidades adicionales de Purview pueden ayudar a su organización a administrar las necesidades de cumplimiento y seguridad de los datos. Comience ahora en el centro de pruebas del portal de cumplimiento de Microsoft Purview. Obtenga más información sobre términos de suscripción y prueba.

Antes de configurar el conector

  • Al usuario que crea el conector de Epic en el paso 3 se le debe asignar el rol Administración conector de datos. Este rol es necesario para agregar conectores en la página Conectores de datos en el portal de Microsoft Purview o en el portal de cumplimiento. Este rol se agrega de forma predeterminada a varios grupos de roles. Para obtener una lista de estos grupos de roles, consulte Roles en Microsoft Defender para Office 365 y cumplimiento de Microsoft Purview. Como alternativa, un administrador de su organización puede crear un grupo de roles personalizado, asignar el rol Administración conector de datos y, a continuación, agregar los usuarios adecuados como miembros. Para obtener instrucciones, consulte:

  • Debe determinar cómo recuperar o exportar los datos del sistema DE EHR epic de su organización (a diario) y crear un archivo de texto que se describe en el paso 2. El script que ejecute en el paso 4 insertará los datos del archivo de texto en el punto de conexión de API.

  • El script de ejemplo que se ejecuta en el paso 4 inserta los registros de auditoría de Epic EHR desde el archivo de texto a la API del conector para que la solución de administración de riesgos internos pueda usarla. Este script de ejemplo no se admite en ningún servicio o programa de soporte técnico estándar de Microsoft. El script de ejemplo aparece "TAL CUAL", sin garantía de ningún tipo. Además, Microsoft no se hace responsable de cualquier garantía implícita, incluyendo, de manera enunciativa pero no limitativa, cualquier garantía implícita de comercialización o de calidad para cualquier propósito. Cualquier riesgo resultante del uso o rendimiento del script y la documentación de ejemplo será únicamente responsabilidad suya. En ningún caso Microsoft, sus autores o cualquier persona involucrada en su creación, producción o entrega de los scripts será responsable de cualquier daño (incluidos, de manera enunciativa pero no limitativa, daños por pérdidas de beneficios de una empresa, interrupción de la actividad de una empresa, pérdidas de información de una empresa, o cualquier otro daño pecuniario), incluso si Microsoft supiera de la posibilidad de tales daños.

Paso 1: Crear una aplicación en Microsoft Entra ID

El primer paso es crear y registrar una nueva aplicación en Microsoft Entra ID. La aplicación se corresponderá con el conector epic que cree en el paso 3. La creación de esta aplicación permite Microsoft Entra ID autenticar la solicitud de inserción para el archivo de texto que contiene registros de auditoría de EPIC EHR. Durante la creación de esta aplicación Microsoft Entra, asegúrese de guardar la siguiente información. Estos valores se usarán en pasos posteriores.

  • Microsoft Entra identificador de aplicación (también denominado id. de aplicación o id. de cliente)
  • Microsoft Entra secreto de aplicación (también denominado secreto de cliente)
  • Id. de inquilino (también denominado id. de directorio)

Para obtener instrucciones paso a paso para crear una aplicación en Microsoft Entra ID, consulte Registro de una aplicación con el Plataforma de identidad de Microsoft.

Paso 2: Preparación de un archivo de texto con registros de auditoría de Epic EHR

El siguiente paso consiste en crear un archivo de texto que contenga información sobre el acceso de los empleados a los registros de salud de los pacientes en el sistema DE EHR epic de la organización. Como se explicó anteriormente, debe determinar cómo generar este archivo de texto desde el sistema EPIC EHR. El flujo de trabajo del conector de Epic requiere un archivo de texto con valores separados por tabulaciones para asignar esos datos en el archivo de texto con el esquema de conector necesario. El formato de archivo admitido es un archivo .txt separado por tabulaciones o por canalización.

Nota:

El tamaño máximo del archivo de texto que contiene los datos de auditoría es de 3 GB. El número máximo de filas es de 5 millones. Además, asegúrese de incluir solo los datos de auditoría pertinentes de su sistema de EHR sanitario.

En la tabla siguiente se enumeran los campos necesarios para habilitar escenarios de administración de riesgos internos. Un subconjunto de estos campos es obligatorio. Estos campos se resaltan con un asterisco (*). Si falta alguno de los campos obligatorios en el archivo de texto, el archivo no se validará y no se importarán los datos del archivo.

Campo Categoría
ACCESS_LOG. ACCESS_TIME*
ACCESS_LOG_METRIC. METRIC_NAME*
ACCESS_LOG. WORKSTATION_ID
ZC_METRIC_GROUP.NAME
ZC_ACCESS_ACTION.NAME		 Estos campos se usan para identificar los eventos de actividad de acceso en el sistema EPIC EHR.
PACIENTE. PAT_MRN_ID
PACIENTE. PAT_FIRST_NAME*
PACIENTE. PAT_MIDDLE_NAME
PACIENTE. PAT_LAST_NAME*
PACIENTE. ADD_LINE_1*
PACIENTE. ADD_LINE_2
PACIENTE. CIUDAD*
PATIENT.ZIP*
ZC_STATE.NAME
ZC_COUNTRY.NAME
CLARITY_DEP. DEPARTMENT_NAME		 Estos campos se usan para identificar la información del perfil del paciente.
ZC_BTG_REASON.NAME*
PAT_BTG_AUDIT. BTG_EXPLANATION		 Estos campos se usan para identificar el acceso a registros restringidos.
EMP. SYSTEM_LOGIN*
CLARITY_EMP. USER_ID
employee_last_name1
employee_first_name1		 Estos campos se usan para identificar la información del perfil de empleado para la coincidencia de direcciones y nombres necesaria para determinar el acceso a los registros de familia, vecino o empleado.

Nota:

Asegúrese de exportar solo las métricas de registro pertinentes de Epic. 1Este campo no está disponible de forma predeterminada en Epopeya. Debe configurar la exportación para asegurarse de que el archivo de texto contiene este campo.

Paso 3: Creación del conector de Epic

El siguiente paso es crear un conector epic en el portal de Microsoft Purview o en el portal de cumplimiento. Después de ejecutar el script en el paso 4, el archivo de texto que creó en el paso 2 se procesará e insertará en el punto de conexión de API que configuró en el paso 1. En este paso, asegúrese de copiar el JobId que se genera al crear el conector. Usará jobid al ejecutar el script.

Seleccione la pestaña adecuada para el portal que está usando. Para obtener más información sobre el portal de Microsoft Purview, consulte Portal de Microsoft Purview. Para más información sobre el portal de cumplimiento, consulte portal de cumplimiento Microsoft Purview.

  1. Inicie sesión en el portal de Microsoft Purview.

  2. Seleccione Configuración>Conectores de datos.

  3. Seleccione Mis conectores y, después, Agregar conector.

  4. En la lista, elija Conector epic.

  5. En la página Configurar la conexión , haga lo siguiente y, a continuación, seleccione Siguiente:

    1. Escriba o pegue el identificador de aplicación Microsoft Entra para la aplicación de Azure que creó en el paso 2.
    2. Escriba un nombre para el conector epic.

  6. En la página Revisar , revise la configuración y, a continuación, seleccione Finalizar para crear el conector.

    Se muestra una página de estado que confirma que se creó el conector. Esta página contiene dos cosas importantes que necesita para completar el siguiente paso para ejecutar el script de ejemplo para cargar los datos de los registros de auditoría de Epic EHR.

    Página de revisión con el identificador de trabajo y vínculo a GitHub para obtener un script de ejemplo

    1. Id. de trabajo. Necesitará este identificador de trabajo para ejecutar el script en el paso siguiente. Puede copiarlo desde esta página o desde la página de control flotante del conector.
    2. Esquema de referencia. Consulte el esquema para comprender qué campos del sistema Epic son aceptados por el conector. Esto le ayudará a crear un archivo con todos los campos de base de datos de Epic necesarios.
    3. Vínculo a script de ejemplo. Seleccione el vínculo aquí para ir al sitio de GitHub para acceder al script de ejemplo (el vínculo abre una nueva ventana). Mantenga esta ventana abierta para que pueda copiar el script en el paso 4. Como alternativa, puede marcar el destino o copiar la dirección URL para poder acceder a ella de nuevo al ejecutar el script. Este vínculo también está disponible en la página de control flotante del conector.

  7. Seleccione Listo.

    El nuevo conector se muestra en la lista de la pestaña Conectores .

  8. Seleccione el conector de Epic que acaba de crear para mostrar la página de control flotante, que contiene propiedades y otra información sobre el conector.

Si aún no lo ha hecho, puede copiar los valores para el identificador de App de Azure y el identificador de trabajo del conector. Necesitará estos para ejecutar el script en el paso siguiente. También puede descargar el script desde la página de control flotante (o descargarlo mediante el vínculo del paso siguiente).

También puede seleccionar Editar para cambiar el identificador de App de Azure o los nombres de encabezado de columna que definió en la página Asignación de archivos.

Paso 4: Ejecución del script de ejemplo para cargar los registros de auditoría de Epic EHR

El último paso para configurar un conector epic consiste en ejecutar un script de ejemplo que cargará los datos de registros de auditoría de EPIC EHR en el archivo de texto (que creó en el paso 1) en la nube de Microsoft. En concreto, el script carga los datos en el conector epic. Después de ejecutar el script, el conector de Epic que creó en el paso 3 importa los datos de registros de auditoría de Epic EHR a la organización de Microsoft 365, a los que pueden acceder otras herramientas de cumplimiento, como la solución de administración de riesgos Insider. Después de ejecutar el script, considere la posibilidad de programar una tarea para ejecutarla automáticamente diariamente para que los datos de terminación de empleados más actuales se carguen en la nube de Microsoft. Consulte (Opcional) Paso 6: Programar el script para que se ejecute automáticamente.

Nota:

Como se indicó anteriormente, el tamaño máximo del archivo de texto que contiene los datos de auditoría es de 3 GB. El número máximo de filas es de 5 millones. El script que ejecute en este paso tardará entre 30 y 40 minutos en importar los datos de auditoría de archivos de texto grandes. Además, el script dividirá archivos de texto grandes en bloques más pequeños de 100 000 filas y, a continuación, importará esos bloques secuencialmente.

  1. Vaya a la ventana que dejó abierta desde el paso anterior para acceder al sitio de GitHub con el script de ejemplo. Como alternativa, abra el sitio marcado o use la dirección URL que copió. También puede acceder al script aquí.

  2. Seleccione el botón Sin formato para mostrar el script en la vista de texto.

  3. Copie todas las líneas del script de ejemplo y guárdelas en un archivo de texto.

  4. Modifique el script de ejemplo de su organización, si es necesario.

  5. Guarde el archivo de texto como un archivo de script Windows PowerShell usando un sufijo de nombre de archivo de .ps1; por ejemplo, EpicConnector.ps1.

  6. Abra un símbolo del sistema en el equipo local y vaya al directorio donde guardó el script.

  7. Ejecute el siguiente comando para cargar los datos de auditoría de Epic en el archivo de texto en la nube de Microsoft; por ejemplo:

    .\EpicConnector.ps1 -tenantId <tenantId> -appId <appId>  -appSecret <appSecret>  -jobId <jobId>  -filePath '<filePath>'

En la tabla siguiente se describen los parámetros que se usarán con este script y sus valores necesarios. La información obtenida en los pasos anteriores se usa en los valores de estos parámetros.

Parámetro Descripción
tenantId Este es el identificador de la organización de Microsoft 365 que obtuvo en el paso 1. También puede obtener el identificador de inquilino de su organización en la hoja Información general de la Centro de administración Microsoft Entra. Esto se usa para identificar su organización.
appId Este es el identificador de aplicación Microsoft Entra de la aplicación que creó en Microsoft Entra ID en el paso 1. Esto lo usa Microsoft Entra ID para la autenticación cuando el script intenta acceder a la organización de Microsoft 365.
appSecret Este es el secreto de aplicación Microsoft Entra de la aplicación que creó en Microsoft Entra ID en el paso 1. Esto también se usa para la autenticación.
jobId Este es el identificador de trabajo del conector de Epic que creó en el paso 3. Esto se usa para asociar los registros de auditoría de Epic EHR que se cargan en la nube de Microsoft con el conector de Epic.
Filepath Esta es la ruta de acceso del archivo de texto (almacenado en el mismo sistema que el script) que creó en el paso 2. Intente evitar espacios en la ruta de acceso del archivo; de lo contrario, use comillas simples.

Este es un ejemplo de la sintaxis del script del conector de Epic mediante valores reales para cada parámetro:

.\EpicConnector.ps1 -tenantId d5723623-11cf-4e2e-b5a5-01d1506273g9 -appId 29ee526e-f9a7-4e98-a682-67f41bfd643e -appSecret MNubVGbcQDkGCnn -jobId b8be4a7d-e338-43eb-a69e-c513cd458eba -filePath 'C:\Users\contosoadmin\Desktop\Data\epic_audit_records.txt'

Si la carga se realiza correctamente, el script muestra el mensaje Cargar correctamente .

Nota:

Si tiene problemas para ejecutar el comando anterior debido a directivas de ejecución, consulte Acerca de las directivas de ejecución y Set-ExecutionPolicy para obtener instrucciones sobre cómo establecer directivas de ejecución.

Paso 5: Supervisión del conector de Epic

Después de crear el conector epic e insertar los registros de auditoría de EHR, puede ver el conector y cargar el estado en el portal de Microsoft Purview o en el portal de cumplimiento. Si programa el script para que se ejecute automáticamente de forma periódica, también puede ver el estado actual después de la última vez que se ejecutó el script.

Seleccione la pestaña adecuada para el portal que está usando. Para obtener más información sobre el portal de Microsoft Purview, consulte Portal de Microsoft Purview. Para más información sobre el portal de cumplimiento, consulte portal de cumplimiento Microsoft Purview.

  1. Inicie sesión en el portal de Microsoft Purview.

  2. Seleccione Configuración>Conectores de datos.

  3. Seleccione Mis conectores y elija el conector de Epic que ha creado para mostrar la página de control flotante. Esta página contiene las propiedades y la información sobre el conector.

  4. En Última importación, seleccione el vínculo Descargar registro para abrir (o guardar) el registro de estado del conector. Este registro contiene información sobre cada vez que se ejecuta el script y carga los datos del archivo de texto en la nube de Microsoft.

    El archivo de registro del conector epic muestra las filas numéricas del archivo de texto que se cargaron

    El RecordsSaved campo indica el número de filas del archivo de texto que se cargó. Por ejemplo, si el archivo de texto contiene cuatro filas, el valor de los RecordsSaved campos es 4, si el script cargó correctamente todas las filas del archivo de texto.

Si no ha ejecutado el script en el paso 4, se muestra un vínculo para descargar el script en Última importación. Puede descargar el script y, a continuación, seguir los pasos para ejecutar el script.

(Opcional) Paso 6: Programar el script para que se ejecute automáticamente

Para asegurarse de que los registros de auditoría más recientes del sistema EPIC EHR están disponibles para herramientas como la solución de administración de riesgos internos, se recomienda programar el script para que se ejecute automáticamente diariamente. Esto también requiere que actualice los datos del registro de auditoría de Epic en el mismo archivo de texto en una programación similar (si no es la misma) para que contenga la información más reciente sobre las actividades de acceso de los registros de pacientes por parte de los empleados. El objetivo es cargar los registros de auditoría más actuales para que el conector de Epic pueda ponerlo a disposición de la solución de administración de riesgos internos.

Puede usar la aplicación Programador de tareas en Windows para ejecutar automáticamente el script todos los días.

  1. En el equipo local, seleccione el botón Inicio de Windows y escriba Programador de tareas.

  2. Seleccione la aplicación Programador de tareas para abrirla.

  3. En la sección Acciones , seleccione Crear tarea.

  4. En la pestaña General , escriba un nombre descriptivo para la tarea programada; por ejemplo, script del conector de Epic. También puede agregar una descripción opcional.

  5. En Opciones de seguridad, haga lo siguiente:

    1. Determine si debe ejecutar el script solo cuando haya iniciado sesión en el equipo o ejecutarlo cuando haya iniciado sesión o no.
    2. Asegúrese de que está activada la casilla Ejecutar con los privilegios más altos .

  6. Seleccione la pestaña Desencadenadores , seleccione Nuevo y, a continuación, haga lo siguiente:

    1. En Configuración, seleccione la opción Diario y, a continuación, elija una fecha y hora para ejecutar el script por primera vez. El script se ejecutará todos los días a la misma hora especificada.
    2. En Configuración avanzada, asegúrese de que la casilla Habilitado está seleccionada.
    3. Seleccione Aceptar.

  7. Seleccione la pestaña Acciones , seleccione Nuevo y, a continuación, haga lo siguiente:

    Configuración de acción para crear una nueva tarea programada para el script del conector épico.

    1. En la lista desplegable Acción , asegúrese de que Iniciar un programa está seleccionado.
    2. En el cuadro Programa o script , seleccione Examinar, vaya a la siguiente ubicación y selecciónela para que la ruta de acceso se muestre en el cuadro: C:.0.exe.
    3. En el cuadro Agregar argumentos (opcional), pegue el mismo comando de script que ejecutó en el paso 4. Por ejemplo: .\EpicConnector.ps1 -tenantId "d5723623-11cf-4e2e-b5a5-01d1506273g9" -appId "c12823b7-b55a-4989-faba-02de41bb97c3" -appSecret "MNubVGbcQDkGCnn" -jobId "e081f4f4-3831-48d6-7bb3-fcfab1581458" -filePath "C:\Epic\audit\records.txt"
    4. En el cuadro Iniciar en (opcional), pegue la ubicación de la carpeta del script que ejecutó en el paso 4. Por ejemplo, C:\Epic\audit.
    5. Seleccione Aceptar para guardar la configuración de la nueva acción.

  8. En la ventana Crear tarea , seleccione Aceptar para guardar la tarea programada. Es posible que se le pida que escriba las credenciales de la cuenta de usuario.

    La nueva tarea se muestra en la biblioteca del programador de tareas.

    La nueva tarea para el script del conector de atención sanitaria se muestra en la biblioteca del programador de tareas.

    Se muestra la última vez que se ejecutó el script y la próxima vez que está programado para ejecutarse. Puede seleccionar doblemente la tarea para editarla.

    También puede comprobar la última vez que el script se ejecutó en la página de control flotante del conector epic correspondiente en el centro de cumplimiento.