Connect Forescout eyeControl, through its Web API on your Enterprise Manager appliance, to pull discovered hosts into Dispel as devices — mapped to a Wicket and refreshed on a recurring sync.
The Forescout integration lets Dispel pull the hosts that Forescout has discovered on your network and bring them in as Dispel devices. You connect to your Forescout appliance once, map it to a Dispel facility and Wicket, and Dispel imports the matching devices and keeps them current on a recurring sync.
Forescout is an on-premise asset-discovery integration. Specifically, Dispel integrates with Forescout eyeControl through its Web API (the eyeExtend Connect module), and only ever reads from it. You point Dispel at your Enterprise Manager — Forescout's central management appliance, which aggregates the individual Forescout appliances on your network. You deploy and run the Enterprise Manager yourself (as a physical or virtual appliance), so it isn't a Forescout-hosted cloud service — Dispel reaches it at an address inside your own environment, which is why the connection often uses a private URL and the self-signed-certificate option.
Because the Enterprise Manager represents a single environment, Dispel treats it as one site that you map to a single Wicket — there is no per-site list to work through.
Discovered hosts (name, IP address, MAC address, make/model, operating system, device type) as Dispel devices.
Observed network protocols and ports for each host.
A link back to the host in Forescout, stored on the device.
You'll need the following from your Forescout console:
A Web API user — create one under Tools → Options → Web API → User Settings. Dispel authenticates with this user's Username and Password.
The Enterprise Manager URL of your appliance — for example https://192.168.1.100.
If your appliance uses a self-signed TLS certificate, be ready to enable the self-signed option during setup.
Go to Settings → Integrations and click Connect on the Forescout card.
Optionally set a Display Name to tell this integration apart from others (you can connect more than one appliance).
Fill in the connection fields:
Click Test Connection to confirm Dispel can authenticate against the appliance. Fix any reported error before saving.
Click Save. Dispel saves the integration and immediately runs the initial sync.
Once the initial sync finishes, open the integration to find the Site Mapping section. Forescout appears as a single site representing your appliance.
Map each vendor site to a Dispel facility and wicket. Devices from mapped sites will be synced into Dispel.
Pick a Facility.
Pick a Wicket. If the facility has only one Wicket, Dispel selects it for you.
Click Save Mappings & Import.
Dispel imports the appliance's hosts into the mapped Wicket — you'll see progress move from waiting, to fetching, to syncing, to complete — and then reports how many devices were imported (for example, "12 devices imported" or a breakdown of new versus already-imported devices). Imported devices appear in the mapped Wicket alongside any devices you've added manually.
Dispel re-syncs automatically on a recurring schedule, so newly discovered hosts and changed details are picked up without any action from you.
To pull the latest inventory immediately, open the integration and choose Refresh.
To change connection details or rotate credentials, edit the integration and use Save & Sync. Leave credential fields blank to keep the current password.
Each integration shows a status so you always know where it stands:
A separate health badge (Connected, Degraded, Unreachable) reflects whether Dispel can currently reach the Forescout appliance.
If a sync or test connection fails, Dispel classifies the error and suggests a fix:
Enterprise Manager URL
Config
The URL of your Forescout Enterprise Manager appliance.
Allow Self-Signed Certificates
Config
Toggle on if your appliance uses a self-signed TLS certificate.
Username
Credential
The Web API user created in the Forescout console.
Not Initialized
Saved, but the first sync hasn't run yet.
Initializing
Running the first sync.
Ready
Connected and synced; the mapping is applied.
Needs Refresh
New vendor data is available; run a refresh to pull it.
Refreshing
A sync is in progress.
Authentication Failed
The Web API username or password was rejected. Confirm the Web API user exists and the password is current.
Endpoint Unreachable
Dispel couldn't reach the appliance. Verify the Enterprise Manager URL and that Dispel's IP is allowlisted in your firewall.
Certificate Error
The appliance presented an untrusted TLS certificate. If it uses a self-signed certificate, enable Allow Self-Signed Certificates in the connection settings.
Connection Timed Out
The appliance took too long to respond — often network latency or a firewall rule between Dispel and your network.
Configuration Error
Password
Credential
The Web API user's password. Stored encrypted and never shown again.
Pending Changes
Mapping changes are saved but not yet applied.
Applying
Importing devices for your saved mapping.
Failed
The last operation failed — see the error guidance.
The URL looks wrong or the Web API isn't enabled on the appliance. Re-check the connection settings.