> 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/armis.md).
# Armis
Conecte seu tenant da Armis para trazer para a Dispel os ativos gerenciados e não gerenciados descobertos, mapear os sites da Armis para Wickets e manter os dados dos dispositivos e as descobertas de vulnerabilidades em sincronia.
## Visão geral
A integração com a Armis permite que o Dispel obtenha os ativos que a Armis descobriu em todo o seu ambiente — tanto gerenciados quanto não gerenciados — e os traga como dispositivos do Dispel. Você se conecta ao seu tenant da Armis uma vez, mapeia cada site da Armis 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 Armis é uma **integração de descoberta de ativos** integração nativa da nuvem. Não há um appliance local — o Dispel se conecta ao seu tenant da Armis na nuvem e apenas lê os dados dele.
#### O que o Dispel importa
* Ativos 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 ativo.
* Um link de volta para o ativo na Armis, armazenado no dispositivo.
* **Descobertas de vulnerabilidades** para cada dispositivo importado, atualizadas a cada sincronização.
{% hint style="info" %}
**Onde encontrar.** Entre como administrador da organização e abra **Configurações → Integrações**. A Armis aparece na **Descoberta de ativos / Visibilidade de rede** seção. Clique em **Conectar** no cartão da Armis para começar.
{% endhint %}
## Antes de começar
Você vai precisar do seguinte do seu tenant da Armis:
* Uma **chave de API** (chave secreta), criada no console da Armis em Configurações da API.
* Seu **URL do tenant da Armis** — por exemplo `https://acme.armis.com`.
{% hint style="warning" %}
**Adicione o IP do Dispel à allowlist.** Ao abrir o formulário de conexão, o Dispel mostra um **IP da whitelist** valor. Se o seu tenant da Armis restringir o acesso à API por IP de origem, adicione este endereço à allowlist para que o Dispel possa se conectar.
{% endhint %}
## Conectando a Armis
1. Vá para **Configurações → Integrações** e clique em **Conectar** no cartão da Armis.
2. Opcionalmente, defina um **Nome de exibição** para diferenciar esta integração das outras (você pode conectar mais de um tenant da Armis).
3. Preencha os campos de conexão:
| Campo | Tipo | Observações |
| -------------------------- | ---------- | ---------------------------------------------------------------------------------------- |
| **URL do tenant da Armis** | Config | A URL base do seu tenant da Armis (por ex., `https://acme.armis.com`). |
| **Chave de API** | Credencial | Sua chave de API (secreta) da Armis. Armazenada criptografada e nunca exibida novamente. |
4. Clique em **Testar conexão** para confirmar que o Dispel consegue se autenticar na Armis. Corrija qualquer erro reportado antes de salvar.
5. Clique em **Salvar**. O Dispel salva a integração e executa imediatamente a sincronização inicial para descobrir seus sites da Armis.
{% hint style="info" %}
**Suas credenciais são criptografadas.** A chave de API é criptografada em repouso e nunca é exibida novamente após você salvar. Ao editar depois, deixe o campo de credencial em branco para manter o valor armazenado.
{% endhint %}
## Mapeando sites para Wickets
Quando a sincronização inicial terminar, abra a integração para encontrar a **Mapeamento de site** seção. A Armis expõe os sites configurados no seu tenant, e é aqui que você decide quais deles se tornam dispositivos do Dispel e onde eles ficam.
> Mapeie cada site do fornecedor para uma instalação e um wicket do Dispel. Os dispositivos dos sites mapeados serão sincronizados no Dispel.
Para cada site que você deseja importar:
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 processa cada site mapeado — você verá o progresso de cada site passar de aguardando, para buscando, para sincronizando, até concluir — e então informa quantos dispositivos foram importados (por exemplo, **"12 dispositivos importados"** ou uma discriminação entre dispositivos novos e 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 cronograma recorrente, para que os ativos descobertos recentemente e os 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 o campo de credencial em branco para manter a chave atual.
## Descobertas de vulnerabilidades
A Armis informa vulnerabilidades conhecidas para os ativos que monitora. Após cada sincronização bem-sucedida, o Dispel obtém as descobertas de vulnerabilidades dos seus dispositivos importados e as anexa a esses dispositivos, para que você possa ver os problemas conhecidos de um dispositivo sem sair do Dispel. As descobertas são atualizadas a cada sincronização, e as descobertas resolvidas desaparecem automaticamente.
## Status da conexão
Cada integração mostra um status para que você sempre saiba em que situação ela está:
| Status | Significado |
| -------------------------- | ----------------------------------------------------------------------------------- |
| **Não inicializado** | Salvo, mas a primeira sincronização ainda não foi executada. |
| **Inicializando** | Executando a primeira sincronização e descobrindo sites. |
| **Pronto** | Conectado e sincronizado; os mapeamentos são aplicados. |
| **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 seus mapeamentos salvos. |
| **Falhou** | A última operação falhou — consulte a orientação do erro. |
Um **indicador de integridade** (Conectado, Degradado, Inacessível) indica se o Dispel consegue alcançar a API da Armis no momento.
## Soluçã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 geralmente significa e como corrigir |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falha na autenticação** | A chave de API foi rejeitada. Ela pode ter sido rotacionada, expirado ou revogada — gere uma nova e atualize a integração. |
| **Endpoint inacessível** | O Dispel não conseguiu alcançar a API. Verifique a URL do tenant e se o IP do Dispel está na allowlist, caso o seu tenant restrinja o acesso à API. |
| **Tempo de conexão esgotado** | A Armis demorou demais para responder — normalmente latência transitória da rede. |
| **Limitado pela taxa** | A Armis limitou as solicitações. A próxima sincronização agendada deve funcionar. |
| **Erro de configuração** | A URL do tenant parece incorreta. Verifique novamente se ela aponta para o seu tenant da Armis. |
## Perguntas frequentes
Posso conectar mais de um tenant da Armis?
Sim. A Armis oferece suporte a múltiplas integrações, então você pode conectar vários tenants lado a lado. Dê a cada um um nome distinto **Nome de exibição** nome distinto para diferenciá-los.
Há uma opção local para a Armis?
Não. A Armis é uma plataforma na nuvem, então o Dispel sempre se conecta ao seu tenant da Armis pela internet. Não há um appliance para apontar.
Conectar a Armis muda algo no meu tenant da Armis?
Não. O Dispel apenas lê da Armis. Ele nunca cria, modifica ou exclui dados do lado da Armis.
Com que rapidez novos ativos aparecem?
Novos ativos aparecem na próxima sincronização — automaticamente no cronograma recorrente, ou imediatamente se você escolher **Atualizar**.
---
# 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/armis.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.