OdooWiki OCA HUB

Cross Connect Server

cross_connect_server folder_open OCA/server-auth open_in_new
Tools License: AGPL-3

This module allows other odoo instances, where the cross_connect_client module is installed and configured, users to connect directly on this odoo instance.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets other Odoo databases (running the Cross Connect Client module) connect to this database and log their users in automatically, without creating separate passwords. Administrators configure which clients and user groups are allowed.

This module turns an Odoo database into a "server" that other Odoo databases can connect to. It adds a new endpoint type called "Cross Connect Endpoint" on the FastAPI endpoint screen, where an administrator defines the allowed user groups, a secret key, and one or more cross connect clients.

Each client has a name, an automatically generated API key, and a list of user groups it may use. A counter shows how many users were created by that client. Administrators can also enter email patterns (regular expressions) so that certain users skip the automatic account creation and login step.

When a remote client asks for access, the module checks that the requested groups are allowed, creates or updates a matching user in this database, and returns a short-lived signed token. That token is then used to open a session and redirect the user to the Odoo web interface. Invalid or expired tokens are rejected.

Access is controlled by a new "Cross Connect Manager" group, which gets full rights on the client records. The endpoint form hides the HTTP session saving option for this endpoint type, and the secret key can be provided through server environment configuration.

Models and fields (3)
  • res.users · extends an existing modelcross_connect_client_id (Cross Connect Client), cross_connect_client_user_id (Cross Connect Client User ID)
  • fastapi.endpoint · extends an existing modelapp, cross_connect_client_ids (Cross Connect Clients), cross_connect_secret_key, cross_connect_allowed_group_ids (Cross Connect Allowed Groups)
  • cross.connect.client · new modelname, api_key (API Key), user_ids (Users), group_ids (Groups), user_count (Cross Connected User Count), endpoint_id (Endpoint), allowed_group_ids, bypass_user_mail_re (Bypass Users Email Regexes)

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/server-auth.

terminal Installation and usage

OCA documentation · Odoo 18.0

First of all after installing the module, you need to configure a fastapi endpoint.

In order to do that, you need to go to the menu FastAPI > FastAPI Endpoints and create a new endpoint for the client to connect to.

Fill the fields with the endpoint's information :

  • App: cross_connect
  • Cross Connect Allowed Groups: The groups that will be allowed to be selected for the clients groups.

Then for each client, you will have to add an entry in the Cross Connect Clients table.

An api key will be automatically generated for each client, this is the key that you will have to provide to the client in order for them to connect to the server. You will also have to choose the groups that this client will be able to give to its users.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.