# Autenticação

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

## Obtendo um Token

Envie uma solicitação POST para o endpoint de autenticação:

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

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

Resposta:

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

## Usando o Token

Inclua o token no cabeçalho `Authorization` de solicitações subsequentes:

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

## Ciclo de Vida do Token

* Os tokens possuem 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)

## Gerando Chaves JWT

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

Isso cria:

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

Configure a frase-senha no arquivo `.env`:

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

## Documentação da API

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-pt/guia-do-desenvolvedor/developer-guide/api/authentication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.