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

# Switch MikroTik

> Conecte um switch MikroTik (RouterOS/SwOS) ao Myrmex via SSH — crie a conta de CLI e adicione a integração.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecte seu switch **MikroTik** (CRS/CSS rodando RouterOS) para que o Myrmex possa ler sua configuração, auditar seu hardening, executar diagnósticos e — mediante aprovação — aplicar alterações via CLI. O Myrmex acessa o dispositivo via **SSH** por meio de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode) na sua rede e o consulta em tempo real.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Ler e diagnosticar" icon="magnifying-glass">
    Inspecione interfaces, VLANs, bridge, endereçamento IP e estado do sistema — diagnósticos somente leitura no RouterOS.
  </Card>

  <Card title="Auditoria de hardening" icon="shield-halved">
    Execute uma auditoria de [Security Posture](/pt/documentation/security-posture/overview) sobre a configuração do switch.
  </Card>

  <Card title="Executar comandos CLI" icon="terminal">
    Execute comandos operacionais e de configuração, com alterações aplicadas mediante aprovação.
  </Card>

  <Card title="Configuração e inventário" icon="floppy-disk">
    Revise a configuração em execução e acompanhe o modelo e a versão do RouterOS — leitura sob demanda, nunca armazenada.
  </Card>
</CardGroup>

## Antes de Começar

* Um **Collector** que consiga alcançar o IP de gerenciamento do switch via SSH. Consulte [Implantando o agente](/pt/documentation/agent-endpoint-security/installation) e [Modo Collector](/pt/documentation/agent-endpoint-security/collector-mode).
* Uma **conta com acesso à CLI** do dispositivo — somente leitura é suficiente para análise; leitura e escrita é necessária para aplicar alterações.

## Passo 1 — Crie a Credencial no MikroTik

<Steps>
  <Step title="Habilite o SSH">
    No RouterOS, verifique se o serviço SSH está habilitado em **IP → Services** (`/ip service`) e anote a porta (padrão `22`). Restrinja o serviço ao endereço do seu Collector sempre que possível.
  </Step>

  <Step title="Crie um usuário">
    Em **System → Users** (`/user`), adicione um usuário para o Myrmex com uma senha forte. Atribua o grupo `full` para acesso de leitura e escrita, ou o grupo `read` apenas para análise. Anote o nome de usuário e a senha.
  </Step>
</Steps>

<Tip>
  Prefira o menor privilégio: comece com o grupo `read` e conceda `full` apenas quando quiser que os agentes apliquem alterações por você.
</Tip>

## Passo 2 — Adicione a Integração no Myrmex

No [Directory](/pt/documentation/ai-workspace/overview#the-directory), escolha **Add Integration → MikroTik Switch** e preencha:

| Field           | Descrição                                                                                       |
| --------------- | ----------------------------------------------------------------------------------------------- |
| **Name**        | Um nome único para este switch.                                                                 |
| **Description** | Nota opcional para identificar o dispositivo.                                                   |
| **IP**          | O IP da interface de gerenciamento do MikroTik ou hostname que o Collector consegue alcançar.   |
| **SSH Port**    | A porta SSH (padrão `22`).                                                                      |
| **Username**    | A conta de CLI criada no Passo 1.                                                               |
| **Password**    | A senha dessa conta.                                                                            |
| **Model**       | A série do modelo do seu switch MikroTik (CRS/CSS).                                             |
| **Version**     | A versão do RouterOS/SwOS em execução no dispositivo.                                           |
| **Collector**   | O [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que abre a conexão SSH. |

## Conectar

Clique em **Connect** para validar a conexão SSH e concluir. O switch então aparece em **Environment → Integrations**, e você pode perguntar ao [Integration Specialist](/pt/documentation/multi-agent-system/integration-specialist-agent) sobre ele no Workspace.

<Note>
  O Myrmex consulta o switch em tempo real via SSH e atua somente mediante aprovação. Ele não armazena nem retém a configuração ou os dados do dispositivo no lado do Myrmex.
</Note>