La API de clientes es un límite de integración independiente
La API de clientes ofrece a un cliente con derecho una conexión de máquina compatible para sistemas propiedad del cliente. Es independiente del inicio de sesión en Nova y de las interfaces usadas dentro de la aplicación Nova.
Un cliente puede extraer vistas aprobadas de eventos, alertas, inteligencia de amenazas, activos de postura, hallazgos de postura, relaciones de exposición e historial de auditoría. También puede enviar registros de eventos mediante el contrato compatible de recepción HTTPS. La disponibilidad depende de la edición del cliente, el despliegue y los productos de datos habilitados.
Las respuestas de extracción contienen la versión visible para el cliente de cada registro, no todos los campos que almacena Nova. Esto mantiene una integración con SIEM o lago de datos alineada con la evidencia y los límites de campos mostrados al mismo cliente en Nova.
Planifica un cliente vinculado a un propósito para cada integración
- Elige si el sistema del cliente extraerá registros aprobados, enviará eventos o realizará ambas acciones.
- Crea un cliente dedicado para un sistema responsable y un propósito de negocio. No compartas un cliente entre integraciones no relacionadas.
- Concede solo los alcances de datos necesarios y restringe el cliente a redes de origen conocidas cuando la integración tenga direcciones estables.
- Usa intervalos de tiempo emparejados y el cursor devuelto para extracciones incrementales. Conserva los identificadores de evento al reintentar un envío para que Nova reconozca la misma ocurrencia.
- Confirma la referencia versionada, los límites, la conservación, el comportamiento de reintentos y la ruta de soporte proporcionados para el despliegue del cliente.
Protege y opera el acceso a la API
Nova muestra un secreto de cliente solo cuando se crea o se rota. Guárdalo de inmediato en un sistema de secretos aprobado. Nunca lo coloques en código del navegador, repositorios públicos, capturas, chat, registros o tickets de soporte.
El sistema del cliente intercambia la credencial por un token de acceso de corta duración. Supervisa fallos y límites, rota credenciales antes de que caduquen, revoca una credencial sustituida tras verificarla y deshabilita todo el cliente cuando la integración deba detenerse de inmediato.