Vinculación y Control de Acceso

Descripción General

La vinculación es el paso de aprobación explícita del propietario utilizado para seguridad en dos contextos:

1. Vinculación de DM - Controla quién puede comunicarse con el bot
2. Vinculación de Dispositivos - Controla qué dispositivos/nodos pueden unirse a la red del Gateway

Vinculación de DM (Acceso de Chat Entrante)

Cuando un canal usa la política de DM pairing, los remitentes desconocidos reciben un código corto y sus mensajes se retienen hasta que los apruebes.

Cómo Funciona

1. Usuario desconocido envía un mensaje a tu bot
2. El bot responde con un código de vinculación de 8 caracteres
3. Los mensajes se retienen en una cola pendiente
4. Apruebas o rechazas la solicitud de vinculación
5. Los usuarios aprobados pueden comunicarse libremente

Características del Código de Vinculación

• 8 caracteres en mayúsculas
• Caracteres ambiguos excluidos (0, O, 1, I)
• Expira después de 1 hora
• Máximo 3 solicitudes pendientes por canal (por defecto)

Comandos de Aprobación

# Listar solicitudes de vinculación pendientes
clawdbot pairing list telegram
clawdbot pairing list whatsapp

# Aprobar una solicitud de vinculación
clawdbot pairing approve telegram ABC12DEF
clawdbot pairing approve whatsapp XYZ98GHI

# Rechazar una solicitud de vinculación
clawdbot pairing reject telegram ABC12DEF

Canales Soportados

Ubicaciones de Almacenamiento

Vinculación de Dispositivos

Los nodos que se conectan al Gateway como dispositivos con role: node requieren aprobación a través de solicitudes de vinculación de dispositivos.

Comandos de Aprobación de Dispositivos

# Listar todos los dispositivos (pendientes y vinculados)
clawdbot devices list

# Aprobar un dispositivo
clawdbot devices approve <requestId>

# Rechazar un dispositivo
clawdbot devices reject <requestId>

# Eliminar un dispositivo vinculado
clawdbot devices remove <deviceId>

Ubicaciones de Almacenamiento

Políticas de DM

Configura la política de DM en ~/.clawdbot/clawdbot.json:

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

Políticas Disponibles

Mejores Prácticas de Seguridad

1. Usar modo de vinculación para canales expuestos a usuarios desconocidos
2. Revisar solicitudes pendientes regularmente
3. Usar modo allowlist para canales sensibles
4. Limitar solicitudes pendientes para prevenir spam
5. Auditar usuarios aprobados periódicamente

Documentación Relacionada

• Guía de Configuración - Configuración inicial
• Seguridad - Mejores prácticas de seguridad
• Canales - Configuración de canales