CLI hoiab ühte kontot tööruumi kohta. Mandaadid asuvad operatsioonisüsteemi võtmerõngas (teenus hansa); need ei ilmu kunagi kontekstifailis, logides ega väljundis.
Sisselogimine
hansa chat login --workspace yourworkspace
See küsib teie e-posti ja salasõna. Kui tööruum nõuab kahefaktorilist autentimist, palutakse TOTP-koodi või taastekoodi.
Skriptides lugege mandaadid standardsisendist, mitte lippude ega keskkonnamuutujate kaudu:
echo '{"email": "you@example.com", "password": "…"}' \
| hansa chat login --workspace yourworkspace --credentials-stdin
JSON võib kahefaktorilise autentimise korral sisaldada ka "totp" või "recovery_code".
Kehtiv salvestatud sessioon muudab korduva sisselogimise toimetuks. Kasutage --reauth, et salvestatud sessioon tahtlikult asendada.
Sessioonid ja värskendamine
Juurdepääsutokenid värskendatakse automaatselt pöörleva värskendustokeni abil, mida kaitseb tööruumipõhine lukk, nii et paralleelsed CLI-protsessid ei riku kunagi üksteise sessioone. Kui salvestatud sessioon muutub kasutiskõlbmatuks, eemaldab CLI selle ja palub teil uuesti sisse logida.
Väljalogimine tühistab sessiooni serveris ja kustutab salvestatud mandaadid. Kaks korda käivitamine on ohutu:
hansa chat logout --workspace yourworkspace
Kontekstid
Kontekst on üks salvestatud tööruum: selle domeen, valikuline API-i ülekirjutus ja see, kas mandaadid on olemas. Tokeneid ei kuvata kunagi.
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
Tööruumi lahendamise järjekord: lipp --workspace, seejärel keskkonnamuutuja HANSA_WORKSPACE, seejärel salvestatud vaikeväärtus.
Peata keskkonnad
Ilma võtmerõngata (CI-konteinerid, cron-tööd) andke tokenid keskkonna kaudu:
export HANSA_ACCESS_TOKEN="…"
export HANSA_REFRESH_TOKEN="…" # optional, enables automatic refresh
Selles režiimis ei kirjutata tokenid kunagi kettale ja sisselogimine ilma kasutatava võtmerõngata nurjub selgelt, selle asemel et salvestada mandaadid avatekstina.