> ## 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` inneholder engangstokener: hemmeligheten i en lenke som lar noen sette et passord. Ett dokument er ett token. Det finnes ingen Mongoose-modell; web skriver samlingen via `services/web/app/src/Features/Security/OneTimeTokenHandler.mjs` med den innebygde driveren.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Dokument-id. | `OneTimeTokenHandler.mjs:40` |
| `use` | String | Hva tokenet er til, se [Bruksområder](#uses) nedenfor. Hvert oppslag filtrerer på det. | `OneTimeTokenHandler.mjs:41` |
| `token` | String | Hemmeligheten i lenken: 32 tilfeldige byte som 64 hekstegn, lagret som det er. | `OneTimeTokenHandler.mjs:38,42` |
| `data` | Object | Hva tokenet står for; returneres når det brukes. | `OneTimeTokenHandler.mjs:43` |
| `data.user_id` | String | Brukerens id, skrevet som streng av hver kaller. | `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 | Brukerens e-post da tokenet ble laget. En tilbakestilling av passord slår opp brukeren via denne primære e-posten (`PasswordResetHandler.mjs:66-70`). | samme som `data.user_id` |
| `createdAt` | Date | Tidspunkt for opprettelse. TTL-indeksen sletter tokenet 90 dager senere. | `OneTimeTokenHandler.mjs:36,44` |
| `expiresAt` | Date | `createdAt` pluss `expiresIn` sekunder: 1 time som standard, 1 uke for en aktiveringslenke. Oppslag ignorerer et token etter dette tidspunktet. | `OneTimeTokenHandler.mjs:35-37,45` |
| `peekCount` | Number | Hvor mange ganger tokenet er sett på uten å bli brukt. Hver `peekValueFromToken` legger til 1; ved 4 (`MAX_PEEKS`) slutter tokenet å virke. | `OneTimeTokenHandler.mjs:8-31,107` |
| `usedAt` | Date | Tidspunkt da tokenet ble brukt eller kansellert. Oppslag ignorerer et token som har det. | `OneTimeTokenHandler.mjs:51-104` |

#### Bruksområder

| `use` | Funksjon | Utløper | Kode |
| - | - | - | - |
| `password` | E-post for tilbakestilling av passord, fra siden "glemt passord" | 1 time | `PasswordResetHandler.mjs:14-42` |
| `password` | Aktiveringslenke: en konto laget med et tilfeldig passord, deretter en lenke for å sette et. Brukes av 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 skriptet `create-user` (`services/web/modules/server-ce-scripts/scripts/create-user.mjs:21`) | 1 uke | `UserRegistrationHandler.mjs:97-130` |
| `password` | Aktiverings- eller tilbakestillingslenke sendt fra adminpanelet (modulen `admin-tools`) | 1 uke (aktivering), 1 time (tilbakestilling) | `AdminUserManager.mjs:76-103,196-206` |
| `email_confirmation` | Lenke for å bekrefte e-post. Leses bare: ingenting i dette repoet lager slike tokener lenger, siden bekreftelsen nå sender en 6-sifret kode (`services/web/app/src/Features/User/UserEmailsConfirmationHandler.mjs:15-35`) | | `UserEmailsConfirmationHandler.mjs:12,37-66` |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `OneTimeTokenHandler.mjs:34-49` (`getNewToken`) | Setter inn et token. Kallere: `PasswordResetHandler.mjs:28`, `UserRegistrationHandler.mjs:115-119`, `AdminUserManager.mjs:77-81`. |
| `OneTimeTokenHandler.mjs:8-32` (`peekValueFromToken`) | Returnerer `data` for et gyldig token og legger 1 til `peekCount`. Brukes når siden for tilbakestilling av passord åpnes (`services/web/app/src/Features/PasswordReset/PasswordResetController.mjs:195-208`), igjen når det nye passordet settes (`PasswordResetHandler.mjs:94-96`), og av e-postbekreftelsen (`UserEmailsConfirmationHandler.mjs:38-41`). |
| `OneTimeTokenHandler.mjs:75-88` (`expireToken`) | Setter `usedAt` på ett token: etter at et nytt passord er satt (`PasswordResetHandler.mjs:44-48,119`) eller en e-post er bekreftet (`UserEmailsConfirmationHandler.mjs:65`). |
| `OneTimeTokenHandler.mjs:90-104` (`expireAllTokensForUser`) | Setter `usedAt` på hvert åpne `password`-token for en bruker, når brukeren endrer passordet i innstillingene (`services/web/app/src/Features/User/UserController.mjs:146-149`) eller en administrator setter det i adminpanelet (`AdminUserManager.mjs:479-488`). |

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `PasswordResetHandler.mjs:50-70,94-119` | Gjør et tilbakestillings- eller aktiveringstoken om til brukeren og setter deretter passordet. Aktiveringssiden i `user-activate` sender bare tokenet videre til dette skjemaet. |
| `UserEmailsConfirmationHandler.mjs:37-66` | Bekrefter en e-post fra et `email_confirmation`-token for den innloggede brukeren. |
| `AdminUserManager.mjs:213-223` (module `admin-tools`) | Finner det åpne aktiveringstokenet til en bruker for å vise aktiveringslenken i adminpanelet igjen. Leser `db.tokens` direkte. |

#### Indekser

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

Migreringene ligger i `tools/migrations/`.

#### Merknader

* Et brukt eller utløpt token slettes ikke med en gang: det blir værende, med `usedAt` eller en passert `expiresAt`, til TTL-indeksen fjerner det 90 dager etter `createdAt`.
* `OneTimeTokenHandler` har også `getValueFromTokenAndExpire` (`OneTimeTokenHandler.mjs:51-73`), men ingenting kaller den.


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