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

# Coleção OAuth Access Tokens

`oauthAccessTokens` contém os tokens bearer que o web aceita. No Ayakaleaf Pro são os tokens de acesso pessoal (tokens de autenticação Git) que um utilizador cria na página de definições da conta e usa para o git-bridge e o endpoint MCP. Um documento é um token. O esquema é `services/web/app/src/models/OauthAccessToken.mjs`; o módulo web `oauth2-server` escreve a coleção, sobretudo com o driver nativo.

#### Campos

| Campo | Tipo | Significado | Origem |
| - | - | - | - |
| `_id` | ObjectId | Id do documento do token. A página de definições apaga um token por este id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Digest hexadecimal SHA-256 do token. O token em texto simples, `olp_` mais 36 letras e dígitos aleatórios, é mostrado uma vez quando é criado e nunca é guardado. | `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 | Os primeiros 8 caracteres do token em texto simples, mostrados nas listas de tokens. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` para todos os tokens criados na página de definições. As consultas de listagem, contagem e eliminação filtram por ele. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Um ano após a criação. Ambas as verificações de token rejeitam um token depois disso, e o índice TTL apaga-o um dia mais tarde. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` do cliente `Overleaf Git Bridge` em [OAuth Applications](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Scopes separados por espaços. Os tokens de acesso pessoal recebem `git_bridge`, o scope exigido pelas rotas do git-bridge e do MCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Dono do token. `createToken` guarda o id de utilizador da sessão tal como está, como string, com o driver nativo; o painel de administração consulta-o como string (`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 da criação. A lista de tokens é ordenada por ele, do mais recente para o mais antigo. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Última vez que o token passou numa verificação. Ambas as verificações de token definem-no. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Só `saveToken` os escreve (o refresh token com hash), e nada chama `saveToken`, veja [OAuth Applications](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Apenas no esquema: nenhum código deste repositório o escreve. Um índice TTL abrange-o. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Apenas no esquema: nenhum código deste repositório os lê ou escreve. | `OauthAccessToken.mjs:20-27` |

#### Quem escreve

| Código | O que faz |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Insere um token de acesso pessoal. A rota `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) exige a funcionalidade `gitBridge` do utilizador e permite 10 tokens por utilizador (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Apaga um token do utilizador. Rota `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Definem `lastUsedAt` após uma verificação bem-sucedida. |

#### Quem lê

| Código | O que faz |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Verifica um token pelo seu hash para `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), que o git-bridge chama em git clone e push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Rejeita um token expirado e o token de um utilizador suspenso ou eliminado. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Verifica um token bearer para `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): as rotas de API do git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) e o endpoint MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Rejeita um token expirado e o token de um utilizador suspenso ou eliminado. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Lista os tokens de um utilizador para a página de definições (`GET /oauth/personal-access-tokens`) e conta-os para o limite. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Mostra os prefixos dos tokens de um utilizador no painel de administração. |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | único, parcial: `refreshToken` existe | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, parcial: `expiresAt` existe | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (substitui `user_id_1` de `20250115110745_oauth_user_id_index_no_partial.mjs`, que substituiu `pat_user_id_1` de `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, parcial: `accessTokenExpiresAt` existe | `20260511104500_expire_oauthAccessTokens.mjs` |

As migrações estão em `tools/migrations/`. O índice único `accessToken_1` vem apenas de migrações marcadas `saas` e `server-pro`, por isso no Community Edition não há índice em `accessToken`.

#### Notas

* Eliminar um utilizador não apaga os seus tokens. `UserDeleter` dispara o hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), mas nenhum módulo o escuta. Ambas as verificações de token rejeitam os tokens porque o utilizador já não existe, e o índice TTL remove-os um dia após `accessTokenExpiresAt`.
* Suspender um utilizador só termina as sessões. Os tokens ficam, e ambas as verificações de token rejeitam-nos enquanto `users.suspended` for `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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