Το CLI διατηρεί έναν λογαριασμό ανά χώρο εργασίας. Τα διαπιστευτήρια βρίσκονται στην κλειδοθήκη του λειτουργικού συστήματος (υπηρεσία hansa)· δεν εμφανίζονται ποτέ στο αρχείο context, στα αρχεία καταγραφής ή στην έξοδο.
Σύνδεση
hansa chat login --workspace yourworkspace
Η εντολή σας ζητά το email και τον κωδικό πρόσβασης. Αν ο χώρος εργασίας απαιτεί έλεγχο ταυτότητας δύο παραγόντων, σας ζητείται κωδικός TOTP ή κωδικός ανάκτησης.
Για δέσμες ενεργειών, διαβάστε τα διαπιστευτήρια από το stdin αντί για επιλογές ή μεταβλητές περιβάλλοντος:
echo '{"email": "you@example.com", "password": "…"}' \
| hansa chat login --workspace yourworkspace --credentials-stdin
Το JSON μπορεί επίσης να περιέχει "totp" ή "recovery_code" όταν απαιτείται έλεγχος ταυτότητας δύο παραγόντων.
Μια έγκυρη αποθηκευμένη συνεδρία κάνει την επανάληψη της σύνδεσης χωρίς κανένα αποτέλεσμα (no-op). Χρησιμοποιήστε το --reauth για να αντικαταστήσετε σκόπιμα την αποθηκευμένη συνεδρία.
Συνεδρίες και ανανέωση
Τα access tokens ανανεώνονται αυτόματα με ένα refresh token που περιστρέφεται, με προστασία από κλείδωμα ανά χώρο εργασίας, ώστε παράλληλες διεργασίες του CLI να μην χαλάσουν ποτέ η μία τη συνεδρία της άλλης. Αν η αποθηκευμένη συνεδρία καταστεί άχρηστη, το CLI την αφαιρεί και σας ζητά να συνδεθείτε ξανά.
Η αποσύνδεση ανακαλεί τη συνεδρία στον διακομιστή και διαγράφει τα αποθηκευμένα διαπιστευτήρια. Η εκτέλεσή της δύο φορές είναι ασφαλής:
hansa chat logout --workspace yourworkspace
Contexts
Ένα context είναι ένας αποθηκευμένος χώρος εργασίας: ο τομέας του, μια προαιρετική παράκαμψη του API και το αν υπάρχουν διαπιστευτήρια. Τα tokens δεν εμφανίζονται ποτέ.
hansa context list # saved contexts, default marker
hansa context show # details for the current workspace
hansa context use yourworkspace # set the default workspace
hansa context remove yourworkspace # log out remotely and delete everything
Σειρά επίλυσης χώρου εργασίας: η επιλογή --workspace, μετά η μεταβλητή περιβάλλοντος HANSA_WORKSPACE, μετά η αποθηκευμένη προεπιλογή.
Περιβάλλοντα χωρίς διεπαφή
Χωρίς κλειδοθήκη (δοχεία CI, εργασίες cron), παρέχετε tokens μέσω του περιβάλλοντος:
export HANSA_ACCESS_TOKEN="…"
export HANSA_REFRESH_TOKEN="…" # optional, enables automatic refresh
Σε αυτή τη λειτουργία τα tokens δεν γράφονται ποτέ στον δίσκο, και η σύνδεση χωρίς χρήσιμη κλειδοθήκη αποτυγχάνει ρητά αντί να αποθηκεύει διαπιστευτήρια σε απλό κείμενο.