HansaChat

Documentation

Autentikacija i radni prostori

Prijava, sesije, pohrana u privjesku, konteksti i tokeni bez sučelja.

CLI čuva jedan račun po radnom prostoru. Vjerodajnice žive u privjesku ključeva operativnog sustava (servis hansa); nikada se ne pojavljuju u datoteci konteksta, zapisnicima ni izlazu.

Prijava

hansa chat login --workspace yourworkspace

To traži unos vaše e-pošte i lozinke. Ako radni prostor zahtijeva dvofaktornu autentikaciju, traži se TOTP kôd ili kôd za oporavak.

Za skripte čitajte vjerodajnice sa stdin umjesto iz zastavica ili varijabli okruženja:

echo '{"email": "you@example.com", "password": "…"}' \
  | hansa chat login --workspace yourworkspace --credentials-stdin

JSON može sadržavati i "totp" ili "recovery_code" kada je potrebna dvofaktorna autentikacija.

Ako postoji valjana spremljena sesija, ponovljena prijava je no-op. Upotrijebite --reauth da biste namjerno zamijenili pohranjenu sesiju.

Sesije i osvježavanje

Access tokeni osvježavaju se automatski pomoću rotirajućeg refresh tokena, pod zaštitom zaključavanja po radnom prostoru, tako da paralelni CLI procesi nikada ne pokvare jedan drugome sesiju. Ako pohranjena sesija postane neupotrebljiva, CLI je uklanja i traži da se ponovno prijavite.

Odjava opoziva sesiju na poslužitelju i briše pohranjene vjerodajnice. Dvostruko pokretanje je sigurno:

hansa chat logout --workspace yourworkspace

Konteksti

Kontekst je jedan spremljeni radni prostor: njegova domena, neobavezni API override i podatak postoje li vjerodajnice. Tokeni se nikada ne prikazuju.

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

Redoslijed razrješivanja radnog prostora: zastavica --workspace, zatim varijabla okruženja HANSA_WORKSPACE, zatim spremljena zadana vrijednost.

Okruženja bez sučelja

Bez privjeska ključeva (CI spremnici, cron zadaci) tokene dostavite putem okruženja:

export HANSA_ACCESS_TOKEN="…"
export HANSA_REFRESH_TOKEN="…"   # optional, enables automatic refresh

Tokeni se u ovom načinu rada nikada ne zapisuju na disk, a prijava bez upotrebljivog privjeska eksplicitno ne uspijeva umjesto da pohranjuje vjerodajnice u čistom tekstu.