Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

License: LGPL-3

MFA Support via TOTP

This module adds support for MFA using TOTP (time-based, one-time passwords). It allows users to enable/disable MFA and manage authentication apps/devices via the “Change My Preferences” view and an associated wizard.

After logging in normally, users with MFA enabled are taken to a second screen where they have to enter a password generated by one of their authentication apps and are presented with the option to remember the current device. This creates a secure, HTTP-only cookie that allows subsequent logins to bypass the MFA step.

Installation

  1. Install the PyOTP library using pip: pip install pyotp

  2. Follow the standard module install process

Configuration

By default, the trusted device cookies introduced by this module have a Secure flag. This decreases the likelihood of cookie theft via eavesdropping but may result in cookies not being set by certain browsers unless your Odoo instance uses HTTPS. If necessary, you can disable this flag by going to Settings > Parameters > System Parameters and changing the auth_totp.secure_cookie key to 0.

Usage

If necessary, a user’s trusted devices can be revoked by disabling and re-enabling MFA for that user.

Try me on Runbot

Known Issues / Roadmap

Known Issues

  • External calls to the Odoo XML-RPC API are blocked for users who enable MFA since there is currently no way to perform MFA authentication as part of this process. However, due to the way that Odoo handles authentication caching, multi-threaded or multi-process servers will need to be restarted before the block can take effect for users who have just enabled MFA.

Roadmap

  • Make the lifetime of the trusted device cookie configurable rather than fixed at 30 days

  • Add device fingerprinting to the trusted device cookie

  • Add company-level settings for forcing all users to enable MFA and disabling the trusted device option

  • Monkey patch 1 is not needed anymore in Werkzeug==0.13 or upper

  • Monkey patch 2 will work until werkzeug.contrib gets removed.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smash it by providing detailed and welcomed feedback.

Credits

Images

  • Odoo Community Association: Icon.

Contributors

Do not contact contributors directly about support or help with technical issues.

Maintainer

Odoo Community Association

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit https://odoo-community.org.

Metadata

Release files for odoo11-addon-auth-totp 11.0.1.1.0.99.dev5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo11-addon-auth-totp 11.0.1.1.0.99.dev5
File Interpreter ABI Platform Actions
odoo11_addon_auth_totp-11.0.1.1.0.99.dev5-py2.py3-none-any.whl Python 3, Python 2 none any Details for odoo11_addon_auth_totp-11.0.1.1.0.99.dev5-py2.py3-none-any.whl

Release files / odoo11_addon_auth_totp-11.0.1.1.0.99.dev5-py2.py3-none-any.whl

Download URL odoo11_addon_auth_totp-11.0.1.1.0.99.dev5-py2.py3-none-any.whl
Size 181.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
33fc6fcacf1adfff4426e69036e9940f9066a351394c58dcf51dc1cb1c67ff60
BLAKE2b-256 checksum
How to use checksums
6671f2bf7ebb8dbe89b3175ee88813ac5c6881e04e1a11c116a59610cfda5895
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.8.5

Security for odoo11-addon-auth-totp 11.0.1.1.0.99.dev5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page