> ## 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.

# Visão Geral das Integrações

> Conecte sua stack de segurança ao Myrmex — como as integrações funcionam, como as credenciais permanecem seguras e como adicionar uma.

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

As integrações conectam o Myrmex às ferramentas que você já usa — provedores de nuvem, firewalls, equipamentos de rede, EDR/XDR, SIEMs, bancos de dados, ticketing e muito mais. Uma vez conectados, os agentes de IA (liderados por [Hydra](/pt/documentation/multi-agent-system/integration-specialist-agent)) podem ler dados desses sistemas e agir sobre eles em seu nome, diretamente do [Workspace](/pt/documentation/ai-workspace/overview).

## Como as Integrações Funcionam

Cada integração é uma **instância** que você cria a partir de um conector, restrita ao [contexto](/pt/documentation/get-started/concepts#how-your-account-is-organized) em que você está trabalhando. Dependendo do sistema, o Myrmex se conecta de uma entre algumas formas:

<CardGroup cols={2}>
  <Card title="Por meio de um Collector" icon="server">
    Para dispositivos on-premises e de rede, um **Myrmex Collector** (um dispositivo executando
    o agente em modo Collector) alcança o sistema por SSH ou sua API a partir de
    dentro da sua rede.
  </Card>

  <Card title="Diretamente para a nuvem" icon="cloud">
    Para plataformas de nuvem e SaaS, o Myrmex se conecta pela API do fornecedor — via
    consentimento OAuth ou uma credencial de serviço de privilégio mínimo.
  </Card>
</CardGroup>

<Note>
  **Suas credenciais nunca passam pela IA.** Os agentes apenas referenciam
  uma integração por seu ID e pedem que ela execute uma ação específica; os
  segredos reais são armazenados com segurança e resolvidos no lado do servidor. Consulte
  [Proteção de Dados](/pt/documentation/management/data-protection).
</Note>

## Credenciais Compartilhadas vs. Privadas

Por padrão uma integração usa **uma credencial compartilhada** para toda a organização — todos trabalham pela mesma service account. Para integrações onde cada pessoa deve agir como ela mesma, você pode colocar a integração como **privada**: cada usuário vincula a **sua própria** credencial, e qualquer requisição roda sob a credencial do usuário que a executa.

<CardGroup cols={2}>
  <Card title="Compartilhada (padrão)" icon="users">
    Uma credencial única para a organização. Qualquer pessoa com acesso usa a
    mesma service account — o mais simples para sistemas gerenciados centralmente.
  </Card>

  <Card title="Privada (por usuário)" icon="user-lock">
    Cada usuário vincula seu próprio login. As ações são atribuídas a — e usam
    as permissões de — o indivíduo que as executa. *"Exige que cada usuário use
    as próprias credenciais."*
  </Card>
</CardGroup>

**Ativando o modo privado.** No detalhe da integração, um administrador (com a permissão `integrations.update`) liga **Private integration**. Só está disponível para tipos de conector que suportam credenciais privadas; uma integração compartilhada continua funcionando exatamente como antes.

**Vinculando sua conta.** Quando uma integração é privada, cada usuário vincula uma credencial pessoal uma vez:

<Steps>
  <Step title="Crie uma credencial pessoal">
    Em **Settings → My Accounts**, adicione uma conta — seu login pessoal para
    uma integração privada (API key, basic auth, OAuth, SSH ou credencial de
    banco de dados).
  </Step>

  <Step title="Vincule à integração">
    Abra a integração e vá em **Integration Details → Private credential → My
    credential**, escolha sua conta e clique em **Link**. Você também pode criar
    uma nova conta ali mesmo.
  </Step>

  <Step title="Verifique o status">
    A credencial vinculada aparece como **Valid**, **Invalid** ou **Not tested**
    — um status por usuário, independente da saúde geral da integração.
  </Step>
</Steps>

<Note>
  Até você vincular uma credencial válida, uma integração privada aparece como
  **indisponível para você** e a IA não pode agir por sua conta nela — você é
  orientado a *"vincular sua conta em Integration Details → Private credential."*
  Outros usuários não são afetados; o acesso de cada pessoa é o dela.
</Note>

## O Que Você Pode Fazer com uma Integração

* **Ler e analisar** — traga alertas, logs, inventário, configuração e métricas para as suas investigações.
* **Agir** — aplique regras de firewall, isole endpoints, execute consultas, abra tickets e muito mais, sempre com a salvaguarda [a IA propõe, você aprova](/pt/documentation/get-started/concepts#ai-proposes-you-approve) para mudanças.
* **Medir a postura** — execute auditorias contínuas e sob demanda de [Postura de Segurança](/pt/documentation/security-posture/overview) contra o sistema conectado.

## Adicionando uma Integração

<Steps>
  <Step title="Abra Add Integration">
    No **Directory**, escolha a ação rápida **Add Integration** (ou abra **Integrations** e inicie uma nova).
  </Step>

  <Step title="Escolha o conector">
    Escolha o sistema que você quer conectar a partir do catálogo.
  </Step>

  <Step title="Forneça a credencial">
    Siga a página desse conector nesta seção para criar a credencial necessária
    (chave de API, conta de serviço, usuário SSH ou consentimento OAuth) e preencha os campos.
  </Step>

  <Step title="Conecte">
    Salve para validar a conexão. A integração então aparece em
    **Environment → Integrations**.
  </Step>
</Steps>

## O Catálogo de Conectores

Navegue pelos conectores por categoria na barra lateral. Cada conector tem sua própria página descrevendo exatamente qual credencial criar e como.

* **Cloud & CSPM** — AWS, Google Cloud, Oracle Cloud, Prowler
* **Microsoft & Identidade** — Entra ID, Intune, Microsoft 365, Sentinel, Google Workspace
* **Firewalls & WAF** — FortiGate, Palo Alto, Sophos, pfSense, WatchGuard, Cisco, Juniper, Barracuda, Cloudflare, Azion
* **Dispositivos de Rede** — Cisco, Huawei, Juniper, MikroTik, Dell, Aruba, D-Link, 3Com, Intelbras, Meraki, UniFi, Umbrella, NetBox
* **EDR & XDR** — CrowdStrike, SentinelOne, Trend Micro Vision One, Bitdefender
* **SIEM & Monitoramento** — Wazuh, Elastic Security, IBM QRadar, Rapid7 InsightIDR, Zabbix, FortiAnalyzer
* **Vulnerabilidade & Threat Intelligence** — Tenable, Google Threat Intelligence, Shodan, Apura, Axur
* **ITSM & Ticketing** — GLPI, Jira
* **DevOps, Automação & Notificações** — GitHub, Kubernetes, Grafana, n8n, SendGrid
* **Bancos de Dados** — PostgreSQL, MySQL/MariaDB, SQL Server, Oracle, Firebird, MongoDB, Redis, Cassandra, Elasticsearch

<Tip>
  Precisa de algo que não está na lista? Muitos dispositivos ainda podem ser alcançados por **SSH genérico**, e o catálogo de conectores está em constante expansão. Pergunte no Workspace o que está disponível para o seu ambiente.
</Tip>

## Conectando Suas Próprias Contas

Separadamente dessas integrações de toda a organização, você pode vincular **conectores pessoais** — Gmail, Google Drive, Outlook e SharePoint — para que a IA possa trabalhar com documentos das suas próprias contas. Eles agem como você, usando consentimento por usuário.