> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/pt/guia-do-programador/developer-guide/api/authentication.md).

# Autenticação

A API do Chamilo utiliza **JWT (JSON Web Tokens)** para autenticação, implementada através do `lexik/jwt-authentication-bundle`.

## Obtenção de um Token

Envie um pedido POST para o endpoint de autenticação:

```
POST /api/authentication_token
Content-Type: application/json

{
  "username": "admin",
  "password": "your-password"
}
```

Resposta:

```json
{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."
}
```

## Utilização do Token

Inclua o token no cabeçalho `Authorization` dos pedidos subsequentes:

```
GET /api/users
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...
```

## Ciclo de Vida do Token

* Os tokens têm um tempo de expiração configurável
* Quando um token expira, o cliente deve solicitar um novo
* As chaves JWT são armazenadas em `config/jwt/` (chaves privada e pública)

## Geração das Chaves JWT

```bash
php bin/console lexik:jwt:generate-keypair
```

Isto cria:

* `config/jwt/private.pem` — Chave privada para assinar os tokens
* `config/jwt/public.pem` — Chave pública para verificar os tokens

Configure a passphrase em `.env`:

```env
JWT_PASSPHRASE=your-passphrase
```

## Documentação da API

Quando `APP_ENABLE_API_ENTRYPOINT=true` está definido no ambiente, a documentação da API fica disponível em `/api`. Isto disponibiliza uma interface interativa Swagger/OpenAPI para explorar e testar os endpoints.

Definir a variável não é suficiente por si só — a cache do Symfony deve ser limpa para que a alteração tenha efeito. Consulte [Variáveis de Ambiente (.env)](/3.x/pt/guia-de-administracao/admin-guide/installation/configuration.md#enable-the-api-documentation) no Guia de Administração.