Esto te permitiría tener un sistema de permisos más detallado, siguiendo el estándar de OAuth2, integrado en tu aplicación OpenAPI (y la documentación de la API).

OAuth2 con scopes es el mecanismo usado por muchos grandes proveedores de autenticación, como Facebook, Google, GitHub, Microsoft, X (Twitter), etc. Lo usan para proporcionar permisos específicos a usuarios y aplicaciones.

Normalmente se utilizan para declarar permisos de seguridad específicos, por ejemplo:

* `users:read` o `users:write` son ejemplos comunes.
* `instagram_basic` es usado por Facebook / Instagram.
* `https://www.googleapis.com/auth/drive` es usado por Google.

/// info | Información

En OAuth2 un "scope" es solo un string que declara un permiso específico requerido.

* Asegúrate de tener modelos Pydantic bien definidos para tus request bodies y responses.
* Configura los permisos y roles necesarios usando dependencias.
* Nunca guardes contraseñas en texto plano, solo hashes de contraseñas.
* Implementa y utiliza herramientas criptográficas bien conocidas, como pwdlib y JWT tokens, etc.
* Añade controles de permisos más detallados con Scopes de OAuth2 donde sea necesario.
* ...etc.

JWT podría ser usado para otras cosas aparte de identificar un usuario y permitirle realizar operaciones directamente en tu API.

Por ejemplo, podrías identificar un "coche" o un "artículo de blog".

Luego, podrías agregar permisos sobre esa entidad, como "conducir" (para el coche) o "editar" (para el blog).

Por ejemplo, digamos que tienes 4 endpoints de API (*path operations*):

* `/items/public/`
* `/items/private/`
* `/users/{user_id}/activate`
* `/items/pro/`

entonces podrías agregar diferentes requisitos de permiso para cada uno de ellos solo con dependencias y sub-dependencias:

```mermaid
graph TB

current_user(["current_user"])
active_user(["active_user"])
admin_user(["admin_user"])
paying_user(["paying_user"])

labels.config_parameter=Parámetro de configuración
labels.max_access_count=Número máximo de accesos
labels.number_of_thread=Número de hilos
labels.interval_time=Intervalo
labels.millisec=milisegundos
labels.permissions=Permisos
labels.virtual_hosts=Hosts virtuales
labels.virtual_host=Host virtual
labels.label_type=Etiqueta
labels.file_crawling_button_create=Crear
labels.file_crawling_button_create_job=Crear nuevo trabajo

labels.config_parameter=Parametro di configurazione
labels.max_access_count=Numero massimo di accessi
labels.number_of_thread=Numero di thread
labels.interval_time=Intervallo
labels.millisec=millisecondi
labels.permissions=Permessi
labels.virtual_hosts=Host virtuali
labels.virtual_host=Host virtuale
labels.label_type=Etichetta
labels.file_crawling_button_create=Crea
labels.file_crawling_button_create_job=Crea nuovo lavoro