Recopila registros de Azure API Management

Versión del analizador: 1.0

Compatible con:

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.

  1. En el portal de Azure, busca Event Hubs.
  2. Haz clic en + Crear.
  3. 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)
  4. Haz clic en Revisar + crear.

  5. Revisa la descripción general y haz clic en Crear.

  6. Espera a que se complete la implementación (de 1 a 2 minutos).

Crea un centro de eventos

  1. Después de implementar el espacio de nombres, ve al espacio de nombres de Event Hub.
  2. En el panel de navegación de la izquierda, selecciona Event Hubs en Entidades.
  3. Haz clic en + Event Hub.
  4. 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)
  5. 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.

  1. Ve al espacio de nombres de Event Hub.
  2. En el panel de navegación de la izquierda, selecciona Políticas de acceso compartido en Configuración.
  3. Haz clic en la política predeterminada RootManageSharedAccessKey.
  4. Copia la clave primaria de la cadena de conexión.
  5. 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

  1. Ve al Centro de eventos (no al espacio de nombres).
  2. En el panel de navegación de la izquierda, selecciona Políticas de acceso compartido en Configuración.
  3. Haz clic en + Agregar para crear una política nueva.
  4. 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).
  5. Haz clic en Crear.
  6. Haz clic en la política recién creada.
  7. Copia la clave primaria de la cadena de conexión.
  8. Guarda esta cadena de conexión de forma segura.

Configura la gestión de API de Azure para transmitir a Event Hub

  1. En el portal de Azure, busca Servicios de administración de APIs.
  2. Selecciona tu instancia de servicio de Administración de API.
  3. En el panel de navegación de la izquierda, selecciona Configuración de diagnóstico en Supervisión.
  4. Haz clic en + Agregar configuración de diagnóstico.
  5. 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.
  6. 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

  1. En el portal de Azure, busca Cuentas de almacenamiento.
  2. Haz clic en + Crear.
  3. 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)
  4. Haz clic en Revisar + crear.

  5. Haz clic en Crear.

Crea un contenedor de BLOB

  1. Ve a la cuenta de almacenamiento que acabas de crear.
  2. En el panel de navegación de la izquierda, selecciona Contenedores en Almacén de datos.
  3. Haz clic en + Contenedor.
  4. Proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa checkpoints.
    • Nivel de acceso público: Privado (sin acceso anónimo)
  5. Haz clic en Crear.

Obtén las credenciales de la cuenta de almacenamiento

  1. En la cuenta de almacenamiento, selecciona Claves de acceso en Seguridad y redes.
  2. Haz clic en Mostrar claves.
  3. 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.

  1. Ve al Centro de eventos (no al espacio de nombres).
  2. En el panel de navegación de la izquierda, selecciona Grupos de consumidores en Entidades.
  3. Haz clic en + Grupo de consumidores.
  4. Proporciona los siguientes detalles de configuración:
    • Nombre: Ingresa un nombre descriptivo (por ejemplo, chronicle).
  5. Haz clic en Crear.

Configura un feed en Google SecOps para transferir registros de gestión de API de Azure

  1. Ve a Configuración > Administración de datos > Feeds. Si estás en una plataforma solo de SIEM, ve a Configuración > Feeds.
  2. Haz clic en Agregar feed nuevo.
  3. En la página siguiente, haz clic en Configurar un solo feed.
  4. En el campo Nombre del feed, ingresa un nombre para el feed (por ejemplo, Azure API Management Logs).
  5. Selecciona Centro de eventos de Microsoft Azure como el Tipo de origen.
  6. Selecciona Azure API Management como el Tipo de registro.
  7. Haz clic en Siguiente.
  8. 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.
    • 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.
    • 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).
    • 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.

  9. Haz clic en Siguiente.

  10. 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.