Fiókok, kulcsok, jogosultságok

A Live Caption Pro mind a három kiszolgálója hitelesít, és ezt kikapcsolni nem lehet. A felhasználók, a jelszavak és az API-kulcsok egy helyen élnek: a fiókszolgáltatásban (accountserver). A telepítés a Telepítés oldalon van; ez az útmutató a napi kezelésről szól.

Fogalmak

A fiókszolgáltatás és az adatbázisa

A felhasználók, a kulcsok és a jogosultságok egy PostgreSQL-adatbázisban élnek; a helyi adatbázist a repó AccountServer\managed-postgres.cmd indítója futtatja a gép Dockerében. A fiókszolgáltatásból több példány is futhat ugyanazon az adatbázison – egy gépen vagy több gépen: ugyanazokat a felhasználókat és kulcsokat látják, és az egyiken szerzett webes belépés a másikon is érvényes.

A kiszolgálók viszont egyetlen címet ismernek: a LCP_ACCOUNT_URL környezeti változóét (az AccountServer\setup-account-peers.ps1 szkript állítja be), és az kötelező: enélkül a kiszolgálók nem indulnak el. Egy második példány ezért ma tartalék – ha az első kiesik, a címet átírva vehető használatba. A kiszolgálók félpercenként letöltik a fiókszolgáltatástól a jogosultsági pillanatképet (a felhasználók, kulcsok és jogok másolatát), és helyben döntenek. A belépést viszont továbbítják neki, mert a pillanatkép nem hordoz jelszó-hash-t. Az ára: a fiókszolgáltatás (vagy az adatbázisa) kiesése alatt új belépés nincs, a már belépett munkamenetek élnek.

Az adatbázis mentése kézi: AccountServer\managed-postgres.ps1 -Backup, a visszatöltése -Restore <fájl>. A mentés jelszó-hash-eket tartalmaz, ezért bizalmasan kezelendő; a webes belépés kulcsai szándékosan kimaradnak belőle, így visszatöltés után újra be kell lépni.

Az első belépés

Az első indulás – egy üres adatbázison, amit előtte a managed-postgres.cmd hozott fel – felvesz egy admin nevű bejegyzést, és a véletlen jelszavát egyszer, a saját ablakába írja ki – naplóba sosem. Ezért az első indítás a szolgáltatás látható ablakában történik (start-accountserver.cmd); a karbantartási mód kezdő admint nem hoz létre. Ezzel a jelszóval lép be a webes felületre a http://127.0.0.1:8101/admin címen, ahol a felület rögtön új jelszót kér. A felhasználókat és a kulcsokat utána a Felhasználók és a Kulcsok lap adja, vagy a karbantartási mód – a kiszolgálás helyett futó parancssori művelet (-UserAdd, -KeyAdd).

Szerepkörök

A hatókör nem hagyható el: egy szerepkör egy szolgáltatásra vagy mindre szól. Karbantartási módból:

.\start-accountserver.ps1 -RoleGrant kati -Role Operator -Scope voiceserver

API-kulcsok

A kulcs alakja:

lcp_<azonosító>_<titok>

• Az azonosító nyilvános; a titok sosem kerül a storage-be, csak a hash-e (SHA-256). A teljes kulcs a létrehozáskor egyszer látszik.
• Az alapértelmezett lejárat 365 nap. A csere új kulcsot hoz létre, a réginek türelmi időt ad (alapból 7 nap); az átfedés alatt mindkettő működik.
• A visszavonás azonnali, türelmi idő nélkül.
• A kulcs sosem ad többet, mint a gazdája.

A kulcsot a webes Kulcsok lap vagy a karbantartási mód készíti:

.\start-accountserver.ps1 -KeyAdd kati -KeyName "a laptopom"

A feliratozó program a Szerverek lapon kapja meg, és titkosítva, a felhasználói fiókhoz kötve tárolja – másik gépre nem vihető át. A parancssori szkriptek saját kulcsát a generate-api-key.cmd adja ki. Egy másik gép vagy felhasználó hozzáférését – fiókot, AppUser szerepkört és mind a három kulcsot – a generate-user-key.cmd adja ki egy lépésben, és a titkokat a konzolra, kérésre egy fájlba is kiírja.

Elveszett jelszó

A kivezető út a fiókszolgáltatás gépén futó karbantartási mód – akkor is működik, ha a szolgáltatás épp nem fut (az adatbázisnak viszont futnia kell):

.\start-accountserver.ps1 -UserPassword admin

Parancssori jelszó szándékosan nincs: a jelszó a szabványos bemenetről jön egyetlen sorban, vagy a program sorsol egyet, és egyszer kiírja. A jelszóállítás minden nyitott böngésző-munkamenetet érvénytelenít.

Audit napló

Ki, mikor, mit tett, és mi lett belőle: a szándékos műveletek 400 napig megmaradnak, és az Audit napló lap mutatja őket, szűrhetően. Az elutasított kísérlet is sor. Titok sosem kerül beléjük. Mindenki soraihoz audit.read.all, a saját soraihoz audit.read.own jog kell.

Forgalommérés

Mennyi munkát végeztünk, kinek, és milyen súllyal: a sorokat a Forgalom lap mutatja, a szorzókat az Árazás lap állítja. Ár és pénznem szándékosan nincs – csak mérés és modellenkénti súly.

A felolvasott szöveg, a felirat és a fordítás eredménye sosem kerül a mérésbe. A szorzó a használat idejekor dől el, és a sorba fagy: egy későbbi árváltozás nem írja át a múltat. A nyers sorok 62 napig maradnak, a napi összesítés tartósan.

Ha elakad: Hibaelhárítás, vagy a Kapcsolat oldal.