HansaChat

Documentation

Autentifikácia a workspacy

Prihlásenie, relácie, ukladanie do kľúčenky, kontexty a tokeny bez kľúčenky.

CLI uchováva jeden účet na workspace. Prihlasovacie údaje sú uložené v kľúčenke operačného systému (služba hansa); nikdy sa neobjavia v kontextovom súbore, v logoch ani vo výstupe.

Prihlásenie

hansa chat login --workspace yourworkspace

Príkaz si vyžiada váš e-mail a heslo. Ak workspace vyžaduje dvojfaktorové overenie, zobrazí sa výzva na kód TOTP alebo kód na obnovenie.

V skriptách načítajte prihlasovacie údaje zo štandardného vstupu namiesto volieb príkazu alebo premenných prostredia:

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

JSON môže pri vyžadovanom dvojfaktorovom overení obsahovať aj "totp" alebo "recovery_code".

Platná uložená relácia spôsobí, že opakované prihlásenie nič nezmení (no-op). Pomocou --reauth uloženú reláciu zámerne nahradíte.

Relácie a obnovovanie

Prístupové tokeny sa obnovujú automaticky pomocou rotujúceho obnovovacieho tokenu, chránené zámkom pre každý workspace, takže paralelné procesy CLI si nikdy nepokazia navzájom relácie. Ak sa uložená relácia stane nepoužiteľnou, CLI ju odstráni a vyzve vás na nové prihlásenie.

Odhlásenie zruší reláciu na serveri a odstráni uložené prihlasovacie údaje. Dvojité spustenie je bezpečné:

hansa chat logout --workspace yourworkspace

Kontexty

Kontext je jeden uložený workspace: jeho doména, voliteľný override API a informácia, či existujú prihlasovacie údaje. Tokeny sa nikdy nezobrazujú.

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

Poradie rozpoznávania workspaceu: voľba --workspace, potom premenná prostredia HANSA_WORKSPACE, potom uložený predvolený workspace.

Headless prostredia

Bez kľúčenky (kontajnery CI, cron úlohy) poskytnite tokeny prostredníctvom premenných prostredia:

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

V tomto režime sa tokeny nikdy nezapíšu na disk a prihlásenie bez použiteľnej kľúčenky zlyhá explicitne namiesto uloženia údajov v čitateľnej podobe.