KQL para analistas SOC: consultas base en Defender
Consultas KQL de solo lectura para investigar inicios de sesión, procesos y correo en Microsoft Defender XDR: qué tabla usar y cómo acotar el tiempo.
Escrito por Eduardo Olivares, analista SOC en Barcelona.
- kql
- microsoft defender
- advanced hunting
- soc
- blue team
- microsoft sentinel
KQL (Kusto Query Language) es el lenguaje con el que se consulta la telemetría de Microsoft Defender XDR y de Microsoft Sentinel. Este artículo reúne cuatro consultas de solo lectura sobre inicios de sesión, procesos y correo, con las tablas y columnas tal como figuran en Microsoft Learn en noviembre de 2026. Son un punto de partida: los umbrales y los nombres de cuenta hay que adaptarlos a cada entorno, y conviene probarlas primero en un tenant de pruebas.
Respuesta corta: para cazar en Defender basta con saber qué tabla responde a cada pregunta. SigninLogs o EntraIdSignInEvents para identidades, DeviceProcessEvents para procesos, EmailEvents para correo y CloudAppEvents para la actividad en Microsoft 365. Acota siempre el tiempo con Timestamp > ago(...), filtra antes de unir tablas y proyecta solo las columnas que vayas a leer.
Qué es KQL y dónde se ejecuta
En el portal de Defender, la consulta se escribe en Hunting > Advanced hunting. Esa herramienta permite explorar hasta 30 días de datos crudos de Defender para Endpoint, Defender para Office 365, Defender for Cloud Apps y Defender for Identity. Si hay un workspace de Microsoft Sentinel incorporado al portal, también se pueden consultar sus tablas, con la retención que tenga configurada ese workspace.
Cada tabla depende de que el servicio que la rellena esté desplegado. DeviceProcessEvents viene de Defender para Endpoint, EmailEvents de Defender para Office 365 y CloudAppEvents de Defender for Cloud Apps, que además necesita el conector de actividades de Microsoft 365. Si el servicio no está, la consulta no falla: simplemente no devuelve filas.
Tres reglas antes de lanzar nada
- Filtra por tiempo primero. Una condición como
Timestamp > ago(1d)al principio reduce el volumen antes de cualquier transformación. - Filtra antes de unir. Reduce cada tabla antes del
join, pon a la izquierda la más pequeña y usakind=inner: el tipo por defecto (innerunique) elimina filas repetidas de la izquierda y puede ocultar resultados. - Proyecta solo lo útil. Un
projectcon las columnas que vas a leer hace los resultados legibles y, antes de un join, también más rápidos.
Un detalle más de la guía de Microsoft: has rinde mejor que contains cuando buscas una palabra completa.
Inicios de sesión sospechosos
Tabla y columnas relevantes
SigninLogs es la tabla de inicios de sesión de Microsoft Entra ID en Log Analytics y Sentinel. Las columnas que más se usan al empezar son TimeGenerated, UserPrincipalName, IPAddress, ResultType (0 indica éxito y cualquier otro valor es un fallo), ResultDescription, Location, AppDisplayName y ClientAppUsed.
En el esquema nativo de Defender la tabla equivalente es EntraIdSignInEvents, con Timestamp, AccountUpn, IPAddress, ErrorCode, Country y Application. Requiere licencia Microsoft Entra ID P2. La documentación anunciaba que el 19 de octubre de 2026 sustituía a AADSignInEventsBeta y que las consultas antiguas se migrarían automáticamente. Si encuentras material anterior con AADSignInEventsBeta, cambia el nombre de la tabla y revisa las columnas.
Consulta: fallos repetidos seguidos de éxito
Busca una IP que acumula cinco o más fallos para una cuenta y después consigue entrar en la hora siguiente al último fallo. El cinco y la hora son valores de ejemplo.
let ventana = 1h;
let fallos = SigninLogs
| where TimeGenerated > ago(1d)
| where ResultType in ("50126", "50053")
| summarize Fallos = count(), UltimoFallo = max(TimeGenerated) by UserPrincipalName, IPAddress
| where Fallos >= 5;
SigninLogs
| where TimeGenerated > ago(1d)
| where ResultType == "0"
| project UserPrincipalName, IPAddress, Exito = TimeGenerated
| join kind=inner fallos on UserPrincipalName, IPAddress
| where Exito > UltimoFallo and Exito - UltimoFallo < ventana
| project UserPrincipalName, IPAddress, Fallos, UltimoFallo, Exito
Aquí un fallo es una contraseña incorrecta (50126) o una cuenta bloqueada (50053). Si cuentas todo lo que no sea 0, entran también los avisos de MFA pendiente (50074, 50076) y el resultado se llena de ruido. Además, SigninLogs solo contiene inicios interactivos; los no interactivos están en AADNonInteractiveUserSignInLogs.
El resultado no prueba un compromiso: alguien que olvida la contraseña genera el mismo patrón. Para decidir, mira el país (Location), el cliente (ClientAppUsed) y si la IP aparece en otras cuentas. Esta consulta agrupa por usuario, así que un ataque que reparte pocos intentos entre muchas cuentas no lo verá.
Procesos y línea de comandos (DeviceProcessEvents)
DeviceProcessEvents registra la creación de procesos. Las columnas habituales son FileName, ProcessCommandLine, AccountName, DeviceName, InitiatingProcessFileName e InitiatingProcessCommandLine. Microsoft recomienda identificar el programa por el nombre de fichero y no por la línea de comandos completa, y comparar sin distinguir mayúsculas (in~, =~), porque una misma orden se puede escribir de muchas maneras.
Consulta: PowerShell con argumentos codificados
El parámetro -EncodedCommand de powershell.exe acepta una cadena en Base64 con codificación UTF-16LE. Tiene usos legítimos, así que esta consulta sirve para revisar, no para alertar a ciegas.
DeviceProcessEvents
| where Timestamp > ago(7d)
| where FileName in~ ("powershell.exe", "pwsh.exe")
| where ProcessCommandLine matches regex @"(?i)\s-(e|ec|en[a-z]*)\s"
| project Timestamp, DeviceName, AccountName, FileName, ProcessCommandLine,
InitiatingProcessFileName, InitiatingProcessCommandLine
| order by Timestamp desc
| limit 100
La expresión regular cubre las abreviaturas que PowerShell acepta para el parámetro (-e, -ec, -enc y similares); pruébala primero en un tenant de pruebas. Para leer el contenido, decodifica el Base64 como UTF-16LE fuera de la consulta. Mira también el proceso padre: un InitiatingProcessFileName que no es el esperado suele aportar más que el comando en sí.
Correo y reglas de bandeja (EmailEvents, CloudAppEvents)
EmailEvents guarda el procesamiento de cada correo. Para revisar phishing que llegó al buzón interesa ThreatTypes, DeliveryLocation y LatestDeliveryLocation, que refleja la ubicación más reciente del mensaje, por ejemplo si se retiró después de entregarse. EmailDirection toma los valores Inbound, Outbound e Intra-org.
EmailEvents
| where Timestamp > ago(7d)
| where EmailDirection == "Inbound"
| where ThreatTypes has "Phish"
| project Timestamp, NetworkMessageId, SenderFromAddress, RecipientEmailAddress,
Subject, DeliveryLocation, LatestDeliveryLocation, DetectionMethods
| order by Timestamp desc
Para reglas de bandeja y reenvíos, CloudAppEvents recoge la actividad de Exchange Online. Los nombres de ActionType de la consulta salen de las guías de clasificación de alertas de Microsoft sobre reenvío y manipulación de bandeja.
CloudAppEvents
| where Timestamp > ago(7d)
| where ActionType in ("New-InboxRule", "UpdateInboxRules", "Set-InboxRule", "Set-Mailbox")
| project Timestamp, AccountDisplayName, AccountObjectId, ActionType,
IPAddress, CountryCode, Isp, UserAgent, RawEventData
| order by Timestamp desc
La configuración de la regla viene en RawEventData. Compara IPAddress, Isp y CountryCode con el historial habitual del usuario.
Errores comunes
- Límite de filas: cada consulta devuelve como máximo 100.000 registros, y los resultados no pueden superar 64 MB.
- Timeout: una consulta que pasa de 10 minutos termina en error. Reduce el rango de tiempo o filtra antes.
- Cuota de CPU: si el tenant llega al 100 %, las consultas se bloquean hasta el siguiente ciclo de 15 minutos. El portal muestra si una consulta tiene uso Bajo, Medio o Alto.
- Zona horaria: las consultas se escriben en UTC. El portal convierte los resultados a la zona horaria que tengas configurada, y esa diferencia confunde al comparar con otras fuentes.
- Retención: 30 días para los datos nativos de Defender. Para más, hace falta Sentinel o exportar los datos.
- Sin tamaño previsto: si no sabes cuántas filas devolverá una consulta, ejecuta primero
counto añadelimit.
Cómo enlaza con triaje y BEC
Estas consultas responden preguntas concretas dentro de un flujo más amplio. El orden en que mirar las alertas está en triaje de alertas en un SOC. Las reglas de bandeja y los inicios de sesión desde ubicaciones raras encajan con las señales de business email compromise en Microsoft 365.
Preguntas frecuentes
¿Dónde ejecuto estas consultas?
Las de Defender (DeviceProcessEvents, EmailEvents, CloudAppEvents) en Hunting > Advanced hunting del portal de Defender. SigninLogs, en Log Analytics o en el portal de Defender si has incorporado el workspace de Sentinel.
¿Cuántos días hacia atrás puedo consultar?
Hasta 30 días de datos nativos de Defender. Las tablas de Sentinel dependen de la retención configurada en el workspace.
¿Uso SigninLogs o EntraIdSignInEvents?
Depende de dónde tengas los datos. SigninLogs es la tabla de Log Analytics y Sentinel; EntraIdSignInEvents está en el esquema de Defender y exige licencia Entra ID P2. Los nombres de columna cambian, así que no se pueden intercambiar sin adaptar la consulta.
¿Por qué mi consulta no devuelve nada?
Lo más habitual es que el servicio que rellena la tabla no esté desplegado, que el conector de CloudAppEvents no tenga activada la actividad de Microsoft 365 o que falte un permiso de acceso a esos datos. Después, revisa el rango de tiempo y los valores exactos de los filtros.
¿Puedo convertirlas en reglas de detección?
Microsoft indica que las mismas consultas de hunting sirven para crear reglas de detección personalizadas. Las cuotas se aplican por separado a las consultas manuales y a las reglas, así que optimiza antes de programarlas.