Este módulo proporciona FastAPI Depends para permitir la autenticación con auth_jwt.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Añade autenticación mediante token bearer JWT a los endpoints de FastAPI en Odoo, lo que permite a los desarrolladores de API proteger rutas e identificar al usuario o partner que realiza la llamada a partir de un token firmado.
Este módulo es un componente básico para desarrolladores de la integración de FastAPI con Odoo. No añade menús, pantallas ni botones para los usuarios finales; en su lugar, proporciona ayudantes de autenticación ya preparados que los desarrolladores de API pueden adjuntar a sus rutas de FastAPI.
- Acepta un token JWT enviado en la cabecera Authorization estándar, o en una cookie cuando el validador configurado permite cookies.
- Valida el token contra los validadores JWT configurados en Odoo, incluidos los validadores encadenados, y devuelve una respuesta clara 401 Unauthorized cuando el token falta, está mal formado o no es válido.
- Puede exponer la carga útil del token decodificado, el entorno de usuario de Odoo, o el
res.partnervinculado al token, para que cada ruta de API pueda trabajar con el usuario y los derechos de acceso correctos. - Admite autenticación opcional: las rutas pueden permitir el acceso anónimo y recurrir al usuario público cuando no se proporciona ningún token.
- Cuando el modo cookie está habilitado, renueva la cookie de autenticación en la respuesta.
Se basa en los módulos fastapi y auth_jwt y en las bibliotecas de Python pyjwt y cryptography. Utiliza auth.jwt.validator para la validación y res.partner para la identificación del partner. Este módulo no crea trabajos programados, correos electrónicos ni documentos de negocio.
Lo necesitan otros módulos
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 2 confirmadas, 7 sin información de 9 versiones.
Fuentes · Odoo 16.0
Confirmado el 2026-11-03 en la rama 16.0 de OCA/rest-framework.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Se proporcionan las siguientes dependencias de FastAPI y se pueden importar desde odoo.addons.fastapi_auth_jwt.dependencies:
def auth_jwt_authenticated_payload() -> Payload
> Devuelve el payload JWT autenticado. Lanza un 401 (unauthorized) si > está ausente o no es válido.
def auth_jwt_optionally_authenticated_payload() -> Payload | None
> Devuelve el payload JWT autenticado, o None si la cabecera Authorization y > la cookie están ausentes. Lanza un 401 (unauthorized) si están > presentes y no son válidos.
def auth_jwt_authenticated_partner() -> Partner
> Obtiene el partner autenticado correspondiente al token JWT > proporcionado, según la estrategia de partner definida en el > validador auth_jwt. Lanza un 401 (unauthorized) si el partner no se pudo > determinar por cualquier motivo. > > Esta es una función adecuada y destinada a sobrescribir > odoo.addons.fastapi.dependencies.authenticated_partner_impl. > > El registro de partner devuelto por esta función está vinculado a un > entorno que utiliza el usuario de Odoo obtenido de la estrategia de > usuario definida en el validador auth_jwt. Cuando se usa > authenticated_partner_impl esto a su vez garantiza que > odoo.addons.fastapi.dependencies.authenticated_partner_env también esté > vinculado al usuario de Odoo correcto.
def auth_jwt_optionally_authenticated_partner() -> Partner
> Igual que auth_jwt_partner excepto que devuelve un recordset vacío vinculado > al usuario public si la cabecera Authorization y la cookie están > ausentes, o si el validador JWT no pudo encontrar el partner y > declara que el partner no es obligatorio.
def auth_jwt_authenticated_odoo_env() -> Environment
> Devuelve un entorno de Odoo utilizando el usuario de Odoo obtenido de la > estrategia de usuario definida en el validador auth_jwt, si la solicitud > se pudo autenticar utilizando un validador JWT. Lanza un 401 > (unauthorized) en caso contrario. > > Esta es una función adecuada y destinada a sobrescribir > odoo.addons.fastapi.dependencies.authenticated_odoo_env_impl.
def auth_jwt_default_validator_name() -> str | None
> Devuelve el nombre del validador JWT predeterminado a utilizar. > > La implementación predeterminada devuelve None lo que significa que solo se permite un validador JWT > activo. Esta dependencia está destinada a ser sobrescrita.
def auth_jwt_http_header_authorization() -> str | None
> De forma predeterminada, devuelve la parte de credenciales de la cabecera Authorization, > o None si está ausente. Esta dependencia está destinada a ser sobrescrita, en > particular con fastapi.security.OAuth2AuthorizationCodeBearer para > permitir que swagger gestione la autorización OAuth2 (dicha sobrescritura solo es > necesaria por comodidad al usar la interfaz de swagger).
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.