Skip to content

nextcloud-talk-setup.md

Latest commit

 

History

History
68 lines (46 loc) · 3.9 KB

nextcloud-talk-setup.md

File metadata and controls

68 lines (46 loc) · 3.9 KB

Ρύθμιση Nextcloud Talk

Αυτός ο οδηγός περιγράφει τη διαδικασία ενσωμάτωσης του Nextcloud Talk με το ZeroClaw.

1. Λειτουργία Ενσωμάτωσης

  • Λήψη συμβάντων webhook από bot του Talk μέσω της διαδρομής POST /nextcloud-talk.
  • Επαλήθευση ακεραιότητας μηνυμάτων (HMAC-SHA256) μέσω κοινού μυστικού (shared secret).
  • Αποστολή απαντήσεων στα δωμάτια του Talk μέσω του Nextcloud OCS API.

2. Ρύθμιση

Στο αρχείο ~/.zeroclaw/config.toml, προσθέστε την ενότητα [channels_config.nextcloud_talk]:

[channels_config.nextcloud_talk]
base_url = "https://cloud.example.com"
app_token = "YOUR_APP_TOKEN"
webhook_secret = "YOUR_WEBHOOK_SECRET" # Προαιρετικό
allowed_users = ["*"]

Παράμετροι Ρύθμισης

  • base_url: Το βασικό URL της εγκατάστασης Nextcloud.
  • app_token: Το διακριτικό πρόσβασης (app token) του bot για την εξουσιοδότηση στο OCS API.
  • webhook_secret: Το κοινό μυστικό για την επαλήθευση της κεφαλίδας X-Nextcloud-Talk-Signature.
  • allowed_users: Λίστα με επιτρεπόμενα ID χρηστών (actors). Χρησιμοποιήστε ["*"] για καθολική πρόσβαση.

Συμβουλή: Μπορείτε να χρησιμοποιήσετε τη μεταβλητή περιβάλλοντος ZEROCLAW_NEXTCLOUD_TALK_WEBHOOK_SECRET για να παρακάμψετε τη ρύθμιση του αρχείου.

3. Ρύθμιση Τελικού Σημείου (Endpoint)

Ξεκινήστε τον daemon του ZeroClaw για να εκθέσετε το webhook:

zeroclaw daemon

Στο Nextcloud Talk, ορίστε το URL του webhook για το bot σας ως: https://<YOUR_PUBLIC_URL>/nextcloud-talk

4. Επαλήθευση Υπογραφής

Εάν έχει οριστεί webhook_secret, το ZeroClaw επαληθεύει τις κεφαλίδες:

  • X-Nextcloud-Talk-Random
  • X-Nextcloud-Talk-Signature

Ο αλγόριθμος επαλήθευσης είναι: hex(hmac_sha256(secret, random + raw_request_body)). Σε περίπτωση αποτυχίας, η πύλη επιστρέφει σφάλμα 401 Unauthorized.

5. Φιλτράρισμα και Δρομολόγηση

  • Το ZeroClaw αγνοεί συμβάντα που προέρχονται από άλλα bots (actorType = bots).
  • Αγνοούνται συμβάντα συστήματος ή συμβάντα που δεν περιέχουν μηνύματα.
  • Οι απαντήσεις δρομολογούνται αυτόματα στο σωστό δωμάτιο χρησιμοποιώντας το token δωματίου από το payload του webhook.

6. Βήματα Επαλήθευσης

  1. Ορίστε προσωρινά allowed_users = ["*"].
  2. Στείλτε ένα δοκιμαστικό μήνυμα στο δωμάτιο του Talk.
  3. Επιβεβαιώστε τη λήψη και την απάντηση από το ZeroClaw.
  4. Περιορίστε την πρόσβαση ορίζοντας συγκεκριμένα ID χρηστών στο allowed_users.

7. Αντιμετώπιση Προβλημάτων

  • 404 Not Configured: Βεβαιωθείτε ότι υπάρχει η ενότητα [channels_config.nextcloud_talk].
  • 401 Invalid Signature: Ελέγξτε εάν το webhook_secret ταυτίζεται με αυτό που έχει οριστεί στο Nextcloud.
  • 200 OK χωρίς απάντηση: Το μήνυμα πιθανώς φιλτραρίστηκε (π.χ. προέρχεται από bot ή μη εξουσιοδοτημένο χρήστη).