Saltar al contenido principal
La integración Admin By Request consulta eventos de seguridad desde la API de su inquilino y sincroniza el inventario de puntos de conexión gestionados en Wirespeed.

Qué hace esta integración

  • Consulta la Events API de Admin By Request
  • Ingesta cambios de privilegios, bloqueos de política, inicios de sesión break-glass y eventos relacionados del punto de conexión
  • Sincroniza estaciones de trabajo gestionadas desde la Inventory API
  • Asocia eventos a detecciones de Wirespeed con contexto de host, usuario y archivo cuando está disponible

Requisitos previos

Antes de la configuración, asegúrese de disponer de:
  1. Un inquilino de Admin By Request con acceso a la API habilitado
  2. Una API key desde Settings → Tenant Settings → Data → API Keys
  3. El prefijo del centro de datos de la API de su inquilino (por ejemplo dc1api, dc2api) que aparece en About API Keys

Paso 1: Habilitar la API y crear una clave

En el portal de Admin By Request:
  1. Vaya a Settings → Tenant Settings → Data → API Keys
  2. Cree o copie una API key
  3. Anote el prefijo del centro de datos de su inquilino (por ejemplo dc1api para EU West)
Use el prefijo de centro de datos correcto. Conectarse al host dc*api equivocado provoca errores de API.

Paso 2: Añadir Admin By Request en Wirespeed

  1. Vaya a Integraciones > Añadir integración
  2. Busque Admin By Request
  3. Introduzca:
    • API Data Center (por ejemplo dc1api)
    • API Key
    • Event Codes Filter (opcional; déjelo en blanco para el conjunto predeterminado de alta señal)
  4. Haga clic en Integrate
Durante la incorporación, Wirespeed valida las credenciales con GET /inventory?take=1.

Comportamiento de la ingesta de detecciones

  • El conjunto de ingesta predeterminado cubre códigos de evento de alta señal (cambios de privilegios, bloqueos de ejecución, break glass, denegaciones de sesión)
  • La paginación usa cursores monótonos del id del evento (startid) entre ejecuciones
  • La sincronización inicial está limitada para evitar inundaciones de relleno en inquilinos grandes

Comportamiento del inventario de puntos de conexión

  • Sincronización completa del directorio en cada ejecución mediante GET /inventory
  • La paginación usa cursores monótonos del id de inventario (startid) solo dentro de la ejecución
  • Asocia hostname, SO, direcciones IP, versión del agente y la última marca temporal de inventario; el estado en vivo usa inventoryAvailable, con un respaldo de 4 horas sobre inventoryDate según el intervalo de actualización de inventario de ABR

Resolución de problemas

Fallos de autenticación

Compruebe:
  1. Que la API key sea válida y que el acceso a la API esté habilitado en el portal
  2. Que API Data Center coincida con el prefijo mostrado en About API Keys
  3. Que la clave no haya superado la cuota diaria de API del proveedor (100.000 llamadas/día)

No aparecen detecciones

Compruebe:
  1. Que Admin By Request esté generando eventos en el portal (por ejemplo bloqueos de política o cambios de privilegios)
  2. Que los códigos de evento no estén excluidos por un Event Codes Filter personalizado
  3. Que la sincronización inicial puede tardar unos minutos según el volumen del backlog

Recursos adicionales