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

# Collezione OAuth Access Tokens

`oauthAccessTokens` contiene i token bearer che web accetta. In Ayakaleaf Pro sono i token di accesso personali (token di autenticazione Git) che un utente crea nella pagina delle impostazioni dell'account e usa per git-bridge e per l'endpoint MCP. Un documento è un token. Lo schema è `services/web/app/src/models/OauthAccessToken.mjs`; il modulo web `oauth2-server` scrive la collezione, per lo più con il driver nativo.

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id del documento del token. La pagina delle impostazioni elimina un token tramite questo id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Digest esadecimale SHA-256 del token. Il token in chiaro, `olp_` più 36 lettere e cifre casuali, viene mostrato una sola volta alla creazione e non viene mai salvato. | `OauthAccessToken.mjs:8`, `services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenManager.mjs:54,72`, `services/web/modules/oauth2-server/app/src/SecretsHelper.mjs:6-11` |
| `accessTokenPartial` | String | I primi 8 caratteri del token in chiaro, mostrati negli elenchi dei token. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` per ogni token creato nella pagina delle impostazioni. Le query di elenco, conteggio ed eliminazione filtrano su questo campo. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Un anno dopo la creazione. Entrambi i controlli dei token rifiutano il token dopo questa data, e l'indice TTL lo elimina un giorno dopo. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` del client `Overleaf Git Bridge` in [OAuth Applications](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Scope separati da spazi. I token di accesso personali ricevono `git_bridge`, lo scope richiesto dalle route di git-bridge e MCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Proprietario del token. `createToken` salva l'id utente della sessione così com'è, come stringa, con il driver nativo; il pannello di amministrazione lo interroga come stringa (`services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:391-392`). | `OauthAccessToken.mjs:16`, `services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenController.mjs:29-41`, `OAuthPersonalAccessTokenManager.mjs:78,83-85` |
| `createdAt` | Date | Momento della creazione. L'elenco dei token è ordinato in base a questo campo, dal più recente. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Ultima volta in cui il token ha superato un controllo. Entrambi i controlli dei token lo impostano. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Li scrive solo `saveToken` (il refresh token con hash), e niente chiama `saveToken`, vedi [OAuth Applications](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Solo nello schema: nessun codice in questo repository lo scrive. Lo copre un indice TTL. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Solo nello schema: nessun codice in questo repository li legge o li scrive. | `OauthAccessToken.mjs:20-27` |

#### Chi scrive

| Codice | Cosa fa |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Inserisce un token di accesso personale. La route `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) richiede la funzionalità `gitBridge` dell'utente e consente 10 token per utente (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Elimina un token dell'utente. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Impostano `lastUsedAt` dopo un controllo riuscito. |

#### Chi legge

| Codice | Cosa fa |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Verifica un token tramite il suo hash per `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), che git-bridge chiama durante git clone e push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Rifiuta un token scaduto e il token di un utente sospeso o eliminato. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Verifica un token bearer per `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): le route API di git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) e l'endpoint MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Rifiuta un token scaduto e il token di un utente sospeso o eliminato. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Elenca i token di un utente per la pagina delle impostazioni (`GET /oauth/personal-access-tokens`) e li conta per il limite. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Mostra i prefissi dei token di un utente nel pannello di amministrazione. |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | univoco, parziale: `refreshToken` esiste | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, parziale: `expiresAt` esiste | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (sostituisce `user_id_1` di `20250115110745_oauth_user_id_index_no_partial.mjs`, che aveva sostituito `pat_user_id_1` di `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, parziale: `accessTokenExpiresAt` esiste | `20260511104500_expire_oauthAccessTokens.mjs` |

Le migrazioni si trovano in `tools/migrations/`. L'indice univoco `accessToken_1` proviene solo da migrazioni con tag `saas` e `server-pro`, quindi in Community Edition non c'è alcun indice su `accessToken`.

#### Note

* Eliminare un utente non elimina i suoi token. `UserDeleter` attiva l'hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), ma nessun modulo lo ascolta. Entrambi i controlli dei token rifiutano i token perché l'utente non esiste più, e l'indice TTL li rimuove un giorno dopo `accessTokenExpiresAt`.
* Sospendere un utente chiude solo le sessioni. I token restano, ed entrambi i controlli dei token li rifiutano finché `users.suspended` è `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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