> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/asset-discovery/forescout.md).
# Forescout
Conecta Forescout eyeControl, a través de su API web en tu dispositivo Enterprise Manager, para incorporar a Dispel los hosts detectados como dispositivos, asignarlos a un Wicket y actualizarlos mediante una sincronización recurrente.
## Resumen
La integración de Forescout permite a Dispel extraer los hosts que Forescout ha descubierto en su red e incorporarlos como dispositivos de Dispel. Usted se conecta a su dispositivo Forescout una vez, lo asigna a una instalación de Dispel y a un Wicket, y Dispel importa los dispositivos coincidentes y los mantiene actualizados mediante una sincronización recurrente.
Forescout es una integración de **descubrimiento de activos** local. En concreto, Dispel se integra con **Forescout eyeControl** a través de su API web (el módulo **eyeExtend Connect** ), y solo lee de ella. Usted apunta Dispel a su **Enterprise Manager** — el dispositivo de administración central de Forescout, que agrega los dispositivos Forescout individuales de su red. Usted implementa y ejecuta Enterprise Manager por su cuenta (como un dispositivo físico o virtual), por lo que no es un servicio en la nube alojado por Forescout — Dispel accede a él en una dirección dentro de su propio entorno, por lo que la conexión a menudo usa una URL privada y la opción de certificado autofirmado.
Como Enterprise Manager representa un único entorno, Dispel lo trata como un **sitio** que usted asigna a un único Wicket; no hay una lista de sitios individual por la que trabajar.
{% hint style="info" %}
**Una nota sobre los nombres de Forescout.** "eyeControl" es el producto de Forescout al que se conecta Dispel; "Enterprise Manager" es el dispositivo de administración al que usted apunta Dispel. El campo de conexión está etiquetado como **URL de Enterprise Manager** para coincidir con la redacción de la consola de Forescout.
{% endhint %}
#### Qué importa Dispel
* Hosts descubiertos (nombre, dirección IP, dirección MAC, marca/modelo, sistema operativo, tipo de dispositivo) como dispositivos de Dispel.
* Protocolos y puertos de red observados para cada host.
* Un enlace de vuelta al host en Forescout, almacenado en el dispositivo.
{% hint style="info" %}
**Dónde encontrarlo.** Inicie sesión como administrador de la organización y abra **Configuración → Integraciones**. Forescout aparece en la sección **Descubrimiento de activos / Visibilidad de red** . Haga clic en **Conectar** en la tarjeta de Forescout para comenzar.
{% endhint %}
## Antes de comenzar
Necesitará lo siguiente de su consola de Forescout:
* Un **usuario de API web** — cree uno en **Herramientas → Opciones → API web → Configuración de usuario**. Dispel se autentica con el **Nombre de usuario** y la **Contraseña**.
* La **URL de Enterprise Manager** de su dispositivo — por ejemplo `https://192.168.1.100`.
* Si su dispositivo utiliza un **certificado TLS autofirmado**, prepárese para habilitar la opción de certificado autofirmado durante la configuración.
{% hint style="warning" %}
**Incluya la IP de Dispel en la lista de permitidos.** Cuando abra el formulario de conexión, Dispel mostrará un valor de **IP en lista blanca** Añada esta dirección a la lista de permitidos del firewall de su red para que Dispel pueda الوصول al dispositivo local.
{% endhint %}
## Conectando Forescout
1. Vaya a **Configuración → Integraciones** y haga clic en **Conectar** en la tarjeta de Forescout.
2. Opcionalmente, establezca un **Nombre para mostrar** para distinguir esta integración de las demás (puede conectar más de un dispositivo).
3. Rellene los campos de conexión:
| Campo | Tipo | Notas |
| -------------------------------------- | ------------- | ------------------------------------------------------------------------------------- |
| **URL de Enterprise Manager** | Configuración | La URL de su dispositivo Forescout Enterprise Manager. |
| **Permitir certificados autofirmados** | Configuración | Actívelo si su dispositivo utiliza un certificado TLS autofirmado. |
| **Nombre de usuario** | Credencial | El usuario de API web creado en la consola de Forescout. |
| **Contraseña** | Credencial | La contraseña del usuario de API web. Se almacena cifrada y nunca vuelve a mostrarse. |
4. Haga clic en **Probar conexión** para confirmar que Dispel puede autenticarse frente al dispositivo. Corrija cualquier error informado antes de guardar.
5. Haga clic en **Guardar**. Dispel guarda la integración y ejecuta inmediatamente la sincronización inicial.
{% hint style="info" %}
**Sus credenciales están cifradas.** La contraseña se cifra en reposo y nunca se vuelve a mostrar después de guardarla. Al editar más tarde, deje los campos de credenciales en blanco para conservar los valores almacenados.
{% endhint %}
## Asignación del dispositivo a un Wicket
Una vez que termine la sincronización inicial, abra la integración para encontrar la sección **Asignación de sitios** . Forescout aparece como un único sitio que representa su dispositivo.
> Asigne cada sitio del proveedor a una instalación y un wicket de Dispel. Los dispositivos de los sitios asignados se sincronizarán en Dispel.
1. Elija una **Instalación**.
2. Elija una **Wicket**. Si la instalación tiene solo un Wicket, Dispel lo selecciona por usted.
3. Haga clic en **Guardar asignaciones e importar**.
Dispel importa los hosts del dispositivo al Wicket asignado — verá cómo el progreso pasa de en espera, a obteniendo, a sincronizando, a completado — y luego informa cuántos dispositivos se importaron (por ejemplo, **"12 dispositivos importados"** o un desglose de nuevos frente a dispositivos ya importados). Los dispositivos importados aparecen en el Wicket asignado junto con cualquier dispositivo que haya añadido manualmente.
## Mantener su inventario actualizado
* Dispel **se resincroniza automáticamente** según un programa recurrente, de modo que los hosts recién descubiertos y los detalles cambiados se incorporan sin ninguna acción por su parte.
* Para extraer el inventario más reciente de inmediato, abra la integración y elija **Actualizar**.
* Para cambiar los detalles de conexión o rotar las credenciales, edite la integración y use **Guardar y sincronizar**. Deje los campos de credenciales en blanco para conservar la contraseña actual.
## Estado de la conexión
Cada integración muestra un estado para que siempre sepa en qué punto se encuentra:
| Estado | Significado |
| -------------------------- | -------------------------------------------------------------------------------------- |
| **No inicializado** | Guardado, pero la primera sincronización aún no se ha ejecutado. |
| **Inicializando** | Ejecutando la primera sincronización. |
| **Listo** | Conectado y sincronizado; la asignación está aplicada. |
| **Necesita actualización** | Hay nuevos datos del proveedor disponibles; ejecute una actualización para obtenerlos. |
| **Actualizando** | Hay una sincronización en curso. |
| **Cambios pendientes** | Los cambios de asignación están guardados, pero aún no se han aplicado. |
| **Aplicando** | Importando dispositivos para su asignación guardada. |
| **Fallido** | La última operación falló; consulte la guía del error. |
Una **insignia de estado** (Conectado, Degradado, Inaccesible) refleja si Dispel puede alcanzar actualmente el dispositivo Forescout.
## Solución de problemas
Si una sincronización o una conexión de prueba falla, Dispel clasifica el error y sugiere una solución:
| Error | Lo que suele significar y cómo solucionarlo |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Autenticación fallida** | Se rechazó el nombre de usuario o la contraseña de la API web. Confirme que el usuario de API web existe y que la contraseña es actual. |
| **Endpoint inaccesible** | Dispel no pudo alcanzar el dispositivo. Verifique la URL de Enterprise Manager y que la IP de Dispel esté incluida en la lista de permitidos de su firewall. |
| **Error de certificado** | El dispositivo presentó un certificado TLS no confiable. Si utiliza un certificado autofirmado, habilite **Permitir certificados autofirmados** en la configuración de conexión. |
| **Tiempo de espera de conexión agotado** | El dispositivo tardó demasiado en responder; a menudo se debe a latencia de red o a una regla de firewall entre Dispel y su red. |
| **Error de configuración** | La URL parece incorrecta o la API web no está habilitada en el dispositivo. Vuelva a comprobar la configuración de conexión. |
## Preguntas frecuentes
¿Es eyeControl, eyeSight o eyeExtend?
La plataforma de Forescout se compone de módulos bajo la marca "eye": eyeSight (visibilidad), eyeControl (política y control), eyeExtend (integraciones de terceros) y otros. Dispel se conecta a **eyeControl** a través de su **eyeExtend Connect** API web. Usted lo configura apuntando Dispel a su **Enterprise Manager** dispositivo, por lo que el campo de conexión se llama **URL de Enterprise Manager**.
¿Puedo conectar más de un dispositivo Forescout?
Sí. Forescout admite varias integraciones, por lo que puede conectar varios dispositivos uno al lado del otro. Asigne a cada uno un **Nombre para mostrar** distintivo
para distinguirlos.
Un dispositivo Forescout representa un único entorno, por lo que Dispel lo modela como un sitio asignado a un solo Wicket, en lugar de una lista de sitios que deban asignarse individualmente.
Mi dispositivo usa un certificado autofirmado. ¿Fallará la conexión?
No, si habilita **Permitir certificados autofirmados** en la configuración de conexión. Déjelo desactivado cuando su dispositivo presente un certificado de una autoridad de confianza.
¿Conectar Forescout cambia algo en mi dispositivo?
No. Dispel solo lee de la API web de Forescout. Nunca crea, modifica ni elimina datos del lado de Forescout.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/asset-discovery/forescout.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.