A fiókszolgáltatás

A fiókszolgáltatás (accountserver) a termék egyetlen helye, ahol a felhasználók, a szerepkörök és a kulcsok élnek. A feliratozó, a fordító és a beszédszolgáltatás nem tart saját felhasználólistát: félpercenként letöltik innen a jogosultsági képet (a felhasználók, a kulcsok és a jogok másolatát), és abból döntenek. Ez a fejezet a fiókszolgáltatás webes felületének lapjait veszi sorra; a felület a gépén a http://127.0.0.1:8101/admin címen érhető el.

A lapok egy pillantásra

A bal oldali menü első és utolsó lapjai (Áttekintés, Beállítások, Kapcsolatok, Naplók, Futási kép, Hálózat) mind a négy szolgáltatásban megvannak – ezekről a Közös lapok fejezet szól. A fiókszolgáltatásnak hat saját lapja van:

Lap	Mire való
Felhasználók	kik lépnek be, milyen szerepkörrel, melyik szolgáltatáson
Szerepkörök	mit szabad: a jogosultságok elnevezett csomagjai
Kulcsok	a programok kulcsai és a szolgáltatások peer tokenjei
Audit napló	ki, mikor, mit tett, és mi lett belőle
Forgalom	mennyi munkát végeztek a szolgáltatások, kinek
Árazás	modellenkénti szorzó a forgalom súlyozásához

A Felhasználók és a Szerepkörök lap a jogosultságok két fele: a Szerepkörök lap azt mondja meg, mit szabad, a Felhasználók lap azt, hogy kinek.

Felhasználók

A lista soronként egy felhasználó: a neve, a szerepkörei a hatókörükkel, hogy tud-e jelszóval belépni, hány érvényes kulcsa van, és az állapota. A sor végén négy ikon áll: letiltás, szerepkör hozzárendelése, jelszóállítás és törlés.

• Új felhasználó a jobb felső Új felhasználó gombbal. Az új felhasználónak még nincs jogosultsága: szerepkört kell adni neki.
• Szerepkör és hatókör. A szerepkört mindig egy hatókörrel együtt kapja: vagy minden szolgáltatásra, vagy egyetlen szolgáltatásra. A „minden szolgáltatás” a felhasználókezelést is magában foglalja; egy szolgáltatásra szűkítve a felhasználó a többihez nem fér hozzá. Egy felhasználó több szerepkört is kaphat, külön hatókörrel – például Operator a beszédszolgáltatásra és Viewer mindenre.
• Jelszó nélküli felhasználó is lehet: az nem lép be a felületre, csak a kulcsaival hívja a szolgáltatásokat.
• A jelszót senki nem olvashatja vissza, csak újat állíthat. Amit a rendszergazda állít be, azt a felhasználónak az első belépéskor le kell cserélnie – ezt jelzi a „jelszócsere vár” címke.

Amit a lap szándékosan nem enged: az utolsó, belépni képes rendszergazdát nem lehet letiltani vagy törölni. Enélkül senki nem jutna be a felületre, és csak a szolgáltatás gépén, parancssorból lehetne visszajönni (lásd Karbantartás, mentés, kizáródás).

Szerepkörök

A szerepkör jogosultságok elnevezett csomagja; a felhasználó szerepkört kap, nem egyenként jogokat. Öt beépített szerepkör van:

Szerepkör	Kinek való
Administrator	mindent elér: felhasználókat és szerepköröket kezel, kulcsot ad ki, és a szolgáltatások minden lapját használja
Operator	a napi kezelés: modellek, beállítások, dekódolás, naplók – a hálózati és a tanúsítványbeállításokhoz és a felhasználókezeléshez nincs joga
Viewer	csak megnéz: állapot, modellek, beállítások, naplók és a saját kulcsai
ApiUser	programból hívó: a szolgáltatásokat használhatja, a saját kulcsait és forgalmát megnézheti; a lapokhoz nincs joga
AppUser	a LiveCaption alkalmazás fiókja: amit az ApiUser, és mellé a betanított hangprofilok törlése

• A beépített szerepkörök tartalma szerkeszthető, de nem törölhetők. Egy frissítés nem írja felül, amit hozzátett vagy elvett.
• Saját szerepkör az Új szerepkör gombbal készül, és üresen születik: addig semmit nem ad, amíg meg nem adja, mit engedjen.
• Néhány jogosultság mellett emelés jelzés áll: ezek valódi belépést kívánnak, gépi kulccsal és helyi bizalommal sem mennek. Ilyen minden művelet, ami más fiókjához nyúl, vagy titkot ad ki, illetve cserél.
• Egy szerepkör törlése a hozzárendeléseit is elveszi; a lap ezt megkérdezi. Ha egy változtatás után senki nem tudna többé felhasználót kezelni, a művelet elutasul.

Kulcsok

A lap felső táblázata a kulcsokat sorolja: melyik program hívhatja a szolgáltatásokat, és kinek a nevében. Soronként: a név, a tulajdonos, a tulajdonos hatóköre, a kulcs hatóköre, a modellek, az állapot, a lejárat és az utolsó használat. Maga a kulcs sosem látszik: a szolgáltatás csak a hash-ét tárolja, a teljes kulcs egyetlenegyszer, a kiadás után jelenik meg.

Egy kulcs négy állapotú lehet:

• érvényes – használható;
• türelmi időben – lejárt vagy lecserélték, de a csere miatt még működik;
• lejárt – az élettartama letelt;
• visszavonva – azonnal érvénytelenítették; a sor megmarad, de a lista csak A visszavontak is kapcsolóval mutatja.

A sor végi két ikon a csere és a visszavonás. A csere új kulcsot ad ugyanazzal a névvel és hatókörrel, a régi pedig türelmi ideig még él – ez a szokásos, nyugodt út. A visszavonás azonnali, és akkor kell, ha a kulcs kiszivárgott.

Az alsó doboz a peer tokeneké (magyarul társkulcs): ezzel kéri le egy-egy szolgáltatás a jogosultsági képet. Ez nem felhasználói kulcs, és nem ember használja. A kulcsok kiadása, a hatókör szabálya és a peer tokenek kezelése lépésről lépésre a Kulcsok és jogosultságok a klienseknek fejezetben áll.

Audit napló

Az audit napló azt rögzíti, ki, mikor, mit tett, és mi lett belőle: felhasználó létrehozása, jelszó állítása, kulcs kiadása vagy visszavonása, szerepkör adása, beállítás mentése, motor leállítása, napló letöltése. Ez nem azonos a Kapcsolatok lappal (az a hálózati forgalmat mutatja) és a Naplók lappal (az a programok kiírásait): hogy ki állított át valamit, azt csak ez mondja meg.

• A kimenetel háromféle: Megtörtént, Elutasítva (nem volt hozzá joga, vagy lejárt a munkamenete) és Nem sikerült (elindult, de elbukott, vagy a szolgáltatás közben leállt). Az elutasított kísérlet a legértékesebb sor: épp az mutatja meg, ha valaki olyat keres, amihez nincs joga.
• Szűrők: Művelet, Kimenetel, Szolgáltatás, és a Frissítés gomb. A lap egyszerre legfeljebb kétszáz sort mutat, a legfrissebbel elöl – ha a lista tele van, szűkítsen.
• Késés: a fiókszolgáltatás saját műveletei azonnal megjelennek; a másik három szolgáltatásé legfeljebb fél perc múlva, kiesés alatt később.
• Titok sosem kerül a naplóba: a kulcsnak csak a nyilvános azonosítója látszik.
• Ki mit lát: a teljes naplóhoz audit.read.all, a saját sorokhoz audit.read.own jog kell. A sorok 400 napig maradnak meg.

Forgalom

A lap azt mutatja, mennyi munkát végeztek a szolgáltatások, kinek, és milyen súllyal. Az Időszak és a Munka választóval szűkíthető, a Frissítés gombbal frissül.

• A Napi összesítés a hosszabb távú képet adja, és tartósan megmarad. Tízpercenként számolódik újra, ezért a friss forgalom előbb a nyers sorok között látszik.
• A Nyers sorok egy-egy kérés mérését mutatják; 62 napig élnek, hogy egy vitatott tételt vissza lehessen keresni.

Minden munkának egy elszámolási alapja van:

Munka	Az elszámolás alapja
kötegelt átírás	a feldolgozott hang másodperce
élő feliratozás	a fogadott hang másodperce; a munkamenet hossza külön tétel
fordítás	a kimenő token
beszédszintézis	a bemenő karakter
hangklónozás	egy darab

Ha a mért érték hiányzik (például egy fordításnál a modell nem küldött tokenszámot), a sor becsült jelzést kap, és darabban számolódik. Ár és pénznem szándékosan nincs: a szorzó súlyoz, nem pénzt számol. A felolvasott szöveg, a felirat és a fordítás tartalma sosem kerül a mérésbe. A teljes forgalomhoz usage.read.all, a sajátodhoz usage.read.own jog kell.

Árazás

Itt modellenkénti szorzót lehet felvenni, egy időponttól kezdve. A szorzó a mért mennyiséget súlyozza: egy nagyobb modell drágább gépi munkát jelent.

1. Válassza ki a Szolgáltatás mezőben a szolgáltatást.
2. A Modell mezőbe írja a modell pontos nevét, vagy hagyja *-on: az minden modellre szól, de a pontos név erősebb nála.
3. Válassza ki az Egység mezőben, mire szól a szorzó (például audio.second, token.output, text.character).
4. Írja be a Szorzó értékét, és nyomja meg a Mentés gombot.

Amit tudni kell:

• A szorzó a múltat nem írja át. A használat ideje szerint dől el, és a forgalmi sorba rögzül: egy mai áremelés csak a holnapi forgalomra hat, és egy késve beküldött szeptemberi mérés szeptemberi szorzóval számol.
• Ha nincs illeszkedő sor, a szorzó 1,0.
• A szám a felület nyelvét követi (magyarul 1,5, angolul 1.5). Ezreselválasztót ne használjon: az 1.000 egyet jelent, nem ezret. Ami nem szám, azt a lap elutasítja.
• A felvételhez és a törléshez valódi belépés kell, és minden módosítás audit sort hagy.

Beállítások és Futási kép

A fiókszolgáltatás Beállítások lapja csak olvasható – a lap alcíme is kimondja: megmutatja, melyik kapcsoló milyen értékkel fut, és honnan jött (alapérték, appsettings.json, parancssor, környezeti változó). A másik három szolgáltatással szemben a fiókszolgáltatásnak nincs a felületen mentett beállítása: a beállításai indulási beállítások, amelyeket az indító vagy a szolgáltatásként telepített bejegyzés ad meg.

A Futási kép lap azt mutatja, honnan fut a szolgáltatás: a programfájlt, az adatgyökeret, a naplómappát, a jogosultsági kép helyi másolatának helyét, és lejjebb az adatbázis célját – a gépet, a portot, az adatbázis és a felhasználó nevét. A jelszó és a teljes connection string (az adatbázis-kapcsolat egysoros leírása) sosem látszik. Ha a helyi adatbázist a termék saját PostgreSQL-kezelője futtatja, annak állapota is itt áll.

Ha a fiókszolgáltatás nem érhető el

A többi szolgáltatás a legutóbb letöltött jogosultsági képpel dolgozik tovább, ezért egy rövid kiesés a forgalmat nem állítja meg: a kulcsos kérések mennek. Új belépés viszont nincs: a jelszót mindig a fiókszolgáltatás ellenőrzi, így a kiesés alatt egyik szolgáltatás felületére sem lehet belépni – a már belépett munkamenetek élnek tovább. Egy itt elvégzett változtatás (új kulcs, elvett szerepkör) a többi szolgáltatáson legfeljebb fél perc múlva érvényesül; a szolgáltatás Hívók lapján a Változat szám mutatja, melyik képnél tart.

Hova tovább

• Kulcsok és jogosultságok a klienseknek
• Karbantartás, mentés, kizáródás
• Fiókok, kulcsok, jogosultságok útmutató