OdooWiki OCA HUB

Cross Connect Client

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

This module allows this odoo instance users to connect directly on another odoo instance where the module cross_connect_server is installed.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets administrators register other Odoo servers and give selected user groups a menu shortcut that logs them straight into that remote server, without creating a local account there.

This module adds a new screen, Cross Connect Servers, under a Cross Connect menu in Odoo's settings area. Only system administrators can open it.

On each record the administrator enters a name, the remote server's web address and an API key. A Sync Cross Connection button then contacts that server and copies its user groups back into this database, where they appear as groups named after the server. A Disable button detaches those groups again, and deleting a server record also removes the groups it created.

Once groups are synced, a menu entry named after the server is created automatically and shown only to users who belong to at least one of those synced groups. Clicking it sends the user to the remote server, which recognises them by their login, name, email and language, and opens a session there. If the user is not in any of the server's groups, or has no email address, the connection is refused with an error message.

The API key can be kept out of the database by storing it in the server environment configuration, thanks to the server_environment dependency. The module touches the user groups model (res.groups) to store the link to the remote server and its group identifier, and enforces that a remote group identifier is unique per server.

Menus it adds

Cross ConnectCross Connect Servers
Models and fields (2)
  • res.groups · extends an existing modelcross_connect_server_id (Originating Cross Connect Server), cross_connect_server_group_id (Originating Cross Connect Server Group ID)
  • cross.connect.server · new modelname, api_key, menu_id (Menu), group_ids (Cross Connect Server Groups), server_url, web_icon_data

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 the server connection.

In order to do that, you need to go to the menu Settings > Technical > Cross Connect > Cross Connect Servers and create a new server to connect to.

Fill the fields with the server's information :

  • Url: The api root path (e.g. https://my-remote-odoo.com/api)
  • Api Key: The api-key from the cross_connect_server configuration

Then click on the Sync Cross Connection button to check if the connection is working and to sync the remote server's groups.

After that, you will have to affect the remote groups to the local users in order for them to be able to connect to the remote server.

Once an user has a remote group, a new top level menu will appear in the menu bar with the Cross Connect Server's name. Clicking on it will redirect the user to the remote server logged in as the user.

You can change each menu icon (for use with web_responsive for instance) by setting the Web Icon Data in the server configuration.

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.