> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokens Koleksiyonu

`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](#uses) 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` |

Migration'lar `tools/migrations/` içindedir.

#### Notlar

* Kullanılmış veya süresi dolmuş bir token hemen silinmez: TTL indeksi onu `createdAt` zamanından 90 gün sonra kaldırana kadar `usedAt` veya geçmiş bir `expiresAt` ile kalır.
* `OneTimeTokenHandler` içinde `getValueFromTokenAndExpire` (`OneTimeTokenHandler.mjs:51-73`) de vardır, ancak hiçbir şey onu çağırmaz.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.