jJ=dSrSSKrSSKrSSKrSSKJrJrJr SSKJr SSK r SSK r SSK r SSK r SSK Jr SrSrSrS \4S jrS \S \4S jrS \4S jrS \4SjrS \4SjrSSjrS \4SjrSSjrSS \S \4SjjrS \4SjrS \4SjrSSSjjr S \4Sjr!S\S \4Sjr"S\S \4Sjr#S \4Sjr$g)u Fiók-aktiválás e-mailben küldött linkkel (2026-10-04, E szelet). Részletes leírás Miklósnak és a jövőbeli fejlesztőknek: docs/AKTIVALAS.md MI A LÉNYEG? Régen az admin az új felhasználónak KEZDŐJELSZÓT adott (és valahogy el kellett juttatnia hozzá). Most az admin csak a nevet és az e-mail címet adja meg. A rendszer: 1. a fiókot "aktiválásra váró" állapotban hozza létre (`User.aktivalva = False`), olyan jelszóval, amit senki nem ismer (véletlen) - így a fiókba addig nem lehet belépni; 2. aktiváló levelet küld egy egyszer használatos, 72 órás linkkel; 3. a felhasználó a linken MAGA állítja be a jelszavát - ettől lesz a fiók aktív. A MEGLÉVŐ felhasználók aktiváltnak számítanak (az oszlop DEFAULT 1), nekik semmi nem változik. BIZTONSÁGI DÖNTÉSEK - A token 256 bites véletlen (secrets.token_urlsafe), az `aktivalo_tokenek` táblában CSAK a SHA-256 lenyomata van. (A kiküldött levél törzse a nyers linket tartalmazza, de azt az email_sor a kiküldés után törli - l. email_sor.TITKOS_TORZSU_KATEGORIAK.) - Egyszer használatos (ATOMI foglalás: két párhuzamos kérés közül csak az egyik nyerhet) és 72 óra után lejár. Új link kérésekor az előző tokenek érvényüket vesztik; az újraküldés 5 percenként kérhető (levélbombázás ellen). - A token a FELHASZNÁLÓHOZ kötött: ha egy váró fiók e-mail címét módosítják, a régi link érvényét veszti és az új címre új link megy (különben a régi címet birtokló személy aktiválhatná a fiókot). - Inaktivált fiókra / inaktív cég felhasználójára az aktiválás nem működik. - A link megnyitása (GET) NEM változtat semmit, csak az űrlapot mutatja - a levélszűrők / vírusirtók előzetes "megnyitása" így nem használja el a tokent; a jelszóbeállítás (POST) viszi végbe. - Érvénytelen, lejárt és már felhasznált tokenre ugyanaz a válasz (nem derül ki, melyik eset). - A jelszóbeállításkor a jelszóváltás időpontja is rögzül (JWT-visszavonás, mint a többi jelszócserénél). MIT NE TEGYÉL? - Új felhasználót létrehozó végpontban NE `get_password_hash(jelszo)`-t használj, hanem `jelszo_nelkuli_hash()`-t és `meghivas()`-t (különben a fiók azonnal használható és jelszavas). - A nyers tokent ne naplózd és ne tárold (csak a levélbe és a linkbe kerülhet). N)datetime timedeltatimezone)Optional)get_password_hashH aktivalasreturncd[R"[R5R SS9$)uDTz nélküli UTC pillanat (a DB-ben így tároljuk az időpontokat).N)tzinfo)rnowrutcreplace#/var/www/website/aktivalas_utils.py _utc_mostr3s# << % - -T - ::rtokencz[R"U=(d SRS55R5$)Nzutf-8)hashlibsha256encode hexdigest)rs rtoken_lenyomatr8s) >>5;B..w7 8 B B DDrc@[[R"S55$)uEgy senki által nem ismert (véletlen) jelszó bcrypt-lenyomata: az aktiválásra váró fiókba így semmilyen jelszóval nem lehet belépni.0)rsecrets token_urlsaferrrjelszo_nelkuli_hashr!<s W2226 77rcT[[R"U=(d S/55$)ukIgaz, ha az e-mail cím olyan, amire a levélsor ki tud küldeni (ugyanaz a szabály, mint a küldésnél).r)bool email_sorcimek_tisztitasa)emails remail_ervenyes_er'Bs  **EKR=9 ::rcURSL$)umIgaz, ha a felhasználó aktivált. NULL (régi sor) = aktivált; csak a kifejezett False vár aktiválásra.F) aktivalva)users r aktivalva_er+Gs >> &&rcUR[R5R[RRUR :H5R SS9 g)u^A felhasználó összes aktiváló tokenjének törlése (pl. inaktiváláskor). NEM commitol.Fsynchronize_sessionN)querymodels AktivaloTokenfilteruser_ididdelete)dbr*s rtokenek_torleser7OsCHHV ! !"))&*>*>*F*F$''*QRYYnsYtrc [RnURU5RURUR :HUR [:H5RSS9 [R"S5n[5nURU"UR [U5[XD[[S9-S95 U$)uÚj aktiváló token; az ehhez a felhasználóhoz tartozó korábbi (még fel nem használt) tokenek törlődnek. NEM commitol. Visszatérés: a NYERS token (csak a levélbe kerülhet!).Fr- hours)r3 token_hashcel letrehozva_atlejar_at)r0r1r/r2r3r4r= CEL_AKTIVALASr5rr raddrrTOKEN_ERVENYESSEG_ORA)r6r*Armosts r_token_kiallitasarETs AHHQKqyyDGG+QUUm-CDKK`eKf  ! !" %E ;DFF1TWW)>MAV1W*W YZ Lrc|[R"UVs/sH o"(dM UPM sn5nU(dg[RnUR U5R UR S:HUR[R:HURRU55RSS9 gs snf)uKA kimenő sorban MÉG VÁRAKOZÓ (el nem küldött) aktiváló levelek törlése az adott címekről. Miért? Új link kiállításakor a régi link érvénytelen - a még el nem küldött régi levél csak a közös óránkénti/napi levélkorlátot fogyasztaná, és a címzettet is összezavarná (halott linkkel). NEM commitol.Nr Fr-) r$r%r0 EmailKimenor/r2 kategoriaallapotALLAPOT_VARAKOZIKcimzettin_r5)r6cimekctisztaKs r_sorbeli_regi_levelek_torleserQ`s  ' 'E(?EqQE(? @F AHHQKq{{k1199 @[@[3[yy}}V,..4ff.O )@s B9B9cf[XRU/5 Sn[R"U5nURR S5S-U-nUR (a*UR[RUR 5OSnUbU"UR5OSn SU"UR5SU SUbS U"UR5-S -OS S U"U5S [SU"U5S3 n [R"UR/SU S[RUR US9$)uAz aktiváló levél a kimenő sorba. NEM commitol. A (régi és az új) címre még váró korábbi aktiváló levelek törlődnek (lásd _sorbeli_regi_levelek_torlese).cN[R"UcSSS9$[U5SS9$)NrT)quote)htmlescapestr)xs r_level_sorba..qs$++AIbF3q6Fr/z /aktivalas/Nza rendszergazdau|

Üdvözlünk az EmeLOG rendszerben!

Kedves z!

u fiókot hozott létre számodraz a(z) u cégnélru. A fiók használatához állítsd be a jelszavadat az alábbi gombra kattintva:

Fiók aktiválása

A link u óráig érvényes, és csak egyszer használható. Ha a gomb nem működik, másold a böngésződbe ezt a címet:
u

Ha nem számítottál erre a levélre, hagyd figyelmen kívül - a fiók a link megnyitása nélkül nem használható.

uAktiváld az EmeLOG fiókodatr )rH prioritas company_idr6)rQr&email_beallitasokbetoltalkalmazas_url_vagy_alaprstripr]getr0CompanyusernamenevrBr$ sorba_allitPRIORITAS_NORMAL) r6r*rkuldo regi_emailebealllinkcegkitorzss r _level_sorbarpms8""zz:&>?FA  $ $R (E  ) ) 0 0 5 E MD59__"&& 1$C#/5>> 5FB t}}%&'T1;>?K!CGG* $ 6PR STtWI-./001$y9K L &  $**/NPUal+4+E+ERVRaRafh jjrc^SUlUR5 [X5n[XX25$)uqAz (ÚJ, még db.add-olt) felhasználót aktiválásra váró állapotba teszi, tokent állít ki és kiküldi az aktiváló levelet. Hívás előtt a user.hashed_password-nek `jelszo_nelkuli_hash()`-nek kell lennie. NEM commitol (a hívó commitol az új felhasználóval együtt). Visszatérés: a sorba állított levelek száma (0, ha nincs érvényes e-mail cím).F)r)flushrErp)r6r*rhrs rmeghivasrss+ DNHHJ b 'E % //rc [U5(d)URSLd[UR5(dg[R nUR U5RURUR:HUR[:H5RURR55R5nUb'UR[!5[#[$S9- :ag['X5n[)XXR5 UR+[R,"UR.Ub UROSSSUR0SURS3S95 UR35 g ) uoÚj aktiváló link küldése egy még aktiválásra váró felhasználónak (az előző link érvénytelenné válik). Igaz, ha ki lett küldve (sorba állítva). Hamis, ha a fiók már aktivált / inaktív, az e-mail cím érvénytelen (ilyenkor a régi link ÉRVÉNYBEN marad), vagy az utolsó levél óta még nem telt el UJRAKULDES_VARAKOZAS_PERC perc. COMMITOL.FN)minutesuAktiváló link újraküldve- ()r]r3 field_name old_value new_valueT)r+aktivr'r&r0r1r/r2r3r4r=r@order_byr>descfirstrrUJRAKULDES_VARAKOZAS_PERCrErprAAuditLogr]rdcommit)r6r*rhrCutolsors r ujrakuldesrs 4DJJ%/7G 7S7SA XXa[   TWW 4aee}6L M V VWXWfWfWkWkWm n t t vF f22Y[9UnCo5oo b 'E5(FF6????8IEHHt1St}}o]_`d`j`j_kklLm opIIK rc[U5(ag[X5 URSLa/[UR5(a[ X[ X5X#S9 g[X/5 g)u8Egy váró fiók e-mail címének módosítása után hívandó: a régi címre küldött link érvényét veszti, az ÚJ címre új link megy. (Különben a régi - elgépelt vagy volt - címet birtokló személy aktiválhatná a fiókot.) Nem váró fiókra nem csinál semmit. A hívó commitol. NEM commitol.NF)ri)r+r7r}r'r&rprErQ)r6r*rhris remail_valtozas_kezelesersQ4B zz#3DJJ#?#?R0:EY%b,7rcU(a[U5S:ag[RnURU5R UR [ U5:HUR[:H5R5nUb%URcUR[5::agUR[RUR5nUb[!U5(dUR"SLagUR$(a*UR[R&UR$5OSnUbUR"SLagX44$)uA token alapján visszaadja a (token-sor, felhasználó) párt, ha a token érvényes (létezik, nem használták fel, nem járt le) ÉS a fiók még aktiválásra vár; különben None. Nem módosít semmit.NF)lenr0r1r/r2r<rr=r@rfelhasznalva_atr?rrbUserr3r+r}r]rc)r6rrCsorr*rms rtoken_ellenorzesrs CJ$A ((1+  Q\\^E-BBAEE]DZ [ a a cC {c))59T 66&++s{{ +D |{4((DJJ%,?59__"&& 1$C 399- 9rjelszoc [5n[RnURU5R UR UR :HUR RS55RSU0SS9nUS:waUR5 g[U5Ul XBl SUl [R"XS5 URU5R UR UR :HUR UR :g5R#SS9 UR%[R&"UR(UR SSUR*S UR,S 3S 95 UR/5 g) uA jelszó beállítása és a fiók aktiválása a linken. A hívó előtte ellenőrzi a jelszó erősségét és a token érvényességét. A tokent ATOMIKUSAN foglalja le (`UPDATE ... WHERE felhasznalva_at IS NULL`): ha két kérés egyszerre érkezik ugyanazzal a tokennel, csak az egyik nyer (a másik hamisat kap) - az egyszeri felhasználhatóság így nem függ a MariaDB tranzakció-izolációjától. COMMITOL. Igaz, ha ez a hívás aktiválta a fiókot.NrFr-TuFiók aktiválvaAktiválásra várrwu,) - jelszó beállítva az aktiváló linkenry)rr0r1r/r2r4ris_updaterollbackrhashed_passwordjelszo_valtozott_atr)jelszo_hazirenduj_jelszo_utanr3r5rArr]rdr&r)r6rr*rrDrCfoglalts raktivalrs8 ;DAhhqk  1B1B1F1Ft1LMTT D!uU>G!| ,V4D#DN""2T2HHQKqyyDGG+QTTSVV^<CCX]C^FF6????DGG%1E]]O2djj\1]^ `aIIK rc D[U5(ag[5n[U5UlXAlSUl[ R"XS5 UR[R5R[RRUR:H5RSS9 UR[R "UR"URSSUR$SUR&SUR$3S 95 UR)5 g) uA rendszeradmin kézzel aktivál egy fiókot (pl. ha az SMTP nincs beállítva), és beállítja a jelszót. A jogosultságot (csak rendszeradmin) a HÍVÓ ellenőrzi. Igaz, ha aktivált. COMMITOL.FTNr-uFiók aktiválva kézzelrrwu) - aktiválta: ry)r+rrrrr)rrr/r0r1r2r3r4r5rArr]rdr&r)r6r* rendszeradminrrDs rkezi_aktivalasrs4 ;D,V4D#DN""2T2HHV ! !"))&*>*>*F*F$''*QRYYnsYtFF6????M,<,<-9M]]O2djj\1A-BXBXAYZ \]IIK rc SSKJn U"5n[5[SS9- n[R nUR U5RURU:URRS5URU:--5RSS9n[RnUR U5RURR[[ R"55UR$[5[[&S-S 9- :5R)S S 0SS9 UR+5 UUR-5 $![.aNnUR15 [3S [5U5R6S U35 SnAUR-5 gSnAff=f!UR-5 f=f)uYA lejárt / felhasznált tokenek törlése (1 nap türelmi idővel). SOSEM dob kivételt.r) SessionLocalr)daysNFr-r: torzs_htmlu;

(a levél tartalmát biztonsági okból töröltük)

u0❌ Hiba az aktiváló tokenek takarításakor: z: )databaserrrr0r1r/r2r?risnotr5rGrHrLlistr$TITKOS_TORZSU_KATEGORIAKr>rBrrclose Exceptionrprinttype__name__)rr6hatarrCnrPrjs r takaritasrsm% B iQ//   HHQK   U 2q7H7H7N7Nt7TXYXiXilqXq7rs !!'E!B      1;;??4 0R0R+ST??Y[9K`ceKe;f-ff #V\3p$qHMVN     @aAQAQ@RRTUVTWXY    s*D2E F*4F%F-%F**F--F?)r N)N)%__doc__rrUrrrrtypingrrr0r^r$securityrrBrr@rrWrr!r#r'r+r7rErQintrprsrrrrrrrrrrs B 22 & ;8; E#E#E8S8 ;t; ''u 3  Pj#j#j@004( 8 $346CD,3r