Kulcsok és jogosultságok a klienseknek

A feliratozó, a fordító és a beszédszolgáltatás mindig hitelesít, ezt kikapcsolni nem lehet. Minden program, amelyik hívja őket – a LiveCaption alkalmazás, a parancssori kliensek, a saját szkriptjei –, egy API-kulccsal azonosítja magát. A kulcsot a fiókszolgáltatás adja ki, és a kulcs mindig egy felhasználóé: annyit tehet, amennyit a gazdája. Ez a fejezet azt írja le, hogyan kap kulcsot egy kliens, és hogyan ellenőrizhető, hogy a szolgáltatás elfogadja-e.

Melyik kliensnek milyen kulcs

Kliens	A kulcs útja
a LiveCaption ugyanazon a gépen, ahol a fiókszolgáltatás fut	a generate-livecaption-key eszköz kiadja, és egyből az alkalmazás beállításába írja
a LiveCaption egy másik gépen vagy másik felhasználónál	a generate-user-key eszköz vagy a Kulcsok lap; a kulcsot a LiveCaption beállítóablakának Szerverek lapjára kell beírni
a parancssori szkriptek (átírás, kötegelt feliratozás)	a generate-api-key eszköz; a szkriptek kérdés után maguk is kérnek kulcsot
egy saját program	a Kulcsok lap, egy erre a célra felvett felhasználó nevére
maguk a szolgáltatások	nem API-kulcs, hanem peer token – lásd lent

A LiveCaption a kulcsot titkosítva, a gép felhasználói fiókjához kötve tárolja: Windowson a bejelentkezett felhasználóhoz, macOS-en a macOS-kulcstárban (Keychain) tartott kulccsal. Ezért egy kulcs nem vihető át másik gépre egy beállításfájl másolásával – minden munkaállomás saját kulcsot kap.

Kulcs kiadása a Kulcsok lapon

1. Lépjen be a fiókszolgáltatás webes felületére, és nyissa meg a Kulcsok lapot.
2. Nyomja meg a jobb felső Új kulcs gombot.
3. Válassza ki a Tulajdonos mezőben, kinek a nevében dolgozik a kulcs. Az ablak alatta kiírja a tulajdonos hatókörét: a kulcs ennél többet sosem tehet.
4. Adjon a kulcsnak beszédes nevet A kulcs neve mezőben – például a gép vagy a program nevét. Ez látszik a listákban és az audit naplóban.
5. A Szolgáltatások mezőt hagyja üresen, ha a kulcs mindhárom szolgáltatáson működjön; ha csak egyen, válassza ki azt. A szűkítés nem ad jogot, csak elvesz.
6. A Modellek (nem kötelező) mezőben a kulcs modellekre is szűkíthető, vesszővel elválasztva; ma ezt a fordító értelmezi.
7. Az Érvényesség (nap) alapból 365. Üresen hagyva a kulcs sosem jár le – de az elveszett, lejárat nélküli kulcs is örökké él.
8. Nyomja meg a Kiadás gombot.

A kiadás után az ablak egyetlenegyszer mutatja a teljes kulcsot. Másolja ki a mező melletti gombbal, és tegye biztos helyre; a szolgáltatás csak a hash-ét tárolja, tehát később nem lehet előszedni – ha elvész, újat kell kiadni. Csak akkor nyomja meg az Elmentettem gombot, ha a kulcs már megvan.

A kulcs lcp_ előtaggal kezdődik; a kliens a kérés Authorization: Bearer fejlécében küldi. A szolgáltatások legfeljebb fél perc múlva fogadják el: addig töltik le a következő jogosultsági képet.

A kulcs beírása a LiveCaptionbe

A kulcsot a LiveCaption beállítóablakának Szerverek lapján kell megadni, mindhárom szolgáltatásnál a címe mellett. A cím melletti ellenőrző gomb megkérdezi a szolgáltatást, és a mező keretén zölden vagy pirosan mutatja az eredményt. A lépések az alkalmazás kézikönyvének Első indítás fejezetében állnak.

Kulcs egy lépésben: a kulcsíró eszközök

A fiókszolgáltatás gépén három eszköz rövidíti le a kiadást. Mindegyik a repó gyökerében áll, Windowson .cmd, macOS-en és Linuxon .command indítóval:

# a LiveCaption ezen a gépen: kiadja a három kulcsot, és az alkalmazás beállításába írja
.\generate-livecaption-key.cmd
# egy másik gép vagy felhasználó: fiók, AppUser szerepkör és három kulcs egy lépésben
.\generate-user-key.cmd -UserName kovacs.anna -OutFile kovacs-anna-kulcsok.txt
# a parancssori szkriptek saját kulcsa, tartós környezeti változóba
.\generate-api-key.cmd

• A generate-livecaption-key futása alatt a LiveCaption ne fusson: a futó alkalmazás a beállításait a memóriában tartja, és az eszköz ilyenkor nem ír. A meglévő kulcshoz csak a -Force kapcsolóval nyúl. macOS-en a rendszer engedélyt kérhet a kulcstárhoz: az egyszeri Engedélyezés a helyes válasz, a „Mindig engedélyezés” nem.
• A generate-user-key a kulcsokat a konzolra, kérésre egy csak a futtatóé fájlba írja; ezeket kell a másik gépen a Szerverek lapra beírni. A fájlt átadás után törölje.
• A kulcsok külön, erre a célra létrehozott fiókra szólnak (például livecaption-<gép>-<felhasználó>), így a gépenként kiadott hozzáférés egyenként visszavonható.

A hatókör és a jogosultság metszete

Amit egy kulccsal érkező kérés tehet, az a tulajdonos jogosultságainak és a kulcs hatókörének metszete:

• Üres hatókör: a kulcs minden szolgáltatáson működik – annyit tehet, amennyit a tulajdonosa.
• Egy szolgáltatásra szűkítve: csak ott működik, a többi szolgáltatás ismeretlen kulcsnak veszi.
• A kulcs sosem ad többet a gazdájánál. Ha a tulajdonostól elvesz egy szerepkört, a kulcsai is szűkülnek, külön visszavonni nem kell őket.

A LiveCaption kulcsainak tulajdonosa az AppUser szerepkört kapja: ezzel használhatja a szolgáltatásokat, és törölheti a tolmácsolás betanított hangprofiljait. A szolgáltatások lapjaihoz ez a szerepkör nem ad hozzáférést. A webes felületre kulccsal belépni nem lehet – az kizárólag a jelszóé.

Csere, visszavonás, lejárat

• A csere (a sor végén a körbeforgó nyilak) új kulcsot ad ugyanazzal a névvel és hatókörrel, a régi pedig türelmi időt kap (alapból 7 nap). Az átfedés alatt mindkettő működik, tehát a gépeket nyugodtan át lehet állítani. Egy lejárt kulcs cseréje is használható kulcsot ad.
• A visszavonás (a sor végén a tiltójel) azonnali, türelmi idő nélkül. Akkor kell, ha a kulcs kiszivárgott.
• A lejárat alapból egy év. Érdemes a lejárat előtt cserélni: a csere nem baj jele, hanem jó szokás.

A szolgáltatások peer tokenje

A Kulcsok lap alsó dobozában a peer tokenek állnak. Ezzel kéri le egy szolgáltatás a jogosultsági képet a fiókszolgáltatástól. Amíg egy szolgáltatásnak nincs peer tokenje, nem kap képet, és minden itt kiadott kulcsot elutasít 401-gyel – ez a leggyakoribb oka annak, ha egy frissen kiadott kulcs az egyik szolgáltatáson „nem működik”.

A szolgáltatás sorában a Kiadás gomb készít peer tokent, a Csere újat ad helyette (a régi azonnal érvénytelen), az Eltávolítás törli. A kiadás után egy lépés hátravan, amit a böngésző nem tud elvégezni: a titkot a szolgáltatás gépén a táblázatban látható környezeti változóba (például LCP_ACCOUNT_TOKEN_TRANSLATORSERVER) kell tenni, és a szolgáltatást újraindítani. A kiadás utáni ablak ezért a kimásolható parancsot is kiírja. Egy gépen a három peer tokent egyszerre az AccountServer\setup-account-peers eszköz teszi a helyére (-Tokens), és ellenőrzi is (-Check).

Ellenőrzés a szolgáltatás oldalán: a Hívók lap

Minden motoros szolgáltatás (feliratozó, fordító, beszédszolgáltatás) webes felületén van egy Hívók lap. Ez azt mutatja, kik érhetik el ezt a szolgáltatást, és mivel – pontosan abból a jogosultsági képből, amiből a szolgáltatás dönt. Szerkeszteni itt semmit nem lehet: a felhasználók és a kulcsok a fiókszolgáltatásban élnek.

• Változat és Letöltve: a jogosultsági kép sorszáma és letöltési ideje. Ha egy friss kulcs még nem látszik, a következő letöltés (legfeljebb fél perc) hozza.
• Felhasználók: kik férnek hozzá ehhez a szolgáltatáshoz, hány jogosultsággal.
• Kulcsok: a kulcsok nyilvános azonosítója rövidítve, a tulajdonossal, a lejárattal és az állapottal.

Ha a fiókszolgáltatás nem érhető el, a szolgáltatás az utolsó érvényes képpel dolgozik tovább, és a lap kiírja, ha a képet a helyi másolatból vette. Ha a kép 24 óránál régebbi, piros sáv jelzi: a kulcsos forgalom ilyenkor is megy, a felületen viszont minden emelést kívánó művelet elutasul.

Ki használja: a Kapcsolatok lap

A Kapcsolatok lap a szolgáltatás utolsó 200 kérését mutatja, a legfrissebbel elöl: az időpontot, a módot és az útvonalat, a válasz kódját, az időket, a méretet és a klienst, vagyis a kulcs nevét. Itt látszik a legkönnyebben, hogy egy kliens kulcsa eljut-e a szolgáltatásig, és milyen választ kap.

• A 200-as kód sikeres kérés; a 401 azt jelenti, hogy a szolgáltatás a kulcsot nem fogadta el; a 403, hogy a kulcs ismert, de a gazdájának nincs joga az adott művelethez.
• Az egészségjelentés (/health) kérései kulcs nélkül is válaszolnak, ezért náluk a kliens helyén „–” áll; a szkriptek gyakran pingelik, a lista tele lehet velük.
• A lekérdezési sztring (a ? utáni rész) sosem kerül a listába, mert abban kulcs is lehet. A lista a szolgáltatás leállításával elvész; tartósan a naplófájl őrzi a kéréseket.

A fordítón és a beszédszolgáltatáson nincs élő kapcsolat: a kérések másodpercek alatt lezajlanak, ezért a kéréstörténet többet mond egy „aktív kapcsolatok” listánál. A feliratozó Kapcsolatok lapján az élő feliratozás munkamenetei is látszanak.

Ha a kulcs nem működik

Tünet	Ok és teendő
egy frissen kiadott kulcs 401-et kap	várjon fél percet: a szolgáltatás a következő jogosultsági képpel veszi át; a Hívók lapon a kulcsnak meg kell jelennie
egy szolgáltatás minden kulcsot elutasít	a szolgáltatásnak nincs peer tokenje, vagy a fiókszolgáltatás nem fogadja el; nézze meg a Kulcsok lap alsó dobozát, és futtassa a setup-account-peers -Check ellenőrzést
a kulcs az egyik szolgáltatáson működik, a másikon nem	a kulcs egy szolgáltatásra van szűkítve; adjon ki egy szűkítés nélkülit, vagy szolgáltatásonként egyet
a kulcs 403-at kap	a tulajdonosnak nincs joga a művelethez: nézze meg a szerepkörét és a hatókörét a Felhasználók lapon
a LiveCaption a mentett kulcsot nem tudja használni	a beállításfájl másik gépről vagy felhasználótól való; a titkosítás gépenkénti, a kulcsot újra kell adni

Hova tovább

• A fiókszolgáltatás lapjai
• Távoli GPU-szerver, több munkaállomás
• Hibaelhárítás