Első indítás: fiókszolgáltatás, kezdő identity administrator, szkriptkulcs

Mind a négy szolgáltatás hitelesít, és ezt kikapcsolni nem lehet: a felhasználók, a jelszavak és a kulcsok a fiókszolgáltatásban élnek, a többi szolgáltatás tőle kérdezi meg, ki mit tehet. Ezért az első indításnál a fiókszolgáltatás jön először, és a sorrend kötött. Ha a Telepítés és eltávolítás fejezet beállítóját futtattad, a lépések nagy része már megtörtént – ez a fejezet akkor is megmutatja, mi történt, és mi a teendőd a belépésnél.

A fogalmak

Fogalom	Mit jelent
identity administrator (magyarul azonosságkezelő)	az a felhasználó, akinek a szerepköre a felhasználókat és a jogosultságokat kezelheti; az elsőt a fiókszolgáltatás maga hozza létre
peer token (magyarul társkulcs)	a szolgáltatás saját kulcsa, amellyel a fiókszolgáltatásnál azonosítja magát; szolgáltatásonként külön
szkriptkulcs	a parancssori szkriptek (feliratozás, fordítás) kulcsa, egy tartós környezeti változóban
fiókcím	a fiókszolgáltatás címe (LCP_ACCOUNT_URL); amíg nincs beállítva, a másik három szolgáltatás el sem indul

1. Az adatbázis

A fiókszolgáltatás az adatait egy PostgreSQL-adatbázisban tartja. Az első indítás előtt ezt kell felhozni, az AccountServer mappa indítójával: Windowson managed-postgres.cmd, macOS-en managed-postgres.command.

• Windowson az adatbázis a gép Dockerében, egy konténerben fut (ehhez a Docker Desktop kell).
• macOS-en natívan fut, a Homebrew postgresql@18 csomagjával – Docker nem kell.

Az első futás megkérdezi, létrehozhatja-e az adatbázist, majd két tartós környezeti változóba írja a kapcsolódás adatait és a webes belépés titkosító kulcsát – mindkettő titok, ne másold sehova. A végén ellenőrzi, hogy a fiókszolgáltatás tényleg be tud-e lépni. Később a fiókszolgáltatás indítója magától elindítja az adatbázist, mielőtt maga elindulna. Külső adatbázis bekötéséről a Karbantartás, mentés, kizáródás fejezet szól.

2. A fiókszolgáltatás első indítása

Indítsd el a fiókszolgáltatást a saját, látható ablakában: AccountServer\start-accountserver.cmd (macOS-en start-accountserver.command).

Az első indulás létrehozza a kezdő identity administratort: egy admin nevű felhasználót, véletlen jelszóval. A jelszó egyszer, ebben az ablakban jelenik meg – naplóba sosem. Írd fel, mielőtt az ablakot bezárnád. Ha az adatbázisban már van belépni képes identity administrator, nem jön létre újabb; ha van, de nincs jelszava, ő kap kezdő jelszót.

Amit még érdemes tudni:

• Az ablak kiírja az adatbázis-kapcsolat titok nélküli leírását is (gép, port, adatbázis, felhasználó).
• Ha a kimenetet fájlba irányítod, a jelszó abba is bekerül – olvasás után töröld a fájlt.
• A szolgáltatás kliensoldali (machine API) portja alapból minden hálózati csatolón figyel, és ezt ki is mondja. Ha csak ezen a gépen kell, indítsd a -HostName localhost kapcsolóval; ha a fiókcím már a 127.0.0.1 címre mutat, az indító magától csak erre a gépre köt.
• A webes felület (a 8101-es vezérlő port) alapból csak erről a gépről érhető el.

3. Belépés és a kötelező jelszócsere

Nyisd meg a böngészőben a http://127.0.0.1:8101/admin címet. A belépőlapon a Név mezőbe admin, a Jelszó mezőbe a kezdő jelszó kerül, utána Belépés.

A belépőlapon a nyelv is átállítható. Az API-kulcs (lcp_…) itt nem működik: a felületre csak névvel és jelszóval lehet belépni.

Kezdő jelszóval belépve a felület rögtön a Jelszócsere lapra visz. Add meg a Jelenlegi jelszó mezőben a kezdő jelszót, az Új jelszó és a Még egyszer mezőben az újat (legalább 8 karakter, nem kezdődhet lcp_-vel), majd kattints Az új jelszó beállítása gombra. Utána az új jelszóval kell újra belépni.

A belépés után a fiókszolgáltatás Áttekintés lapja fogad. Ha a lap tetején zöld pipával a Kiszolgál felirat áll, a szolgáltatás rendben fut; a Szolgáltatás kártyán látod a változatot, a machine API címét és az adatbázist, az Identity-k kártyán pedig, hány felhasználó van, és közülük hány tud belépni.

4. A szolgáltatások bekötése a fiókszolgáltatásba

A fordító, a beszédszolgáltatás és a feliratozó csak akkor indul el, ha tudja, hol a fiókszolgáltatás, és van saját peer tokenje hozzá. Az AccountServer mappa beállítószkriptje mindkettőt elvégzi:

AccountServer\setup-account-peers.ps1 -Tokens     # a három peer token beszerzése
AccountServer\setup-account-peers.ps1 -Check      # hitelesített teszt: elfogadja-e a kulcsokat
AccountServer\setup-account-peers.ps1 -Activate   # a fiókcím beírása

• A -Check az egyetlen bizonyíték arra, hogy a szolgáltatások tényleg megkapják a jogosultsági képet. Kilépési kódja 0, ha minden rendben; 3, ha egy kulcs hiányzik vagy elutasított; 4, ha a fiókszolgáltatás nem érhető el.
• Az aktiválásnak kattintható indítója is van: AccountServer\setup-account-url.cmd (macOS-en .command). Ez a helyi http://127.0.0.1:8100 címet írja be.
• Az aktiválás után zárj be minden nyitott ablakot, és a szolgáltatásokat új ablakból indítsd: a már futó ablakok az új változót nem látják.

A titkot a szkript sosem írja ki és nem menti fájlba: csak a változó nevét és azt, hogy be van-e állítva.

5. A szkriptkulcs

A parancssori szkripteknek (a videók feliratozása, a fájlok fordítása) saját kulcsuk van, amelyet a repó gyökerében álló generate-api-key.cmd (macOS-en .command) ad ki. A kulcs szolgáltatásonként külön tartós környezeti változóba kerül (LCP_SCRIPT_KEY_CAPTIONSERVER, …_TRANSLATORSERVER, …_VOICESERVER), és közben sehol nem jelenik meg – sem a képernyőn, sem naplóban.

generate-api-key.cmd                          # mind a három szolgáltatáshoz
generate-api-key.cmd -Service caption         # csak a feliratozóhoz
generate-api-key.cmd -Service caption -Force  # a meglévő kulcs cseréje

A meglévő kulcsot semmi nem írja felül: ha a változóban már áll kulcs, az eszköz csak megnézi, elfogadja-e a szolgáltatás. Csere csak a -Force kapcsolóval történik. Az új változót az ezután nyitott ablakok látják. A feliratozó szkriptek maguktól is felajánlják a kulcs kiadását, ha nem találnak kulcsot.

6. Kulcs a LiveCaption alkalmazásnak

Az asztali alkalmazás kulcsait a generate-livecaption-key.cmd (macOS-en .command) adja, és rögtön az alkalmazás beállításaiba írja, titkosítva – mintha a Beállítások Szerverek lapján írtad volna be. A LiveCaption közben ne fusson, különben az eszköz 7-es kóddal kilép. macOS-en a kulcsot a macOS-kulcstár (Keychain) őrzi: a kérdésére az egyszeri Engedélyezés a helyes válasz, a Mindig engedélyezés nem.

Egy másik gép vagy felhasználó kulcsairól a Kulcsok és jogosultságok fejezet szól; az alkalmazás oldaláról az alkalmazás kézikönyvének Első indítás fejezete.

Ha elveszett a kezdő jelszó

A jelszó utólag nem olvasható ki sehonnan. Új jelszót a fiókszolgáltatás gépén az AccountServer\maintenance\admin-password.cmd (macOS-en .command) indító ad: az új jelszót rejtve, kétszer kéri be, a nyitott böngésző-munkameneteket pedig érvényteleníti. A futó szolgáltatásokat nem kell hozzá leállítani. Ezután a Napi indítás és leállítás fejezet szerint indíthatod a teljes rendszert.