> ## 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-samlingen

`tokens` indeholder engangstokens: hemmeligheden i et link, der lader nogen angive en adgangskode. Ét dokument er ét token. Der er ingen Mongoose-model; web skriver samlingen via `services/web/app/src/Features/Security/OneTimeTokenHandler.mjs` med den indbyggede driver.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Dokument-id. | `OneTimeTokenHandler.mjs:40` |
| `use` | String | Hvad tokenet er til, se [Anvendelser](#uses) nedenfor. Hvert opslag filtrerer på det. | `OneTimeTokenHandler.mjs:41` |
| `token` | String | Hemmeligheden i linket: 32 tilfældige bytes som 64 hextegn, gemt som det er. | `OneTimeTokenHandler.mjs:38,42` |
| `data` | Object | Hvad tokenet står for; returneres, når det bruges. | `OneTimeTokenHandler.mjs:43` |
| `data.user_id` | String | Brugerens id, skrevet som streng af hver kalder. | `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 | Brugerens e-mail, da tokenet blev oprettet. En nulstilling af adgangskode slår brugeren op via denne primære e-mail (`PasswordResetHandler.mjs:66-70`). | samme som `data.user_id` |
| `createdAt` | Date | Oprettelsestidspunkt. TTL-indekset sletter tokenet 90 dage senere. | `OneTimeTokenHandler.mjs:36,44` |
| `expiresAt` | Date | `createdAt` plus `expiresIn` sekunder: 1 time som standard, 1 uge for et aktiveringslink. Opslag ignorerer et token efter dette tidspunkt. | `OneTimeTokenHandler.mjs:35-37,45` |
| `peekCount` | Number | Hvor mange gange tokenet er blevet set uden at blive brugt. Hver `peekValueFromToken` lægger 1 til; ved 4 (`MAX_PEEKS`) holder tokenet op med at virke. | `OneTimeTokenHandler.mjs:8-31,107` |
| `usedAt` | Date | Tidspunkt, hvor tokenet blev brugt eller annulleret. Opslag ignorerer et token, der har det. | `OneTimeTokenHandler.mjs:51-104` |

#### Anvendelser

| `use` | Funktion | Udløber | Kode |
| - | - | - | - |
| `password` | E-mail til nulstilling af adgangskode fra siden "glemt adgangskode" | 1 time | `PasswordResetHandler.mjs:14-42` |
| `password` | Aktiveringslink: en konto oprettet med en tilfældig adgangskode, derefter et link til at angive en. Bruges af offentlig registrering (`services/web/modules/login-register/app/src/RegisterController.mjs:65`), adminregistreringssiden i `user-activate` (`services/web/modules/user-activate/app/src/UserActivateController.mjs:27-30`) og scriptet `create-user` (`services/web/modules/server-ce-scripts/scripts/create-user.mjs:21`) | 1 uge | `UserRegistrationHandler.mjs:97-130` |
| `password` | Aktiverings- eller nulstillingslink sendt fra adminpanelet (modulet `admin-tools`) | 1 uge (aktivering), 1 time (nulstilling) | `AdminUserManager.mjs:76-103,196-206` |
| `email_confirmation` | Link til bekræftelse af e-mail. Læses kun: intet i dette repo opretter længere sådanne tokens, da bekræftelsen nu sender en 6-cifret kode (`services/web/app/src/Features/User/UserEmailsConfirmationHandler.mjs:15-35`) | | `UserEmailsConfirmationHandler.mjs:12,37-66` |

#### Hvem skriver

| Kode | Hvad den gør |
| - | - |
| `OneTimeTokenHandler.mjs:34-49` (`getNewToken`) | Indsætter et token. Kaldere: `PasswordResetHandler.mjs:28`, `UserRegistrationHandler.mjs:115-119`, `AdminUserManager.mjs:77-81`. |
| `OneTimeTokenHandler.mjs:8-32` (`peekValueFromToken`) | Returnerer `data` for et gyldigt token og lægger 1 til `peekCount`. Bruges, når siden til nulstilling af adgangskode åbnes (`services/web/app/src/Features/PasswordReset/PasswordResetController.mjs:195-208`), igen når den nye adgangskode angives (`PasswordResetHandler.mjs:94-96`), og af e-mailbekræftelsen (`UserEmailsConfirmationHandler.mjs:38-41`). |
| `OneTimeTokenHandler.mjs:75-88` (`expireToken`) | Sætter `usedAt` på ét token: efter at en ny adgangskode er angivet (`PasswordResetHandler.mjs:44-48,119`) eller en e-mail er bekræftet (`UserEmailsConfirmationHandler.mjs:65`). |
| `OneTimeTokenHandler.mjs:90-104` (`expireAllTokensForUser`) | Sætter `usedAt` på hvert åbent `password`-token for en bruger, når brugeren ændrer adgangskoden i indstillingerne (`services/web/app/src/Features/User/UserController.mjs:146-149`) eller en administrator angiver den i adminpanelet (`AdminUserManager.mjs:479-488`). |

#### Hvem læser

| Kode | Hvad den gør |
| - | - |
| `PasswordResetHandler.mjs:50-70,94-119` | Omsætter et nulstillings- eller aktiveringstoken til brugeren og angiver derefter adgangskoden. Aktiveringssiden i `user-activate` sender kun tokenet videre til denne formular. |
| `UserEmailsConfirmationHandler.mjs:37-66` | Bekræfter en e-mail ud fra et `email_confirmation`-token for den indloggede bruger. |
| `AdminUserManager.mjs:213-223` (module `admin-tools`) | Finder en brugers åbne aktiveringstoken for at vise aktiveringslinket i adminpanelet igen. Læser `db.tokens` direkte. |

#### Indekser

| Navn | Nøgler | Indstillinger | Migrering |
| - | - | - | - |
| `token_1_use_1` | `{ token: 1, use: 1 }` | unikt | `20190912145031_create_tokens_indexes.mjs` |
| `createdAt_1` | `{ createdAt: 1 }` | TTL, `expireAfterSeconds: 7776000` (90 dage) | `20210407085118_token-expiry-with-ttl-index.mjs` |
| `data.user_id_1` | `{ "data.user_id": 1 }` | | `20231113173237_tokens_user_id_index.mjs` |

Migreringerne ligger i `tools/migrations/`.

#### Bemærkninger

* Et brugt eller udløbet token slettes ikke med det samme: det bliver, med `usedAt` eller en passeret `expiresAt`, indtil TTL-indekset fjerner det 90 dage efter `createdAt`.
* `OneTimeTokenHandler` har også `getValueFromTokenAndExpire` (`OneTimeTokenHandler.mjs:51-73`), men intet kalder den.


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