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

Puede configurar un conector de datos para importar datos de auditoría para la actividad del usuario en el sistema de registros electrónicos de atención sanitaria (EHR) de su organización. Los datos de auditoría del sistema de EHR de atención sanitaria incluyen datos para eventos relacionados con el acceso a los registros de salud de un paciente. La solución Microsoft Purview Insider Risk Management usa datos de auditoría de EHR de atención sanitaria 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 de Healthcare consta de las siguientes tareas:

• Crear 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 datos de auditoría de EHR de atención sanitaria.
• 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 Healthcare en el portal de Microsoft Purview.
• Ejecución de un script para insertar datos de auditoría de EHR de atención sanitaria en el punto de conexión de API.
• Opcionalmente, programar el script para que se ejecute automáticamente para importar los datos de auditoría.

Antes de configurar el conector

• Asigne el rol Administración conector de datos al usuario que crea el conector de Healthcare en el paso 3. Necesita este rol para agregar conectores en la página Conectores de datos del portal de Microsoft Purview. Varios grupos de roles incluyen este rol de forma predeterminada. 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 agregar los usuarios adecuados como miembros. Para obtener instrucciones, consulte:

  • Permisos en el portal de Microsoft Purview
  • Roles y grupos de roles en Microsoft Defender para Office 365 y cumplimiento de Microsoft Purview

• Determine cómo recuperar o exportar los datos del sistema ehr sanitario de su organización (a diario) y cree un archivo de texto que se describe en el paso 2. El script que se ejecuta en el paso 4 inserta los datos del archivo de texto en el punto de conexión de API.

• Comprenda que el script de ejemplo que se ejecuta en el paso 4 inserta los datos de auditoría de EHR de atención sanitaria desde un archivo de texto a la API del conector para que la solución de administración de riesgos internos pueda usarla. Microsoft no admite este script de ejemplo en ningún programa o servicio de soporte estándar. 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. Asume todo riesgo derivado del uso o el rendimiento del script de ejemplo y la documentación. En ningún caso Microsoft, sus autores o cualquier otra persona implicada en la creación, producción o entrega de los scripts será responsable de los daños de cualquier tipo, incluidos los daños por pérdida de beneficios empresariales, interrupción del negocio, pérdida de información empresarial u otra pérdida pecuniaria, derivada del uso o incapacidad para usar los scripts de ejemplo o la documentación, incluso si Se ha informado a Microsoft de la posibilidad de tales daños.

Paso 1: Creación de una aplicación en Microsoft Entra id.

En primer lugar, cree y registre una nueva aplicación en Microsoft Entra identificador. La aplicación corresponde al conector de Healthcare que se crea en el paso 3. Al crear la aplicación, Microsoft Entra id. puede autenticar la solicitud de inserción para un archivo de texto que contenga datos de auditoría de EHR de atención sanitaria. Durante la creación de esta aplicación Microsoft Entra, guarde la siguiente información. Estos valores se usan 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 datos de auditoría de EHR de atención sanitaria

A continuación, cree 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 sanitario de su organización. Como se explicó anteriormente, determine cómo generar este archivo de texto a partir de su sistema de EHR sanitario. El flujo de trabajo del conector de Healthcare 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. Los formatos de archivo admitidos son archivos de texto separados por comas (.csv), canalización (.psv) o tabulación (.tsv).

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 valida y los datos del archivo no se importan.

Paso 3: Creación del conector de Healthcare

En este paso, creará un conector de Healthcare en el portal de Microsoft Purview. Después de ejecutar el script en el paso 4, el conector procesa el archivo de texto que creó en el paso 2 y lo inserta en el punto de conexión de API que configuró en el paso 1. Asegúrese de copiar el JobId generado al crear el conector. Necesita jobid al ejecutar el script.

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 Healthcare (preview).

5. Acepte los términos de servicio.

6. En la página Credenciales de autenticación , escriba la siguiente información y seleccione Siguiente:

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

7. En la página Método de asignación de archivos, seleccione una de las siguientes opciones y seleccione Siguiente:

   • Cargue un archivo de ejemplo. Seleccione Cargar archivo de ejemplo para cargar el archivo que preparó en el paso 2. Con esta opción, puede seleccionar rápidamente nombres de columna en el archivo de texto de una lista desplegable para asignar las columnas al esquema necesario para el conector de atención sanitaria.

   O bien

   • Proporcione manualmente los detalles de la asignación. Escriba el nombre de las columnas del archivo de texto para asignar las columnas al esquema necesario para el conector de atención sanitaria.

8. En la página Detalles de asignación de archivos, complete uno de los pasos siguientes, en función de si cargó un archivo de ejemplo en el paso anterior:

   • Use las listas desplegables para asignar las columnas del archivo de ejemplo a cada campo necesario para el conector de atención sanitaria.

   O bien

   • Para cada campo, escriba el nombre de columna del archivo que preparó en el paso 2 que corresponde al campo del conector de atención sanitaria.

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

   Una página de estado confirma que se creó el conector. Esta página contiene dos elementos importantes que necesita para completar el siguiente paso para ejecutar el script de ejemplo para cargar los datos de auditoría de EHR de atención sanitaria.

   • Id. de trabajo. Necesita 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.
   • 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.

10. Seleccione Listo.

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

11. Seleccione el conector de Healthcare 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, copie los valores para el identificador de App de Azure y el identificador de trabajo del conector. Necesita estos valores para ejecutar el script en el paso siguiente. También puede descargar el script desde la página de control flotante o mediante el vínculo del paso siguiente.

Seleccione 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 datos de auditoría de EHR de atención sanitaria

El último paso para configurar un conector de Healthcare es ejecutar un script de ejemplo que cargue los datos de auditoría de EHR de atención sanitaria 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 de Healthcare. Después de ejecutar el script, el conector healthcare que creó en el paso 3 importa los datos de auditoría de EHR de atención sanitaria a su organización de Microsoft 365, donde otras herramientas de cumplimiento, como la solución Insider Risk Management, pueden acceder a él. 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. Para obtener más información, vea (Opcional) Paso 6: Programar el script para que se ejecute automáticamente.

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, HealthcareConnector.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 sanitaria en el archivo de texto en la nube de Microsoft; por ejemplo:

   .\HealthcareConnector.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. Use la información que obtuvo en los pasos anteriores para estos valores.

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

.\HealthcareConnector.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\healthcare_audit_records.csv'

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

Paso 5: Supervisión del conector sanitario

Después de crear el conector de Healthcare e insertar los datos de auditoría de EHR, puede ver el conector y cargar el estado en el portal de Microsoft Purview. 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 ejecuta el script.

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

2. Seleccione Configuración>Conectores de datos.

3. Seleccione Mis conectores y, a continuación, seleccione el conector de Healthcare que creó 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 RecordsSaved campo indica el número de filas del archivo de texto que carga el script. Por ejemplo, si el archivo de texto contiene cuatro filas, el valor de los RecordsSaved campos es 4, si el script carga correctamente todas las filas del archivo de texto.

Si no ejecuta el script en el paso 4, aparecerá 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 herramientas como la solución Insider Risk Management siempre tienen los datos de auditoría más recientes del sistema de EHR de atención sanitaria, programe el script para que se ejecute automáticamente cada día. También debe actualizar los datos de auditoría de EHR en el mismo archivo de texto según una programación similar 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 datos de auditoría más actuales para que el conector healthcare pueda ponerlos a disposición de la solución de administración de riesgos internos.

Use 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, como el script del conector de Healthcare. También puede agregar una descripción opcional.

5. En Opciones de seguridad, haga lo siguiente:

   1. Decida si ejecuta el script solo cuando haya iniciado sesión en el equipo o ejecútelo 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 ejecuta 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:

   

   1. En la lista desplegable Acción , asegúrese de que Iniciar un programa está seleccionado.
   2. En el cuadro Programa/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: .\HealthcareConnector.ps1 -tenantId "d5723623-11cf-4e2e-b5a5-01d1506273g9" -appId "c12823b7-b55a-4989-faba-02de41bb97c3" -appSecret "MNubVGbcQDkGCnn" -jobId "e081f4f4-3831-48d6-7bb3-fcfab1581458" -filePath "C:\Healthcare\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:\Healthcare\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 aparece 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 de Healthcare correspondiente en el centro de cumplimiento.