CLI glabā vienu kontu katrai darbavitai. Pieteikšanās dati atrodas operētājsistēmas atslēgu krātuvē (pakalpojums hansa); tie nekad neparādās konteksta failā, žurnālos vai izvadē.
Pierakstīšanās
hansa chat login --workspace yourworkspace
Tas pieprasa jūsu e-pastu un paroli. Ja darbavitai ir nepieciešama divu faktoru autentifikācija, tiek vaicāts TOTP kods vai atkopes kods.
Skriptiem pieteikšanās datus lasiet no stdin, nevis no karodziņiem vai vides mainīgajiem:
echo '{"email": "you@example.com", "password": "…"}' \
| hansa chat login --workspace yourworkspace --credentials-stdin
JSON var arī saturēt "totp" vai "recovery_code", kad ir nepieciešama divu faktoru autentifikācija.
Derīga saglabāta sesija padara atkārtotu pierakstīšanos par darbību bez izmaiņām. Izmantojiet --reauth, lai apzināti nomainītu saglabāto sesiju.
Sesijas un atjaunināšana
Piekļuves tokeni tiek automātiski atjaunināti, izmantojot rotējošu refresh token, ko sargā slēdzene katrai darbavitai, lai paralēli CLI procesi nekad nesabojētu viens otra sesiju. Ja saglabātā sesija kļūst nelietojama, CLI to noņem un aicina jūs pierakstīties vēlreiz.
Izrakstīšanās atceļ sesiju serverī un dzēš saglabātos pieteikšanās datus. To palaist divas reizes ir droši:
hansa chat logout --workspace yourworkspace
Konteksti
Konteksts ir viena saglabāta darbavieta: tās domēns, neobligāts API pārrakstījums un tas, vai pieteikšanās dati pastāv. Tokeni nekad netiek rādīti.
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
Darbavietas noteikšanas secība: karodziņš --workspace, tad vides mainīgais HANSA_WORKSPACE, tad saglabātais noklusējums.
Vides bez atslēgu krātuves
Bez atslēgu krātuves (CI konteineri, cron uzdevumi) nodrošiniet tokenus caur vidi:
export HANSA_ACCESS_TOKEN="…"
export HANSA_REFRESH_TOKEN="…" # optional, enables automatic refresh
Šajā režīmā tokeni nekad netiek rakstīti diskā, un pierakstīšanās bez lietojamas atslēgu krātuves neizdodas ar skaidru kļūdu, nevis saglabā pieteikšanās datus vienkāršā tekstā.