Сопряжение и контроль доступа

Обзор

Сопряжение — это этап явного одобрения владельцем, используемый для безопасности в двух контекстах:

1. Сопряжение ЛС — Контролирует, кто может общаться с ботом
2. Сопряжение устройств — Контролирует, какие устройства/узлы могут присоединиться к сети шлюза

Сопряжение ЛС (Доступ к входящим чатам)

Когда канал использует политику pairing для ЛС, неизвестные отправители получают короткий код, и их сообщения удерживаются до вашего одобрения.

Как это работает

1. Неизвестный пользователь отправляет сообщение вашему боту
2. Бот отвечает 8-символьным кодом сопряжения
3. Сообщения удерживаются в очереди ожидания
4. Вы одобряете или отклоняете запрос сопряжения
5. Одобренные пользователи могут свободно общаться

Характеристики кода сопряжения

• 8 заглавных символов
• Неоднозначные символы исключены (0, O, 1, I)
• Истекает через 1 час
• Максимум 3 ожидающих запроса на канал (по умолчанию)

Команды одобрения

# Список ожидающих запросов сопряжения
clawdbot pairing list telegram
clawdbot pairing list whatsapp

# Одобрить запрос сопряжения
clawdbot pairing approve telegram ABC12DEF
clawdbot pairing approve whatsapp XYZ98GHI

# Отклонить запрос сопряжения
clawdbot pairing reject telegram ABC12DEF

Поддерживаемые каналы

Места хранения

Сопряжение устройств

Узлы, подключающиеся к шлюзу как устройства с role: node, требуют одобрения через запросы сопряжения устройств.

Команды одобрения устройств

# Список всех устройств (ожидающих и сопряжённых)
clawdbot devices list

# Одобрить устройство
clawdbot devices approve <requestId>

# Отклонить устройство
clawdbot devices reject <requestId>

# Удалить сопряжённое устройство
clawdbot devices remove <deviceId>

Места хранения

Политики ЛС

Настройте политику ЛС в ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": []
    }
  }
}

Доступные политики

Лучшие практики безопасности

1. Используйте режим сопряжения для каналов, доступных неизвестным пользователям
2. Проверяйте ожидающие запросы регулярно
3. Используйте режим allowlist для чувствительных каналов
4. Ограничьте ожидающие запросы для предотвращения спама
5. Проводите аудит одобренных пользователей периодически

Связанная документация

• Руководство по настройке - Начальная конфигурация
• Безопасность - Лучшие практики безопасности
• Каналы - Настройка каналов