> 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-pt-br/integre-e-administre/integrations/asset-discovery/forescout.md).
# Forescout
Conecte o Forescout eyeControl, por meio da Web API no seu appliance Enterprise Manager, para trazer hosts descobertos para a Dispel como dispositivos — mapeados para um Wicket e atualizados em uma sincronização recorrente.
## Visão geral
A integração com o Forescout permite que o Dispel obtenha os hosts que o Forescout descobriu na sua rede e os traga como dispositivos do Dispel. Você se conecta à sua appliance Forescout uma vez, mapeia-a para uma instalação e um Wicket do Dispel, e o Dispel importa os dispositivos correspondentes e os mantém atualizados em uma sincronização recorrente.
A Forescout é uma solução local **de descoberta de ativos** integração. Especificamente, o Dispel se integra com **Forescout eyeControl** por meio da sua API Web (o **módulo eyeExtend Connect** ), e só lê dados dela. Você aponta o Dispel para o seu **Enterprise Manager** — a appliance central de gerenciamento do Forescout, que agrega as appliances Forescout individuais da sua rede. Você mesmo implanta e executa o Enterprise Manager (como uma appliance física ou virtual), então ele não é um serviço de nuvem hospedado pelo Forescout — o Dispel acessa esse recurso em um endereço dentro do seu próprio ambiente, e é por isso que a conexão frequentemente usa uma URL privada e a opção de certificado autoassinado.
Como o Enterprise Manager representa um único ambiente, o Dispel o trata como um **site** que você mapeia para um único Wicket — não há uma lista de sites individuais para percorrer.
{% hint style="info" %}
**Uma observação sobre os nomes da Forescout.** "eyeControl" é o produto da Forescout ao qual o Dispel se conecta; "Enterprise Manager" é a appliance de gerenciamento para a qual você aponta o Dispel. O campo de conexão é rotulado como **URL do Enterprise Manager** para corresponder à terminologia usada no console da Forescout.
{% endhint %}
#### O que o Dispel importa
* Hosts descobertos (nome, endereço IP, endereço MAC, fabricante/modelo, sistema operacional, tipo de dispositivo) como dispositivos do Dispel.
* Protocolos e portas de rede observados para cada host.
* Um link de volta para o host no Forescout, armazenado no dispositivo.
{% hint style="info" %}
**Onde encontrar.** Faça login como administrador da organização e abra **Configurações → Integrações**. O Forescout aparece na seção **Descoberta de ativos / Visibilidade de rede** . Clique em **Conectar** no cartão do Forescout para começar.
{% endhint %}
## Antes de começar
Você precisará dos seguintes itens do seu console Forescout:
* Um **usuário da API Web** — crie um em **Ferramentas → Opções → API Web → Configurações do usuário**. O Dispel autentica com o **Nome de usuário** e **Senha**.
* O **URL do Enterprise Manager** da sua appliance — por exemplo `https://192.168.1.100`.
* Se a sua appliance usar um **certificado TLS autoassinado**, esteja pronto para ativar a opção de autoassinado durante a configuração.
{% hint style="warning" %}
**Adicione o IP do Dispel à allowlist.** Quando você abrir o formulário de conexão, o Dispel mostrará um valor de **IP da allowlist** . Adicione esse endereço à allowlist do firewall da sua rede para que o Dispel consiga acessar a appliance local.
{% endhint %}
## Conectando o Forescout
1. Vá para **Configurações → Integrações** e clique em **Conectar** no cartão do Forescout.
2. Opcionalmente, defina um **Nome de exibição** para diferenciar esta integração das outras (você pode conectar mais de uma appliance).
3. Preencha os campos de conexão:
| Campo | Tipo | Observações |
| --------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- |
| **URL do Enterprise Manager** | Configuração | A URL da sua appliance Forescout Enterprise Manager. |
| **Permitir certificados autoassinados** | Configuração | Ative se a sua appliance usar um certificado TLS autoassinado. |
| **Nome de usuário** | Credencial | O usuário da API Web criado no console da Forescout. |
| **Senha** | Credencial | A senha do usuário da API Web. Armazenada de forma criptografada e nunca exibida novamente. |
4. Clique em **Testar conexão** para confirmar se o Dispel consegue se autenticar na appliance. Corrija qualquer erro informado antes de salvar.
5. Clique em **Salvar**. O Dispel salva a integração e executa imediatamente a sincronização inicial.
{% hint style="info" %}
**Suas credenciais são criptografadas.** A senha é criptografada em repouso e nunca é exibida novamente depois que você salva. Ao editar mais tarde, deixe os campos de credenciais em branco para manter os valores armazenados.
{% endhint %}
## Mapeando a appliance para um Wicket
Quando a sincronização inicial terminar, abra a integração para encontrar a seção **Mapeamento de sites** . O Forescout aparece como um único site que representa a sua appliance.
> Mapeie cada site do fornecedor para uma instalação e um wicket do Dispel. Os dispositivos dos sites mapeados serão sincronizados para o Dispel.
1. Escolha uma **Instalação**.
2. Escolha uma **Wicket**. Se a instalação tiver apenas um Wicket, o Dispel o seleciona para você.
3. Clique em **Salvar mapeamentos e importar**.
O Dispel importa os hosts da appliance para o Wicket mapeado — você verá o progresso passar de aguardando, para obtendo, para sincronizando, até concluir — e então informará quantos dispositivos foram importados (por exemplo, **"12 dispositivos importados"** ou um detalhamento dos dispositivos novos em relação aos já importados). Os dispositivos importados aparecem no Wicket mapeado junto com quaisquer dispositivos que você adicionou manualmente.
## Mantendo seu inventário atualizado
* O Dispel **ressincroniza automaticamente** em um agendamento recorrente, para que hosts recém-descobertos e detalhes alterados sejam capturados sem nenhuma ação da sua parte.
* Para obter o inventário mais recente imediatamente, abra a integração e escolha **Atualizar**.
* Para alterar os detalhes da conexão ou renovar credenciais, edite a integração e use **Salvar e sincronizar**. Deixe os campos de credenciais em branco para manter a senha atual.
## Status da conexão
Cada integração mostra um status para que você sempre saiba em que ponto ela está:
| Status | Significado |
| -------------------------- | ----------------------------------------------------------------------------------- |
| **Não inicializado** | Salvo, mas a primeira sincronização ainda não foi executada. |
| **Inicializando** | Executando a primeira sincronização. |
| **Pronto** | Conectado e sincronizado; o mapeamento foi aplicado. |
| **Precisa de atualização** | Novos dados do fornecedor estão disponíveis; execute uma atualização para obtê-los. |
| **Atualizando** | Uma sincronização está em andamento. |
| **Alterações pendentes** | As alterações de mapeamento foram salvas, mas ainda não foram aplicadas. |
| **Aplicando** | Importando dispositivos para o seu mapeamento salvo. |
| **Falhou** | A última operação falhou — consulte a orientação do erro. |
Um **indicador de integridade** (Conectado, Degradado, Inacessível) reflete se o Dispel consegue alcançar a appliance Forescout no momento.
## Resolução de problemas
Se uma sincronização ou teste de conexão falhar, o Dispel classifica o erro e sugere uma correção:
| Erro | O que normalmente significa e como corrigir |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falha na autenticação** | O nome de usuário ou a senha da API Web foi rejeitado. Confirme se o usuário da API Web existe e se a senha está atualizada. |
| **Endpoint inacessível** | O Dispel não conseguiu acessar a appliance. Verifique a URL do Enterprise Manager e se o IP do Dispel está incluído na allowlist do seu firewall. |
| **Erro de certificado** | A appliance apresentou um certificado TLS não confiável. Se ela usar um certificado autoassinado, habilite **Permitir certificados autoassinados** nas configurações de conexão. |
| **Tempo limite de conexão excedido** | A appliance demorou demais para responder — frequentemente por latência de rede ou uma regra de firewall entre o Dispel e a sua rede. |
| **Erro de configuração** | A URL parece incorreta ou a API Web não está habilitada na appliance. Verifique novamente as configurações de conexão. |
## Perguntas frequentes
Isto é eyeControl, eyeSight ou eyeExtend?
A plataforma da Forescout é composta por módulos sob a marca "eye" — eyeSight (visibilidade), eyeControl (política e controle), eyeExtend (integrações de terceiros) e outros. O Dispel se conecta ao **eyeControl** por meio da sua **módulo eyeExtend Connect** API Web. Você o configura apontando o Dispel para a sua **Enterprise Manager** appliance, e é por isso que o campo de conexão se chama **URL do Enterprise Manager**.
Posso conectar mais de uma appliance Forescout?
Sim. O Forescout oferece suporte a várias integrações, então você pode conectar várias appliances lado a lado. Dê a cada uma um **Nome de exibição** nome de exibição distinto
Por que o Forescout mostra apenas um site?
Uma appliance Forescout representa um único ambiente, então o Dispel o modela como um site mapeado para um único Wicket — em vez de uma lista de sites para mapear individualmente.
Minha appliance usa um certificado autoassinado. A conexão vai falhar?
Não, se você habilitar **Permitir certificados autoassinados** essa opção nas configurações de conexão. Deixe-a desativada quando sua appliance apresentar um certificado de uma autoridade confiável.
Conectar o Forescout muda alguma coisa na minha appliance?
Não. O Dispel lê apenas a API Web da Forescout. Ele nunca cria, modifica ou exclui dados no lado da 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-pt-br/integre-e-administre/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.