Start
Pareamento e Controle de Acesso
Configure quem pode se comunicar com seu assistente Clawdbot e quais dispositivos podem se conectar ao seu Gateway.
Visão Geral
O pareamento é a etapa de aprovação explícita do proprietário usada para segurança em dois contextos:
- Pareamento de DM - Controla quem pode se comunicar com o bot
- Pareamento de Dispositivos - Controla quais dispositivos/nós podem se juntar à rede do Gateway
Pareamento de DM (Acesso de Chat de Entrada)
Quando um canal usa a política de DM pairing, remetentes desconhecidos recebem um código curto e suas mensagens são retidas até que você aprove.
Como Funciona
- Usuário desconhecido envia uma mensagem para seu bot
- O bot responde com um código de pareamento de 8 caracteres
- As mensagens são retidas em uma fila pendente
- Você aprova ou rejeita a solicitação de pareamento
- Usuários aprovados podem se comunicar livremente
Características do Código de Pareamento
- 8 caracteres maiúsculos
- Caracteres ambíguos excluídos (0, O, 1, I)
- Expira após 1 hora
- Máximo de 3 solicitações pendentes por canal (padrão)
Comandos de Aprovação
# Listar solicitações de pareamento pendentes
clawdbot pairing list telegram
clawdbot pairing list whatsapp
# Aprovar uma solicitação de pareamento
clawdbot pairing approve telegram ABC12DEF
clawdbot pairing approve whatsapp XYZ98GHI
# Rejeitar uma solicitação de pareamento
clawdbot pairing reject telegram ABC12DEFCanais Suportados
| Canal | Comando |
|---|---|
| Telegram | clawdbot pairing list telegram |
clawdbot pairing list whatsapp | |
| Signal | clawdbot pairing list signal |
| iMessage | clawdbot pairing list imessage |
| Discord | clawdbot pairing list discord |
| Slack | clawdbot pairing list slack |
Locais de Armazenamento
| Arquivo | Propósito |
|---|---|
~/.clawdbot/credentials/<channel>-pairing.json | Solicitações pendentes |
~/.clawdbot/credentials/<channel>-allowFrom.json | Usuários aprovados |
Pareamento de Dispositivos
Nós conectando ao Gateway como dispositivos com role: node requerem aprovação através de solicitações de pareamento de dispositivos.
Comandos de Aprovação de Dispositivos
# Listar todos os dispositivos (pendentes e pareados)
clawdbot devices list
# Aprovar um dispositivo
clawdbot devices approve <requestId>
# Rejeitar um dispositivo
clawdbot devices reject <requestId>
# Remover um dispositivo pareado
clawdbot devices remove <deviceId>Locais de Armazenamento
| Arquivo | Propósito |
|---|---|
~/.clawdbot/devices/pending.json | Solicitações de dispositivos pendentes |
~/.clawdbot/devices/paired.json | Dispositivos aprovados |
Políticas de DM
Configure a política de DM em ~/.clawdbot/clawdbot.json:
{
"channels": {
"whatsapp": {
"dmPolicy": "pairing",
"allowFrom": []
}
}
}Políticas Disponíveis
| Política | Descrição |
|---|---|
pairing | Requer aprovação para novos remetentes |
allowlist | Permitir apenas remetentes pré-aprovados |
open | Permitir todos os remetentes (não recomendado) |
Melhores Práticas de Segurança
- Use o modo de pareamento para canais expostos a usuários desconhecidos
- Revise solicitações pendentes regularmente
- Use o modo allowlist para canais sensíveis
- Limite solicitações pendentes para prevenir spam
- Audite usuários aprovados periodicamente
Documentação Relacionada
- Guia de Configuração - Configuração inicial
- Segurança - Melhores práticas de segurança
- Canais - Configuração de canais