tokens, tek kullanımlık tokenleri tutar: birinin parola belirlemesini sağlayan bir bağlantıdaki gizli değer. Bir belge bir tokendir. Mongoose modeli yoktur; web koleksiyona services/web/app/src/Features/Security/OneTimeTokenHandler.mjs üzerinden yerel sürücüyle yazar.
Alanlar
| Alan | Tür | Anlam | Kaynak |
|---|---|---|---|
_id | ObjectId | Belge id’si. | OneTimeTokenHandler.mjs:40 |
use | String | Tokenin ne için olduğu, aşağıdaki Kullanımlar bölümüne bakın. Her arama buna göre filtreler. | OneTimeTokenHandler.mjs:41 |
token | String | Bağlantıdaki gizli değer: 64 onaltılık karakter olarak 32 rastgele bayt; olduğu gibi saklanır. | OneTimeTokenHandler.mjs:38,42 |
data | Object | Tokenin temsil ettiği şey; token kullanıldığında döndürülür. | OneTimeTokenHandler.mjs:43 |
data.user_id | String | Kullanıcının id’si; her çağıran tarafından string olarak yazılır. | services/web/app/src/Features/PasswordReset/PasswordResetHandler.mjs:27, services/web/app/src/Features/User/UserRegistrationHandler.mjs:117, services/web/modules/admin-tools/app/src/AdminUserManager.mjs:79 |
data.email | String | Token oluşturulduğundaki kullanıcı e-postası. Parola sıfırlama, kullanıcıyı bu ana e-postayla bulur (PasswordResetHandler.mjs:66-70). | data.user_id ile aynı |
createdAt | Date | Oluşturulma zamanı. TTL indeksi tokeni 90 gün sonra siler. | OneTimeTokenHandler.mjs:36,44 |
expiresAt | Date | createdAt artı expiresIn saniye: varsayılan 1 saat, etkinleştirme bağlantısı için 1 hafta. Aramalar bu zamandan sonra tokeni yok sayar. | OneTimeTokenHandler.mjs:35-37,45 |
peekCount | Number | Tokenin kullanılmadan kaç kez görüntülendiği. Her peekValueFromToken 1 ekler; 4’e (MAX_PEEKS) ulaşınca token çalışmaz. | OneTimeTokenHandler.mjs:8-31,107 |
usedAt | Date | Tokenin kullanıldığı veya iptal edildiği zaman. Aramalar bu alana sahip tokeni yok sayar. | OneTimeTokenHandler.mjs:51-104 |
Kullanımlar
use | Özellik | Süre | Kod |
|---|---|---|---|
password | ”Parolamı unuttum” sayfasından gönderilen parola sıfırlama e-postası | 1 saat | PasswordResetHandler.mjs:14-42 |
password | Etkinleştirme bağlantısı: rastgele parolayla oluşturulan bir hesap, ardından parola belirlemek için bir bağlantı. Herkese açık kayıt (services/web/modules/login-register/app/src/RegisterController.mjs:65), user-activate modülünün yönetici kayıt sayfası (services/web/modules/user-activate/app/src/UserActivateController.mjs:27-30) ve create-user betiği (services/web/modules/server-ce-scripts/scripts/create-user.mjs:21) tarafından kullanılır | 1 hafta | UserRegistrationHandler.mjs:97-130 |
password | Yönetim panelinden gönderilen etkinleştirme veya parola sıfırlama bağlantısı (admin-tools modülü) | 1 hafta (etkinleştirme), 1 saat (sıfırlama) | AdminUserManager.mjs:76-103,196-206 |
email_confirmation | E-posta doğrulama bağlantısı. Yalnızca okunur: doğrulama artık 6 haneli bir kod gönderdiği için bu depoda artık hiçbir şey bu tür tokenler oluşturmaz (services/web/app/src/Features/User/UserEmailsConfirmationHandler.mjs:15-35) | UserEmailsConfirmationHandler.mjs:12,37-66 |
Kim yazar
| Kod | Ne yapar |
|---|---|
OneTimeTokenHandler.mjs:34-49 (getNewToken) | Bir token ekler. Çağıranlar: PasswordResetHandler.mjs:28, UserRegistrationHandler.mjs:115-119, AdminUserManager.mjs:77-81. |
OneTimeTokenHandler.mjs:8-32 (peekValueFromToken) | Geçerli bir tokenin data değerini döndürür ve peekCount değerine 1 ekler. Parola sıfırlama sayfası açıldığında (services/web/app/src/Features/PasswordReset/PasswordResetController.mjs:195-208), yeni parola belirlenirken tekrar (PasswordResetHandler.mjs:94-96) ve e-posta doğrulamasında (UserEmailsConfirmationHandler.mjs:38-41) kullanılır. |
OneTimeTokenHandler.mjs:75-88 (expireToken) | Bir tokende usedAt değerini ayarlar: yeni parola belirlendikten (PasswordResetHandler.mjs:44-48,119) veya bir e-posta doğrulandıktan sonra (UserEmailsConfirmationHandler.mjs:65). |
OneTimeTokenHandler.mjs:90-104 (expireAllTokensForUser) | Kullanıcı ayarlarda parolasını değiştirdiğinde (services/web/app/src/Features/User/UserController.mjs:146-149) veya bir yönetici yönetim panelinde ayarladığında (AdminUserManager.mjs:479-488), kullanıcının açık tüm password tokenlerinde usedAt değerini ayarlar. |
Kim okur
| Kod | Ne yapar |
|---|---|
PasswordResetHandler.mjs:50-70,94-119 | Bir sıfırlama veya etkinleştirme tokeninden kullanıcıyı bulur, ardından parolayı ayarlar. user-activate modülünün etkinleştirme sayfası tokeni yalnızca bu forma iletir. |
UserEmailsConfirmationHandler.mjs:37-66 | Oturum açmış kullanıcının email_confirmation tokeniyle bir e-postayı doğrular. |
AdminUserManager.mjs:213-223 (module admin-tools) | Etkinleştirme bağlantısını yönetim panelinde yeniden göstermek için kullanıcının açık etkinleştirme tokenini bulur. db.tokens koleksiyonunu doğrudan okur. |
İndeksler
| Ad | Anahtarlar | Seçenekler | Migration |
|---|---|---|---|
token_1_use_1 | { token: 1, use: 1 } | benzersiz | 20190912145031_create_tokens_indexes.mjs |
createdAt_1 | { createdAt: 1 } | TTL, expireAfterSeconds: 7776000 (90 gün) | 20210407085118_token-expiry-with-ttl-index.mjs |
data.user_id_1 | { "data.user_id": 1 } | 20231113173237_tokens_user_id_index.mjs |
tools/migrations/ içindedir.
Notlar
- Kullanılmış veya süresi dolmuş bir token hemen silinmez: TTL indeksi onu
createdAtzamanından 90 gün sonra kaldırana kadarusedAtveya geçmiş birexpiresAtile kalır. OneTimeTokenHandleriçindegetValueFromTokenAndExpire(OneTimeTokenHandler.mjs:51-73) de vardır, ancak hiçbir şey onu çağırmaz.

