Conector Vectra XDR (mediante Azure Functions) para Microsoft Sentinel
El conector Vectra XDR ofrece la capacidad de ingerir datos de detecciones, auditorías, puntuación de entidades, bloqueo y mantenimiento en Microsoft Sentinel mediante la API REST de Vectra. Consulta la documentación de la API https://support.vectra.ai/s/article/KB-VS-1666 para obtener más información.
Este contenido se genera automáticamente. En relación con los cambios, ponte en contacto con el proveedor de soluciones.
Atributos del conector
| Atributo del conector | Descripción |
|---|---|
| Código de la aplicación de funciones de Azure | https://aka.ms/sentinel-VectraXDR-functionapp |
| Alias de función de Kusto | VectraDetections |
| URL de función de Kusto | https://aka.ms/sentinel-VectraDetections-parser |
| Tabla de Log Analytics | Detections_Data_CL Audits_Data_CL Entity_Scoring_Data_CL Lockdown_Data_CL Health_Data_CL |
| Compatibilidad con reglas de recopilación de datos | No se admite actualmente. |
| Compatible con | Soporte técnico de Vectra |
Ejemplos de consultas
Eventos de detecciones de Vectra: todos los eventos de detecciones.
Detections_Data_CL
| sort by TimeGenerated desc
Eventos de auditoría de Vectra: todos los eventos de auditoría.
Audits_Data_CL
| sort by TimeGenerated desc
Eventos de puntuación de entidades de Vectra: todos los eventos de puntuación de entidades.
Entity_Scoring_Data_CL
| sort by TimeGenerated desc
Eventos de bloqueo de Vectra: todos los eventos de bloqueo.
Lockdown_Data_CL
| sort by TimeGenerated desc
Eventos de mantenimiento de Vectra: todos los eventos de mantenimiento.
Health_Data_CL
| sort by TimeGenerated desc
Requisitos previos
Para realizar la integración con Vectra XDR (mediante Azure Functions) asegúrate de tener:
- Permisos de Microsoft.Web/sites: se requieren permisos de lectura y escritura en Azure Functions para crear una aplicación de funciones. Consulte la documentación para obtener más información sobre Azure Functions.
- Credenciales y permisos de la API REST: se requiere el id. de cliente de Vectra y el secreto de cliente para la recopilación de datos de mantenimiento, puntuación de entidades, detecciones, bloqueo y auditoría. Consulte la documentación para obtener más información sobre la API en
https://support.vectra.ai/s/article/KB-VS-1666.
Instrucciones de instalación del proveedor
Nota:
Este conector usa Azure Functions para conectarse a la API de Vectra a fin de extraer sus registros en Microsoft Sentinel. Esto podría generar costos adicionales de ingesta de datos. Consulte la página de precios de Azure Functions para obtener más información.
(Paso opcional) Almacene de manera segura las claves o tokens de autorización del área de trabajo y de la API en Azure Key Vault. Azure Key Vault proporciona un mecanismo seguro para almacenar y recuperar valores de clave. Siga estas instrucciones para usar Azure Key Vault con una aplicación de funciones de Azure Functions.
Nota
Este conector de datos depende de un analizador basado en una función de Kusto para funcionar según lo previsto. Sigue estos pasos para Analizador de detecciones, Analizador de auditorías, Analizador de puntuación de entidades, Analizador de bloqueo y Analizador de mantenimiento para crear el alias de funciones de Kusto, VectraDetections, VectraAudits, VectraEntityScoring, VectraLockdown y VectraHealth.
PASO 1: Pasos de configuración para las credenciales de la API de Vectra
Sigue estas instrucciones para crear un id. de cliente y un secreto de cliente de Vectra.
- Iniciar sesión en el portal de Vectra
- Ir a Administrar -> Clientes de API
- En la página Clientes de API, selecciona "Agregar cliente de API" para crear un cliente.
- Agrega Nombre de cliente, selecciona Rol y haz clic en Generar credenciales para obtener las credenciales de cliente.
- Asegúrate de registrar el id. de cliente y la clave secreta para su protección adecuada. Necesitarás estos dos fragmentos de información para obtener un token de acceso de la API de Vectra. Se requiere un token de acceso para realizar solicitudes a todos los puntos de conexión de la API de Vectra.
PASO 2: Seleccione UNA de las dos opciones de implementación siguientes para implementar el conector y la función de Azure asociada
IMPORTANTE: Antes de implementar el conector de datos de Vectra, ten a mano el id. y la clave principal del área de trabajo (pueden copiarse de lo siguiente), así como las credenciales de autorización de la API de Vectra.
Opción 1: Plantilla de Azure Resource Manager (ARM)
Usa este método para la implementación automatizada del conector Vectra.
Haga clic en el botón Implementar en Azure que aparece a continuación.
Seleccione la suscripción, el grupo de recursos y la ubicación que prefiera.
Agrega la siguiente información:
- Nombre de la función
- Id. de área de trabajo
- Clave del área de trabajo
- Dirección URL base de Vectra
https://<vectra-portal-url> - Id. de cliente de Vectra: estado
- Clave secreta de cliente de Vectra: estado
- Id. de cliente de Vectra: puntuación de entidades
- Secreto de cliente de Vectra: puntuación de entidades
- Id. de cliente de Vectra: detecciones
- Secreto de cliente de Vectra: detecciones
- Id. de cliente de Vectra: auditorías
- Secreto de cliente de Vectra: auditorías
- Id. de cliente de Vectra: bloqueo
- Secreto de cliente de Vectra: bloqueo
- StartTime (en formato MM/DD/AAAA HH:MM:SS)
- Nombre de la tabla de auditorías
- Nombre de la tabla de detecciones
- Nombre de la tabla de puntuación de entidades
- Nombre de la tabla de bloqueo
- Nombre de la tabla de estado
- Nivel de registro (valor predeterminado: INFO)
- Programación de bloqueo
- Programación de estado
- Programación de detecciones
- Programación de auditorías
- Programación de puntuación de entidades
Marque la casilla de verificación Acepto los términos y condiciones establecidos anteriormente.
Haga clic en Comprar para iniciar la implementación.
Opción 2: Implementación manual de Azure Functions
Sigue estas instrucciones paso a paso para implementar el conector de datos de Vectra manualmente con Azure Functions (Implementación mediante Visual Studio Code).
1. Implementación de una aplicación de funciones
NOTA: Deberá preparar VS Code para el desarrollo de funciones de Azure.
Descargue el archivo Aplicación de funciones de Azure. Extraiga el archivo en su equipo de desarrollo local.
Inicie VS Code. Elija Archivo en el menú principal y seleccione Abrir carpeta.
Seleccione la carpeta de nivel superior de los archivos extraídos.
Seleccione el icono de Azure en la barra de actividades y después, en el área Azure: Functions, seleccione el botón de implementación en la aplicación de funciones. Si aún no ha iniciado sesión, seleccione el icono de Azure en la barra de actividades y después en el área Azure: Functions, seleccione Iniciar sesión en Azure. Si ya había iniciado sesión, vaya al paso siguiente.
Escriba la siguiente información cuando se le indique:
a. Seleccionar carpeta: elija una carpeta de su área de trabajo o busque una que contenga su aplicación de funciones.
b. Seleccionar la suscripción: elija la suscripción que desee usar.
c. Seleccionar Crear aplicación de funciones en Azure (no elija la opción Opciones avanzadas)
d. Escribir un nombre único global para la aplicación de funciones: escriba un nombre que sea válido en una ruta de acceso de la dirección URL, El nombre que escriba se valida para asegurarse de que es único en Azure Functions. (p. ej., VECTRAXXXXX).
e. Seleccionar un entorno de ejecución: seleccione Python 3.8 o versiones posteriores.
f. Seleccione una ubicación para los nuevos recursos. Para mejorar el rendimiento y reducir los costos, elija la misma región donde se encuentra Microsoft Sentinel.
Se inicia la implementación. Una vez que se haya creado la aplicación de función se mostrará una notificación y se aplicará el paquete de implementación.
Vaya a Azure Portal para la configuración de la aplicación de funciones.
2. Configuración de la aplicación de funciones
- En la aplicación de funciones, seleccione el nombre de la aplicación de funciones y, después, Configuración.
- En la pestaña Configuración de la aplicación, seleccione + Nueva configuración de la aplicación.
- Agrega cada una de las siguientes opciones de configuración de la aplicación individualmente, con sus respectivos valores (distingue mayúsculas de minúsculas):
- Id. de área de trabajo
- Clave del área de trabajo
- Dirección URL base de Vectra
https://<vectra-portal-url> - Id. de cliente de Vectra: estado
- Clave secreta de cliente de Vectra: estado
- Id. de cliente de Vectra: puntuación de entidades
- Secreto de cliente de Vectra: puntuación de entidades
- Id. de cliente de Vectra: detecciones
- Secreto de cliente de Vectra: detecciones
- Id. de cliente de Vectra: auditorías
- Secreto de cliente de Vectra: auditorías
- Id. de cliente de Vectra: bloqueo
- Secreto de cliente de Vectra: bloqueo
- StartTime (en formato MM/DD/AAAA HH:MM:SS)
- Nombre de la tabla de auditorías
- Nombre de la tabla de detecciones
- Nombre de la tabla de puntuación de entidades
- Nombre de la tabla de bloqueo
- Nombre de la tabla de estado
- Nivel de registro (valor predeterminado: INFO)
- Programación de bloqueo
- Programación de estado
- Programación de detecciones
- Programación de auditorías
- Programación de puntuación de entidades
- logAnalyticsUri (opcional)
- Use logAnalyticsUri para invalidar el punto de conexión de la API de Log Analytics para la nube dedicada. Por ejemplo, para la nube pública, deje el valor vacío; para el entorno de nube Azure GovUS, especifique el valor con el siguiente formato:
https://<CustomerId>.ods.opinsights.azure.us.
- Una vez especificada toda la configuración de la aplicación, haga clic en Guardar.
Pasos siguientes
Para obtener más información, vaya a la solución relacionada en Azure Marketplace.