Bejelentkezés és az első postafiók megnyitása

Használd ezt az útmutatót, ha az üzemeltető már elvégezte a MailGen setupját. Új gépen az első setuppal kezdj.

Mielőtt elkezded

Kérd az üzemeltetőtől az Account HTTPS-címet és a MailGen BFF HTTPS-címét. Kérdezd meg, melyik bejelentkezési módot és postafiók-szolgáltatót támogatja a deployment. A böngésződnek meg kell bíznia a helyi HTTPS-tanúsítványban. A tanúsítvány-útmutató leírja az ügyféloldali megbízhatóságot.

A dokumentációs URL ezeket az oldalakat nyitja meg. Nem alkalmazásbejelentkezés, és nem szolgáltatói callback.

1. Bejelentkezés

Nyisd meg az Account-címet a /login útvonallal. Használd a beállított e-mail/jelszavas fiókot, vagy egy elérhető Microsoft- vagy Google-gombot. Regisztrálj csak akkor, ha az üzemeltető engedélyezi a regisztrációt.

Az első adminisztrátor a fiókbeállítás során megadott hitelesítő adatokkal jelentkezik be. Más felhasználóknak meg kell kapniuk a szükséges csoporttagságot és jogosultságokat.

Sikeres bejelentkezés után nyisd meg a BFF-címet. Ha a bejelentkezés rossz hosztra vagy portra tér vissza, kérd meg az üzemeltetőt, hogy ellenőrizze a regisztrált callback- és nyilvános origin-beállításokat.

2. Postafiók kiválasztása vagy csatlakoztatása

Nyisd meg a /onboarding oldalt a BFF HTTPS-címén. Az oldal címe Connect Account (magyar felületen: Fiók csatlakoztatása). Ha nincs kiválasztott fiók, a Connect your mailbox felirat jelenik meg (magyar felületen: Kapcsold össze a mailboxod). Ha van kiválasztott fiók, a Prepare your mailbox felirat jelenik meg (magyar felületen: Postafiók előkészítése).

Microsoft-postafiók

Végezd el a Microsoft setup egy postafiók csatlakoztatása és előkészítése szakaszának előfeltételeit. A Microsoft-csatlakozáshoz beállított bejelentkezési hitelesítő adatok, egy meglévő bérlőkapcsolat, megadott hozzájárulás és használható app-only hitelesítő adatok kellenek. Üres adatbázis nem jeleníti meg a Microsoft-gombot pusztán a környezeti hitelesítő adatokból.

1. Ha a kívánt Microsoft-identitás nincs összekapcsolva, válaszd a Folytatás Microsofttal gombot (angol felületen: Continue with Microsoft).
2. Hagyd jóvá az identitás-összekapcsolási kérést, és térj vissza a MailGenbe.
3. Ellenőrizd a kiválasztott fiók e-mail-címét. A munkaterület-kapuban a Mailbox váltása gomb (Switch mailbox) másik, már a bejelentkezésedhez kapcsolt fiókot választ.
4. Válaszd a Kezdeti beállítás indítása gombot (Start onboarding), vagy a munkaterület-kapuban a Postafiók beállítása gombot (Set up mailbox). A szereplőnek mail.onboarding jogosultság kell.
5. Olvasd a megjelenő lépéseket, amíg az A munkaterület megnyitása… felirat (Opening workspace…) meg nem jelenik, és a munkaterület meg nem nyílik.

Az indítás ellenőrzi, hogy birtokolod a kapcsolt fiókot. Nem követeli meg a meglévő postafiók-sort vagy mailboxId-t. A worker feloldja a Microsoft-identitást, létrehozza vagy frissíti a helyi postafiókot, és importálja az adatait. Az elfogadott indítási kérés nem jelenti azt, hogy az import kész.

Setup-hiba esetén olvasd el a megjelenő futás- és lépéshibát. Ha az oldal felajánlja, használd a Kezdeti beállítás újrapróbálása gombot (Retry onboarding), vagy a munkaterület-kapuban a Postafiók beállítása újra gombot (Retry mailbox setup). A sikeres identitás-összekapcsolás nem ad app-only Graph-jogosultságot.

Személyes Gmail-postafiók

Végezd el a Google Cloud setupot. A bejelentkezett szereplőnek accounts.manage jogosultság kell.

1. A Kapcsold össze a mailboxod részben válaszd a Folytatás Google-lel gombot (Continue with Google).
2. Hagyd jóvá a külön Gmail-postafiók-hozzájárulást. A Google-os alkalmazásbejelentkezés önmagában nem ad ehhez hozzáférést.
3. Maradj ugyanabban a MailGen-munkamenetben a callbackig. A callback visszatér a /onboarding oldalra, és kiválasztja a csatlakoztatott Google-fiókot.
4. Várj a Postafiók előkészítése oldalon. Az oldal ezt írja: A mailbox sync folyamatban van. A MailGen akkor nyílik meg, amikor a levelek és a search készen állnak.
5. Várd meg az A munkaterület megnyitása… feliratot és a munkaterület megnyílását.

A Google kezdeti szinkronizálása automatikusan indul. Saját postafiók-OAuth-kötést és haladást használ, a Microsoft-onboardingtól függetlenül. Ha a setup megáll, csak akkor válaszd a Kezdeti beállítás újrapróbálása gombot, ha az oldal felajánlja. Megtagadott hozzáférés esetén ellenőrizd a csatlakozó jogosultságait az üzemeltetővel. Titkosítási zár esetén állítsd vissza a helyes eredeti személyes kulcsot, és csak utána próbálkozz újra.

Lejárt callback vagy munkamenet-eltérés esetén térj vissza a /onboarding oldalra az aktuális munkamenetben, és indítsd újra a Google-kapcsolatot. Ne játszd le a mentett callback URL-t.

3. Tartalom feloldása és üzenet olvasása

Ha az alkalmazás e-mail-kulcsot kér, kövesd a személyes kulcs mentése és feloldása útmutatót. Új tulajdonos a kulcsot létrehozza, és letölti a privát kulcs mentését. Meglévő titkosított tartalommal rendelkező tulajdonos az eredeti mentést importálja. Lásd a titkosítási beállításokat. Cserekulcs nem fejti vissza a régi adatokat. A környezeti ZIP-archívum nem állítja vissza ezt a személyes kulcsot.

Várd meg a postafiók-onboardingot és a szinkronizálást. Nyiss meg egy mappát, majd egy üzenetet. Ellenőrizd a törzset, és ha van, a megengedett mellékletet. Egy látható üzenetsor önmagában nem bizonyítja, hogy a tárolt törzs elérhető.

4. Változás ellenőrzése

Használj eldobható piszkozatot, vagy az üzemeltető által engedélyezett másik műveletet. Ellenőrizd a keletkező állapotot, Microsoft-műveleteknél pedig a Szinkronizálási központot. A sorba állított vagy elfogadott művelet még szolgáltatói megerősítésre várhat. Olvasd el az alapfogalmakat ezen állapotok értelmezése előtt.

Ha a hozzáférés nem működik

Tünet	Következő lépés
Tanúsítványhiba	Kérd az üzemeltetőtől a nyilvános tanúsítványt és a megbízhatósági útmutatót. Soha ne importálj privát kulcsot.
Bejelentkezési szolgáltató nem elérhető	Kérd meg az üzemeltetőt, hogy ellenőrizze a csatlakozó setupját és a pontos callbacket.
Üres postafiók-lista	Nyisd meg a /onboarding oldalt, és ellenőrizd az elérhető szolgáltatói műveleteket. A Microsoft a Microsoft setup bérlőkapcsolat-előfeltételét követeli meg.
Zárolt üzenettörzs	Kövesd a személyes kulcs mentése és feloldása útmutatót a megfelelő tulajdonos eredeti kulcsával.
Az elfogadott változás nem jelenik meg a szolgáltatónál	Vizsgáld meg a művelet állapotát és a szolgáltatóspecifikus korlátokat, mielőtt újrapróbálod.

Folytasd az üzenetek és beszélgetések, a keresés vagy az alkalmazás áttekintés oldalával.