Recopila registros de Azure API Management
Versión del analizador: 1.0
En este documento, se explica cómo crear un feed de Azure Event Hub para transferir registros de Azure gestión de API a Google Security Operations.
Azure API Management es una plataforma de gestión de API híbrida y de múltiples nubes para APIs en todos los entornos. Ayuda a las organizaciones a publicar APIs para desarrolladores externos, socios e internos para aprovechar el potencial de sus datos y servicios. La gestión de API proporciona herramientas para el descubrimiento de APIs, la funcionalidad de puerta de enlace, las políticas de seguridad, los análisis y la participación de los desarrolladores. Los registros de diagnóstico capturan información detallada sobre las operaciones de API Gateway, incluidas las solicitudes, las respuestas y los errores.
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos:
- Una instancia de Google SecOps
- Acceso con privilegios al portal de Microsoft Azure con los siguientes permisos:
- Crea espacios de nombres de Event Hubs
- Crea Event Hubs
- Configura los parámetros de diagnóstico para la gestión de API de Azure
- Administrar las políticas de acceso
Una instancia de servicio de Azure API Management existente
Crea un espacio de nombres de Event Hubs
Un espacio de nombres de Event Hubs es un contenedor de administración para uno o más Event Hubs.
- En el portal de Azure, busca Event Hubs.
- Haz clic en + Crear.
Proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Suscripción Selecciona tu suscripción a Azure Grupo de recursos Seleccionar una base de datos existente o crear una nueva Nombre del espacio de nombres Ingresa un nombre único (por ejemplo, secops-apim-eventhub).Ubicación Selecciona la región (por ejemplo, East US).Nivel de precios Estándar (recomendado para producción) Unidades de capacidad de procesamiento Comienza con 1 y habilita el aumento automático (recomendado) Haz clic en Revisar + crear.
Revisa la descripción general y haz clic en Crear.
Espera a que se complete la implementación (de 1 a 2 minutos).
Crea un centro de eventos
- Después de implementar el espacio de nombres, ve al espacio de nombres de Event Hub.
- En el panel de navegación de la izquierda, selecciona Event Hubs en Entidades.
- Haz clic en + Event Hub.
Proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Nombre Ingresa un nombre único (por ejemplo, apim-logs).Recuento de particiones 40 (recomendado para un escalamiento óptimo de Google SecOps) Retención de mensajes 7 días (mínimo recomendado) Captura Inhabilitado (no es necesario para Google SecOps) Haz clic en Crear.
Obtén la cadena de conexión de Event Hub
Google SecOps requiere una cadena de conexión para autenticarse en el centro de eventos.
Opción A: Cadena de conexión a nivel del espacio de nombres (recomendado)
- Ve al espacio de nombres de Event Hub.
- En el panel de navegación de la izquierda, selecciona Políticas de acceso compartido en Configuración.
- Haz clic en la política predeterminada RootManageSharedAccessKey.
- Copia la clave primaria de la cadena de conexión.
- Guarda esta cadena de conexión de forma segura.
Ejemplo:
Original: Endpoint=sb://secops-apim-eventhub.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=abc123==;EntityPath=apim-logs Remove EntityPath: Endpoint=sb://secops-apim-eventhub.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=abc123==
Opción B: Cadena de conexión a nivel del centro de eventos
- Ve al Centro de eventos (no al espacio de nombres).
- En el panel de navegación de la izquierda, selecciona Políticas de acceso compartido en Configuración.
- Haz clic en + Agregar para crear una política nueva.
- Proporciona los siguientes detalles de configuración:
- Nombre de la política: Ingresa un nombre descriptivo (por ejemplo,
chronicle-read). - Permisos: Selecciona solo Escuchar (acceso de solo lectura).
- Nombre de la política: Ingresa un nombre descriptivo (por ejemplo,
- Haz clic en Crear.
- Haz clic en la política recién creada.
- Copia la clave primaria de la cadena de conexión.
Guarda esta cadena de conexión de forma segura.
Configura la gestión de API de Azure para transmitir a Event Hub
- En el portal de Azure, busca Servicios de administración de APIs.
- Selecciona tu instancia de servicio de Administración de API.
- En el panel de navegación de la izquierda, selecciona Configuración de diagnóstico en Supervisión.
- Haz clic en + Agregar configuración de diagnóstico.
- Proporciona los siguientes detalles de configuración:
- Nombre de la configuración de diagnóstico: Ingresa un nombre descriptivo (por ejemplo,
apim-to-secops). - En la sección Registros, selecciona las siguientes categorías:
- GatewayLogs: Registros de solicitudes y respuestas de API Gateway
- WebSocketConnectionLogs: Registros de conexión de WebSocket (si corresponde)
- DeveloperPortalAuditLogs: Registros de auditoría del portal para desarrolladores (si corresponde)
- GatewayLlmLogs: Registros de la puerta de enlace de IA generativa (si corresponde)
- GatewayMCPLogs: Registros del servidor del Protocolo de contexto del modelo (MCP) (si corresponde)
- En la sección Detalles del destino, selecciona la casilla de verificación Transmitir a un centro de eventos.
- Suscripción: Selecciona la suscripción que contiene tu espacio de nombres de Event Hub.
- Espacio de nombres del centro de eventos: Selecciona el espacio de nombres que creaste antes (por ejemplo,
secops-apim-eventhub). - Nombre del centro de eventos: Selecciona el centro de eventos que creaste (por ejemplo,
apim-logs). - Nombre de la política del centro de eventos: Selecciona RootManageSharedAccessKey o una política personalizada con permisos de envío.
- Nombre de la configuración de diagnóstico: Ingresa un nombre descriptivo (por ejemplo,
Haz clic en Guardar.
Configura Azure Blob Storage para los puntos de control (opcional)
Google SecOps puede usar Azure Blob Storage para almacenar puntos de control de Event Hub, que hacen un seguimiento de los eventos que se procesaron. Esto evita que se duplique la transferencia si el feed se interrumpe temporalmente.
Crea una cuenta de almacenamiento para los puntos de control
- En el portal de Azure, busca Cuentas de almacenamiento.
- Haz clic en + Crear.
Proporciona los siguientes detalles de configuración:
Parámetro de configuración Valor Suscripción Selecciona tu suscripción a Azure Grupo de recursos Usa el mismo grupo de recursos que Event Hub Nombre de la cuenta de almacenamiento Ingresa un nombre único (por ejemplo, secopsapimcheckpoint).Región La misma región que el centro de eventos Rendimiento Estándar Redundancia LRS (almacenamiento con redundancia local) Haz clic en Revisar + crear.
Haz clic en Crear.
Crea un contenedor de BLOB
- Ve a la cuenta de almacenamiento que acabas de crear.
- En el panel de navegación de la izquierda, selecciona Contenedores en Almacén de datos.
- Haz clic en + Contenedor.
- Proporciona los siguientes detalles de configuración:
- Nombre: Ingresa
checkpoints. - Nivel de acceso público: Privado (sin acceso anónimo)
- Nombre: Ingresa
- Haz clic en Crear.
Obtén las credenciales de la cuenta de almacenamiento
- En la cuenta de almacenamiento, selecciona Claves de acceso en Seguridad y redes.
- Haz clic en Mostrar claves.
- Copia y guarda lo siguiente:
- Nombre de la cuenta de almacenamiento: Es el nombre de tu cuenta de almacenamiento.
- Clave 1: Es el valor de la clave de acceso.
Proporcionarás estos valores cuando crees el feed de Google SecOps.
Crea un grupo de consumidores dedicado (opcional)
De forma predeterminada, Event Hub proporciona un grupo de consumidores llamado $Default. En entornos de producción, se recomienda crear un grupo de consumidores dedicado para Google SecOps.
- Ve al Centro de eventos (no al espacio de nombres).
- En el panel de navegación de la izquierda, selecciona Grupos de consumidores en Entidades.
- Haz clic en + Grupo de consumidores.
- Proporciona los siguientes detalles de configuración:
- Nombre: Ingresa un nombre descriptivo (por ejemplo,
chronicle).
- Nombre: Ingresa un nombre descriptivo (por ejemplo,
Haz clic en Crear.
Configura un feed en Google SecOps para transferir registros de gestión de API de Azure
- Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
- Haz clic en Agregar feed nuevo.
- En la página siguiente, haz clic en Configurar un solo feed.
- En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo,
Azure API Management Logs). - Selecciona Centro de eventos de Microsoft Azure como el Tipo de origen.
- Selecciona Azure API Management como el Tipo de registro.
- Haz clic en Siguiente.
Especifica valores para los siguientes parámetros de entrada:
Cadena de conexión del centro de eventos: Ingresa la cadena de conexión del centro de eventos que capturaste antes.
Si usas la cadena de conexión a nivel del espacio de nombres, haz lo siguiente:
- Asegúrate de quitar el parámetro
EntityPath. - También debes proporcionar el nombre del centro de eventos en el siguiente campo.
- Asegúrate de quitar el parámetro
Si usas una cadena de conexión a nivel del centro de eventos, haz lo siguiente:
- Usa la cadena de conexión tal como está (incluye
EntityPath) - El campo Nombre del centro de eventos se puede dejar en blanco.
- Usa la cadena de conexión tal como está (incluye
Nombre del centro de eventos: Ingresa el nombre del centro de eventos (por ejemplo,
apim-logs).- Obligatorio si se usa la cadena de conexión a nivel del espacio de nombres.
- Opcional si se usa la cadena de conexión a nivel del centro de eventos.
Grupo de consumidores (opcional): Ingresa el nombre del grupo de consumidores
- Déjalo en blanco para usar el grupo de consumidores predeterminado
$Default - Si creaste un grupo de consumidores dedicado, ingresa su nombre (por ejemplo,
chronicle).
- Déjalo en blanco para usar el grupo de consumidores predeterminado
Nombre del contenedor de Blob Storage (opcional): Para la creación de puntos de control, ingresa el nombre del contenedor (por ejemplo,
checkpoints).
Si proporcionas almacenamiento de BLOB para la creación de puntos de control, haz lo siguiente:
- Nombre de la cuenta de almacenamiento de Azure: Ingresa el nombre de la cuenta de almacenamiento de la configuración de puntos de control.
Clave de la cuenta de almacenamiento de Azure: Ingresa la clave de acceso de la configuración de puntos de control.
Espacio de nombres del recurso: Es el espacio de nombres del recurso.
Etiquetas de transferencia: Es la etiqueta que se aplicará a los eventos de este feed.
Haz clic en Siguiente.
Revisa la configuración de tu feed de noticias nuevo en la pantalla Finalizar y, luego, haz clic en Enviar.
Para obtener más información sobre los feeds de Google SecOps, consulta la documentación de feeds de Google SecOps.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
Level_label |
additional.fields |
Combinado |
Sku_label |
additional.fields |
Combinado |
apiId_label |
additional.fields |
Combinado |
apiRevision_label |
additional.fields |
Combinado |
apimSubscriptionId_label |
additional.fields |
Combinado |
backendMethod_label |
additional.fields |
Combinado |
backendProtocol_label |
additional.fields |
Combinado |
backendResponseCode_label |
additional.fields |
Combinado |
backendTime_label |
additional.fields |
Combinado |
cache_label |
additional.fields |
Combinado |
clientProtocol_label |
additional.fields |
Combinado |
durationMs_label |
additional.fields |
Combinado |
eventName_label |
additional.fields |
Combinado |
eventid_label |
additional.fields |
Combinado |
functionInvocationId_label |
additional.fields |
Combinado |
functionName_label |
additional.fields |
Combinado |
hostInstanceId_label |
additional.fields |
Combinado |
hostVersion_label |
additional.fields |
Combinado |
isRequestSuccess_label |
additional.fields |
Combinado |
operationId_label |
additional.fields |
Combinado |
productId_label |
additional.fields |
Combinado |
properties.message |
metadata.description |
Asignada directamente |
time |
metadata.event_timestamp |
Analizado como ISO8601 |
has_principal |
metadata.event_type |
Asignado: true → STATUS_UPDATE |
operationName |
metadata.product_event_type |
Asignada directamente |
DeploymentVersion |
metadata.product_version |
Asignada directamente |
properties.method |
network.http.method |
Asignada directamente |
properties.responseCode |
network.http.response_code |
Asignada directamente |
properties.responseSize |
network.received_bytes |
Asignada directamente |
properties.requestSize |
network.sent_bytes |
Asignada directamente |
correlationId |
network.session_id |
Asignada directamente |
properties.clientTlsCipherSuite |
network.tls.cipher |
Asignada directamente |
properties.clientTlsVersion |
network.tls.version |
Asignada directamente |
callerIpAddress |
principal.asset.ip |
Combinado |
callerIpAddress |
principal.ip |
Combinado |
location |
principal.location.name |
Asignada directamente |
properties.url |
principal.url |
Asignada directamente |
properties.userId |
principal.user.userid |
Asignada directamente |
action |
security_result.action |
Combinado |
resultType |
security_result.action |
Asignado: Succeeded → action |
category |
security_result.category_details |
Combinado |
properties.category |
security_result.category_details |
Combinado |
level |
security_result.severity |
Asignada directamente |
resultType |
security_result.summary |
Asignada directamente |
properties.appName |
target.application |
Asignada directamente |
properties.processId |
target.process.pid |
Asignada directamente |
roleInstance_label |
target.resource.attribute.labels |
Combinado |
resourceId |
target.resource.product_object_id |
Asignada directamente |
properties.backendUrl |
target.url |
Asignada directamente |
| N/A | metadata.event_type |
Constante: GENERIC_EVENT |
| N/A | metadata.product_name |
Constante: AZURE API MANAGEMENT |
| N/A | metadata.vendor_name |
Constante: AZURE_API_MANAGEMENT |
| N/A | network.tls.version_protocol |
Constante: HTTP |
Registro de cambios
Consulta el registro de cambios de este analizador
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.