odoo12-addon-dbfilter-from-header

==================== dbfilter_from_header

.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !! This file is generated by oca-gen-addon-readme !! !! changes will be overwritten. !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !! source digest: sha256:cf21310bbb21b57c17158da734fd24f4fe4f12edd6fc3989fe566688a411d9aa !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png :target: https://odoo-community.org/page/development-status :alt: Beta .. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html :alt: License: AGPL-3 .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fserver--tools-lightgray.png?logo=github :target: https://github.com/OCA/server-tools/tree/12.0/dbfilter_from_header :alt: OCA/server-tools .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png :target: https://translation.odoo-community.org/projects/server-tools-12-0/server-tools-12-0-dbfilter_from_header :alt: Translate me on Weblate .. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png :target: https://runboat.odoo-community.org/builds?repo=OCA/server-tools&target_branch=12.0 :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This addon lets you pass a dbfilter as a HTTP header.

This is interesting for setups where database names can't be mapped to proxied host names.

Table of contents

.. contents:: :local:

Installation

To install this module, you only need to add it to your addons, and load it as a server-wide module.

This can be done with the server_wide_modules parameter in /etc/odoo.conf or with the --load command-line parameter

server_wide_modules = "web, dbfilter_from_header"

Configuration

Please keep in mind that the standard odoo dbfilter configuration is still applied before looking at the regular expression in the header.

• For nginx, use:

  proxy_set_header X-Odoo-dbfilter [your filter regex];

• For caddy, use:

  proxy_header X-Odoo-dbfilter [your filter regex]

• For Apache, use:

  RequestHeader set X-Odoo-dbfilter [your filter regex]

And make sure that proxy mode is enabled in Odoo's configuration file:

proxy_mode = True

Your filter regex can contain dynamically injected hostname (%h) or the first subdomain (%d) through which the system is being accessed

Usage

To use this module, you need to complete installation and configuration parts.

Bug Tracker

Bugs are tracked on GitHub Issues <https://github.com/OCA/server-tools/issues>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback <https://github.com/OCA/server-tools/issues/new?body=module:%20dbfilter_from_header%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>.

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

Credits

Authors

* Therp BV

Contributors

• Stéphane Bidoul [e-mail]
• Yannick Vaucher [e-mail]
• Alexandre Fayolle [e-mail]
• Holger Brunn [e-mail]
• Laurent Mignon (aka lmi) [e-mail]
• Sandy Carter [e-mail]
• Fabio Vilchez [e-mail]
• Jos De Graeve [e-mail]
• Lai Tim Siu (Quaritle Limited) [e-mail]
• Lorenzo Battistini https://github.com/eLBati

Maintainers

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

This module is part of the `OCA/server-tools <https://github.com/OCA/server-tools/tree/12.0/dbfilter_from_header>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.