Kopplung und Zugriffskontrolle

Übersicht

Die Kopplung ist der explizite Genehmigungsschritt des Besitzers, der für die Sicherheit in zwei Kontexten verwendet wird:

1. DM-Kopplung - Kontrolliert, wer mit dem Bot kommunizieren kann
2. Geräte-Kopplung - Kontrolliert, welche Geräte/Knoten dem Gateway-Netzwerk beitreten können

DM-Kopplung (Eingehender Chat-Zugriff)

Wenn ein Kanal die pairing DM-Richtlinie verwendet, erhalten unbekannte Absender einen Kurzcode und ihre Nachrichten werden zurückgehalten, bis Sie sie genehmigen.

Wie es funktioniert

1. Unbekannter Benutzer sendet eine Nachricht an Ihren Bot
2. Bot antwortet mit einem 8-stelligen Kopplungscode
3. Nachrichten werden in einer Warteschlange gehalten
4. Sie genehmigen oder lehnen die Kopplungsanfrage ab
5. Genehmigte Benutzer können frei kommunizieren

Eigenschaften des Kopplungscodes

• 8 Großbuchstaben
• Mehrdeutige Zeichen ausgeschlossen (0, O, 1, I)
• Läuft nach 1 Stunde ab
• Maximal 3 ausstehende Anfragen pro Kanal (Standard)

Genehmigungsbefehle

# Ausstehende Kopplungsanfragen auflisten
clawdbot pairing list telegram
clawdbot pairing list whatsapp

# Eine Kopplungsanfrage genehmigen
clawdbot pairing approve telegram ABC12DEF
clawdbot pairing approve whatsapp XYZ98GHI

# Eine Kopplungsanfrage ablehnen
clawdbot pairing reject telegram ABC12DEF

Unterstützte Kanäle

Speicherorte

Geräte-Kopplung

Knoten, die sich als Geräte mit role: node mit dem Gateway verbinden, erfordern eine Genehmigung durch Geräte-Kopplungsanfragen.

Geräte-Genehmigungsbefehle

# Alle Geräte auflisten (ausstehend und gekoppelt)
clawdbot devices list

# Ein Gerät genehmigen
clawdbot devices approve <requestId>

# Ein Gerät ablehnen
clawdbot devices reject <requestId>

# Ein gekoppeltes Gerät entfernen
clawdbot devices remove <deviceId>

Speicherorte

DM-Richtlinien

Konfigurieren Sie die DM-Richtlinie in ~/.clawdbot/clawdbot.json:

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

Verfügbare Richtlinien

Sicherheits-Best-Practices

1. Verwenden Sie den Kopplungsmodus für Kanäle, die unbekannten Benutzern ausgesetzt sind
2. Überprüfen Sie ausstehende Anfragen regelmäßig
3. Verwenden Sie den Allowlist-Modus für sensible Kanäle
4. Begrenzen Sie ausstehende Anfragen um Spam zu verhindern
5. Überprüfen Sie genehmigte Benutzer regelmäßig

Verwandte Dokumentation

• Einrichtungsanleitung - Erstkonfiguration
• Sicherheit - Sicherheits-Best-Practices
• Kanäle - Kanalkonfiguration