Enriquecimiento de entidades en Microsoft Sentinel con datos de geolocalización mediante la API de REST (versión preliminar pública)
En este artículo se muestra cómo puede enriquecer entidades en Microsoft Sentinel con datos de geolocalización mediante la API de REST.
Importante
Esta característica actualmente está en VERSIÓN PRELIMINAR. En la página Términos de uso complementarios para las Versiones preliminares de Microsoft Azure se incluyen términos legales adicionales que se aplican a las características de Azure que se encuentran en versión beta, versión preliminar o que todavía no se han publicado para su disponibilidad general.
Parámetros de URI comunes
A continuación, se muestran los parámetros de URI comunes para la API de geolocalización:
Nombre | En | Obligatorio | Tipo | Descripción |
---|---|---|---|---|
{subscriptionId} | path | yes | GUID | Id. de la suscripción de Azure |
{resourceGroupName} | path | yes | string | Nombre del grupo de recursos dentro de la suscripción |
{api-version} | Query | yes | string | Versión del protocolo utilizado para realizar esta solicitud. A partir del 30 de abril de 2021, la versión de la API de geolocalización es 2019-01-01-preview. |
{ipAddress} | Query | yes | string | Dirección IP para la que se necesita información de geolocalización, en formato IPv4 o IPv6. |
Enriquecimiento de la dirección IP con información de geolocalización
Este comando recupera los datos de geolocalización de una dirección IP determinada.
URI de solicitud
Método | URI de la solicitud |
---|---|
GET | https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityInsights/enrichment/ip/geodata/?ipaddress={ipAddress}&api-version={api-version} |
Respuestas
status code | Descripción |
---|---|
200 | Correcto |
400 | No se ha proporcionado la dirección IP o está en formato no válido |
404 | No se han encontrado datos de geolocalización para esta dirección IP |
429 | Demasiadas solicitudes, inténtelo de nuevo en el período de tiempo especificado |
Campos devueltos en la respuesta
Nombre del campo | Descripción |
---|---|
ASN | Número de sistema autónomo asociado a esta dirección IP |
carrier | Nombre del operador para esta dirección IP |
city | Ciudad donde se encuentra esta dirección IP |
cityCf | Clasificación numérica de confianza de que el valor del campo "city" es correcto, en una escala de 0 a 100 |
continent | Continente donde se encuentra esta dirección IP |
country | País donde se encuentra esta dirección IP |
countryCf | Clasificación numérica de confianza de que el valor del campo "country" es correcto en una escala de 0 a 100 |
ipAddr | Representación de cadena de la dirección IP, en notación decimal con puntos o separada mediante dos puntos |
ipRoutingType | Descripción del tipo de conexión para esta dirección IP |
latitude | Latitud de esta dirección IP |
longitude | Longitud de esta dirección IP |
organization | Nombre de la organización para esta dirección IP |
organizationType | Tipo de la organización para esta dirección IP |
region | Región geográfica donde se encuentra esta dirección IP |
state | Estado donde se encuentra esta dirección IP |
stateCf | Clasificación numérica de confianza de que el valor del campo "state" es correcto, en una escala de 0 a 100 |
stateCode | Nombre abreviado del estado donde se encuentra esta dirección IP |
Límites de la API
Esta API tiene un límite de 100 llamadas por usuario y hora.
Respuesta de muestra
"body":
{
"asn": "12345",
"carrier": "Microsoft",
"city": "Redmond",
"cityCf": 90,
"continent": "north america",
"country": "united states",
"countryCf": 99
"ipAddr": "1.2.3.4",
"ipRoutingType": "fixed",
"latitude": "40.2436",
"longitude": "-100.8891",
"organization": "Microsoft",
"organizationType": "tech",
"region": "western usa",
"state": "washington",
"stateCf": null
"stateCode": "wa"
}
Pasos siguientes
Para obtener más información sobre Microsoft Sentinel, consulte los siguientes artículos:
Más información sobre las entidades:
Explore otros usos de la API de Microsoft Sentinel
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de