Store accounts and credentials
Project description
Keychain Account
This module allows you to store credentials of external systems.
All the crendentials are stored in one place: easier to manage and to audit.
Multi-account made possible without effort.
Store additionnal data for each account.
Validation rules for additional data.
Have different account for different environments (prod / test / env / etc).
By default, passwords are encrypted with a key stored in Odoo config. It’s far from an ideal password storage setup, but it’s way better than password in clear text in the database. It can be easily replaced by another system. See “Security” chapter below.
Accounts may be: market places (Amazon, Cdiscount, …), carriers (Laposte, UPS, …) or any third party system called from Odoo.
This module is aimed for developers. The logic to choose between accounts will be achieved in dependent modules.
Uses cases
Possible use case for deliveries: you need multiple accounts for the same carrier. It can be for instance due to carrier restrictions (immutable sender address), or business rules (each warehouse use a different account).
Configuration
After the installation of this module, you need to add some entries in Odoo’s config file: (etc/openerp.cfg)
> keychain_key = fyeMIx9XVPBBky5XZeLDxVc9dFKy7Uzas3AoyMarHPA=
You can generate keys with python -c ‘from cryptography.fernet import Fernet; print Fernet.generate_key()’.
This key is used to encrypt account passwords.
If you plan to use environments, you should add a key per environment:
> keychain_key_dev = 8H_qFvwhxv6EeO9bZ8ww7BUymNt3xtQKYEq9rjAPtrc=
> keychain_key_prod = y5z-ETtXkVI_ADoFEZ5CHLvrNjwOPxsx-htSVbDbmRc=
keychain_key is used for encryption when no environment is set.
Usage (for module dev)
Add this keychain as a dependency in __manifest__.py
Subclass keychain.account and add your module in namespaces: (see after for the name of namespace )
class LaposteAccount(models.Model):
_inherit = 'keychain.account'
namespace = fields.Selection(
selection_add=[('roulier_laposte', 'Laposte')])
Add the default data (as dict):
class LaposteAccount(models.Model):
# ...
def _roulier_laposte_init_data(self):
return {
"agencyCode": "",
"recommandationLevel": "R1"
}
Implement validation of user entered data:
class LaposteAccount(models.Model):
# ...
def _roulier_laposte_validate_data(self, data):
return len(data.get("agencyCode") > 3)
In your code, fetch the account:
import random
def _get_auth(self):
keychain = self.env['keychain.account']
if self.env.user.has_group('stock.group_stock_user'):
retrieve = keychain.suspend_security().retrieve
else:
retrieve = keychain.retrieve
accounts = retrieve(
[['namespace', '=', 'roulier_laposte']])
account = random.choice(accounts)
return {
'login': account.login,
'password': account.get_password()
}
In this example, an account is randomly picked. Usually this is set according to rules specific for each client.
You have to restrict user access of your methods with suspend_security().
Warning: _init_data and _validate_data should be prefixed with your namespace! Choose python naming function compatible name.
Switching from prod to dev
You may adopt one of the following strategies:
store your dev accounts in production db using the dev key
import your dev accounts with Odoo builtin methods like a data.xml (in a dedicated module).
import your dev accounts with your own migration/cleanup script
etc.
Note: only the password field is unreadable without the proper key, login and data fields are available on all environments.
You may also use a same technical_name and different environment for choosing at runtime between accounts.
Usage (for user)
Go to settings / keychain, create a record with the following
Namespace: type of account (ie: Laposte)
Name: human readable label “Warehouse 1”
Technical Name: name used by a consumer module (like “warehouse_1”)
Login: login of the account
Password_clear: For entering the password in clear text (not stored unencrypted)
Password: password encrypted, unreadable without the key (in config)
Data: a JSON string for additionnal values (additionnal config for the account, like: {“agencyCode”: “Lyon”, “insuranceLevel”: “R1”})
Environment: usually prod or dev or blank (for all)
Known issues / Roadmap
Account inheritence is not supported out-of-the-box (like defining common settings for all environments)
Adapted to work with server_environnement modules
Key expiration or rotation should be done manually
Import passwords from data.xml
Security
This discussion: https://github.com/OCA/server-tools/pull/644 may help you decide if this module is suitable for your needs or not.
Common sense: Odoo is not a safe place for storing sensitive data. But sometimes you don’t have any other possibilities. This module is designed to store credentials of data like carrier account, smtp, api keys… but definitively not for credits cards number, medical records, etc.
By default, passwords are stored encrypted in the db using symetric encryption Fernet. The encryption key is stored in openerp.tools.config.
Threats even with this module installed:
unauthorized Odoo user want to access data: access is rejected by Odoo security rules
authorized Odoo user try to access data with rpc api: he gets the passwords encrypted, he can’t recover because the key and the decrypted password are not exposed through rpc
db is stolen: without the key it’s currently pretty hard to recover the passwords
Odoo is compromised (malicious module or vulnerability): hacker has access to python and can do what he wants with Odoo: passwords of the current env can be easily decrypted
server is compromised: idem
If your dev server is compromised, hacker can’t decrypt your prod passwords since you have different keys between dev and prod.
If you want something more secure: don’t store any sensitive data in Odoo, use an external system as a proxy, you can still use this module for storing all other data related to your accounts.
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 smashing it by providing a detailed and welcomed feedback.
Credits
Contributors
Raphaël Reverdy <raphael.reverdy@akretion.com>
Funders
The development of this module has been financially supported by:
Akretion
Maintainer
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
File details
Details for the file odoo10_addon_keychain-10.0.2.0.1.99.dev5-py2-none-any.whl
.
File metadata
- Download URL: odoo10_addon_keychain-10.0.2.0.1.99.dev5-py2-none-any.whl
- Upload date:
- Size: 115.7 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/30.4.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.5.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 38087fb78f5504a800c1b35893393d5e7a4f3dbf70e8b9a75f4f3db008f923f1 |
|
MD5 | f84df38405c5950557c52322a6f5ceb1 |
|
BLAKE2b-256 | 17e67c30203cf587be8182c46a0715d2d86c573ba84ca4d468457638dbc5ef9f |