1- .. image :: https://img.shields.io/badge/license-AGPL--3-blue.png
2- :target: https://www.gnu.org/licenses/agpl
3- :alt: License: AGPL-3
4-
5- ======================
6- Auth Oauth Environment
7- ======================
8-
9- This module extends the functionality of server environment to support OAuth
10- providers, and allows you to enable providers and set client_id key according
11- to environment. (Refer to module server_environment for more informations)
1+ ================================================
2+ Auth oauth configuration with server_environment
3+ ================================================
4+
5+ ..
6+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
7+ !! This file is generated by oca-gen-addon-readme !!
8+ !! changes will be overwritten. !!
9+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
10+ !! source digest: sha256:b787e16c08c7d8d3b53118cafeba8c96756be4e4b2a8405d57a351b746ea021e
11+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
12+
13+ .. |badge1 | image :: https://img.shields.io/badge/maturity-Beta-yellow.png
14+ :target: https://odoo-community.org/page/development-status
15+ :alt: Beta
16+ .. |badge2 | image :: https://img.shields.io/badge/licence-AGPL--3-blue.png
17+ :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
18+ :alt: License: AGPL-3
19+ .. |badge3 | image :: https://img.shields.io/badge/github-OCA%2Fserver--env-lightgray.png?logo=github
20+ :target: https://github.com/OCA/server-env/tree/17.0/auth_oauth_environment
21+ :alt: OCA/server-env
22+ .. |badge4 | image :: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
23+ :target: https://translation.odoo-community.org/projects/server-env-17-0/server-env-17-0-auth_oauth_environment
24+ :alt: Translate me on Weblate
25+ .. |badge5 | image :: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
26+ :target: https://runboat.odoo-community.org/builds?repo=OCA/server-env&target_branch=17.0
27+ :alt: Try me on Runboat
28+
29+ |badge1 | |badge2 | |badge3 | |badge4 | |badge5 |
30+
31+ This module extends the functionality of server environment to support
32+ OAuth providers, and allows you to enable providers and set client_id
33+ key according to environment. (Refer to module server_environment for
34+ more informations)
35+
36+ **Table of contents **
37+
38+ .. contents ::
39+ :local:
1240
1341Installation
1442============
@@ -20,83 +48,82 @@ Configuration
2048=============
2149
2250To configure this module, you need to add a section
23- ``[auth_oauth.provider_simple_name ] `` to you server_environment_files
24- configurations, where 'provider_simple_name ' match the simplified name field on
51+ ``[auth_oauth.provider_name ] `` to you server_environment_files
52+ configurations, where 'provider_name ' match the tech_name field on
2553auth.oauth.provider.
2654
27- 'provider_simple_name ' is the first part (until first space character) in
28- lower case of provider name. Using existing providers, it could be either
29- ``google ``, ``odoo.com ``, or ``facebook ``.
55+ 'provider_name ' is the first part (until first space character) in lower
56+ case of provider name. Using existing providers, it could be either
57+ ``provider_google ``, ``provider_openerp ``, or ``provider_facebook ``.
3058
3159For example, if you want to activate Google and Odoo.com, your
32- server_environment_files should look like this : :
60+ server_environment_files should look like this:
3361
34- [auth_oauth.google]
35- enabled=True
36- client_id=123456789101-abcdefghijklmnopqrstuvwxyz000000
62+ ::
3763
38- [auth_oauth.odoo.com]
39- enabled=True
64+ [auth_oauth.provider_google]
65+ client_id=123456789101-abcdefghijklmnopqrstuvwxyz000000
66+ enabled=True
4067
68+ [auth_oauth.provider_openerp]
69+ enabled=True
4170
42- Any provider not being enabled through server_environment_files will be set as
43- disabled automatically.
44-
45- If you want to define a new custom provider, you should pay attention to the
46- name to use in the server_environment_files. If you create a provider with
47- 'Dummy auth provider' as its name, then the section should be named
48- ``[auth_oauth.dummy] ``.
71+ Any provider not being enabled through server_environment_files will be
72+ set as disabled automatically.
4973
74+ If you want to define a new custom provider, you should pay attention to
75+ the tech name to use in the server_environment_files. If you create a
76+ provider with 'provider_dummy' as its tech_name, then the section should
77+ be named ``[auth_oauth.provider_dummy] ``.
5078
5179Usage
5280=====
5381
54- Once configured, Odoo will read from server_environment_files the following
55- fields of auth.oauth.provider :
56-
57- * Allowed (``enabled ``)
58- * Client ID (``client_id ``)
82+ Once configured, Odoo will read from server_environment_files the
83+ following fields of auth.oauth.provider :
5984
60-
61- Known issues / Roadmap
62- ======================
63-
64- * Due to the specific nature of this module, it cannot be tested on OCA runbot.
85+ - Allowed (``enabled ``)
86+ - Client ID (``client_id ``)
6587
6688Bug Tracker
6789===========
6890
69- Bugs are tracked on `GitHub Issues
70- <https://github.com/OCA/server-env/issues> `_. In case of trouble, please
71- check there if your issue has already been reported. If you spotted it first,
72- help us smash it by providing detailed and welcomed feedback.
91+ Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-env/issues >`_.
92+ In case of trouble, please check there if your issue has already been reported.
93+ If you spotted it first, help us to smash it by providing a detailed and welcomed
94+ `feedback <https://github.com/OCA/server-env/issues/new?body=module:%20auth_oauth_environment%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior** >`_.
95+
96+ Do not contact contributors directly about support or help with technical issues.
7397
7498Credits
7599=======
76100
77- Images
78- ------
101+ Authors
102+ -------
79103
80- * Odoo Community Association: ` Icon < https://odoo-community.org/logo.png >`_.
104+ * Camptocamp SA
81105
82106Contributors
83107------------
84108
85- * Akim Juillerat <akim.juillerat@ camptocamp.com>
109+ - ` Camptocamp < https://www. camptocamp.com >`__
86110
87- Do not contact contributors directly about support or help with technical issues.
111+ - Akim Juillerat akim.juillerat@camptocamp.com
112+ - Vincent Van Rossem vincent.vanrossem@camptocamp.com>
88113
89- Maintainer
90- ----------
114+ Maintainers
115+ -----------
116+
117+ This module is maintained by the OCA.
91118
92119.. image :: https://odoo-community.org/logo.png
93120 :alt: Odoo Community Association
94121 :target: https://odoo-community.org
95122
96- This module is maintained by the OCA.
97-
98123OCA, or the Odoo Community Association, is a nonprofit organization whose
99124mission is to support the collaborative development of Odoo features and
100125promote its widespread use.
101126
102- To contribute to this module, please visit https://odoo-community.org.
127+ This module is part of the `OCA/server-env <https://github.com/OCA/server-env/tree/17.0/auth_oauth_environment >`_ project on GitHub.
128+
129+ You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
0 commit comments