> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandfly

> Ingeste resultados de alertas de Sandfly y sincronice el inventario de hosts Linux para el enriquecimiento

> [!NOTE]
>
> Esta integración está actualmente en beta. Los resultados de alertas de Sandfly se ingestan como
> eventos informativos mientras finalizamos asignaciones de categorización más detalladas.

La integración de Sandfly ingesta resultados de detección de Linux desde Sandfly y los correlaciona con el inventario de hosts en Wirespeed.

## Qué hace esta integración

* Ingesta resultados `alert` de Sandfly en detecciones de Wirespeed
* Sincroniza hosts de Sandfly como activos de punto de conexión
* Correlaciona detecciones con el inventario de puntos de conexión en Wirespeed para el contexto del host

## Requisitos previos

Antes de la configuración, asegúrese de disponer de:

1. El **nombre de host o la dirección IP** de su servidor Sandfly (accesible desde Wirespeed)
2. Un usuario de API de Sandfly dedicado con acceso de solo lectura (rol recomendado: `api_result_read`)
3. El nombre de usuario y la contraseña del usuario de la API

## Paso 1: Crear un usuario de API de solo lectura en Sandfly

En Sandfly, cree un usuario de integración dedicado y asígnele solo permisos de lectura (prefiera `api_result_read`).

> [!WARNING]
>
> Use una cuenta de servicio dedicada para Wirespeed en lugar de una cuenta de administrador personal.

## Paso 2: Añadir Sandfly en Wirespeed

1. Vaya a Integraciones > [**Añadir integración**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Busque **Sandfly**
3. Introduzca:
   * **Host de Sandfly** (nombre de host o IP, sin protocolo/ruta; por ejemplo `sandfly.company.com` o `142.250.190.46`)
   * **Nombre de usuario de la API**
   * **Contraseña de la API**
4. Haga clic en **Integrar**

Durante la incorporación, Wirespeed valida:

* La corrección de las credenciales (`/v4/auth/login`)
* La accesibilidad de la API y la validez del token (`/v4/version`)

## Comportamiento de la ingesta de detecciones

* Solo se ingestan resultados con estado `alert`
* Se ignoran los resultados `pass` y `error`
* Se excluyen los resultados en lista blanca y los sustituidos
* El sondeo basado en cursor usa `time_since` para evitar lagunas y duplicados

## Inventario de puntos de conexión y enriquecimiento

* La sincronización del inventario de hosts usa resúmenes de hosts de Sandfly (`/v4/hosts?summary=true`)
* El contexto del host se adjunta a las detecciones mediante la correlación de puntos de conexión de Wirespeed

## Solución de problemas

### Fallos de autenticación o validación

Compruebe:

1. Que el nombre de host/IP es correcto y accesible desde Wirespeed
2. Que Wirespeed puede alcanzar su API de Sandfly por HTTPS
3. Que el nombre de usuario/contraseña son válidos
4. Que el usuario de la API tiene acceso de lectura a resultados y hosts

### No aparecen detecciones

Compruebe:

1. Que Sandfly tiene resultados `alert` recientes (no solo `pass`/`error`)
2. Que los resultados no están en lista blanca ni sustituidos
3. Que la sincronización inicial puede tardar unos minutos según el volumen

## Recursos adicionales

* [Sandfly API Overview](https://docs.sandflysecurity.com/docs/sandfly-api)
* [Sandfly API Reference](https://api.sandflysecurity.com/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.