Start
Appairage et Contrôle d'Accès
Configurez qui peut communiquer avec votre assistant Clawdbot et quels appareils peuvent se connecter à votre Gateway.
Aperçu
L'appairage est l'étape d'approbation explicite du propriétaire utilisée pour la sécurité dans deux contextes :
- Appairage DM - Contrôle qui peut communiquer avec le bot
- Appairage d'Appareils - Contrôle quels appareils/nœuds peuvent rejoindre le réseau du Gateway
Appairage DM (Accès Chat Entrant)
Lorsqu'un canal utilise la politique DM pairing, les expéditeurs inconnus reçoivent un code court et leurs messages sont retenus jusqu'à votre approbation.
Comment Ça Fonctionne
- Un utilisateur inconnu envoie un message à votre bot
- Le bot répond avec un code d'appairage de 8 caractères
- Les messages sont retenus dans une file d'attente
- Vous approuvez ou rejetez la demande d'appairage
- Les utilisateurs approuvés peuvent communiquer librement
Caractéristiques du Code d'Appairage
- 8 caractères majuscules
- Caractères ambigus exclus (0, O, 1, I)
- Expire après 1 heure
- Maximum 3 demandes en attente par canal (par défaut)
Commandes d'Approbation
# Lister les demandes d'appairage en attente
clawdbot pairing list telegram
clawdbot pairing list whatsapp
# Approuver une demande d'appairage
clawdbot pairing approve telegram ABC12DEF
clawdbot pairing approve whatsapp XYZ98GHI
# Rejeter une demande d'appairage
clawdbot pairing reject telegram ABC12DEFCanaux Supportés
| Canal | Commande |
|---|---|
| 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 |
Emplacements de Stockage
| Fichier | Objectif |
|---|---|
~/.clawdbot/credentials/<channel>-pairing.json | Demandes en attente |
~/.clawdbot/credentials/<channel>-allowFrom.json | Utilisateurs approuvés |
Appairage d'Appareils
Les nœuds se connectant au Gateway comme appareils avec role: node nécessitent une approbation via les demandes d'appairage d'appareils.
Commandes d'Approbation d'Appareils
# Lister tous les appareils (en attente et appairés)
clawdbot devices list
# Approuver un appareil
clawdbot devices approve <requestId>
# Rejeter un appareil
clawdbot devices reject <requestId>
# Supprimer un appareil appairé
clawdbot devices remove <deviceId>Emplacements de Stockage
| Fichier | Objectif |
|---|---|
~/.clawdbot/devices/pending.json | Demandes d'appareils en attente |
~/.clawdbot/devices/paired.json | Appareils approuvés |
Politiques DM
Configurez la politique DM dans ~/.clawdbot/clawdbot.json :
{
"channels": {
"whatsapp": {
"dmPolicy": "pairing",
"allowFrom": []
}
}
}Politiques Disponibles
| Politique | Description |
|---|---|
pairing | Exiger une approbation pour les nouveaux expéditeurs |
allowlist | N'autoriser que les expéditeurs pré-approuvés |
open | Autoriser tous les expéditeurs (non recommandé) |
Meilleures Pratiques de Sécurité
- Utilisez le mode appairage pour les canaux exposés à des utilisateurs inconnus
- Examinez les demandes en attente régulièrement
- Utilisez le mode allowlist pour les canaux sensibles
- Limitez les demandes en attente pour prévenir le spam
- Auditez les utilisateurs approuvés périodiquement
Documentation Associée
- Guide d'Installation - Configuration initiale
- Sécurité - Meilleures pratiques de sécurité
- Canaux - Configuration des canaux