Prerequisite
Open Bee™ Portal
Open Bee™ Portal version 6.7.2 or higher (the latest version is recommended).
Open Bee™ Portal license
The Open Bee™ Portal license must include the Open Bee™ Portal module: Chorus Pro Connector.
Open Bee™ Portal: Chorus Pro Connector from version 6.8.3 is paid and must be included in the Open Bee™ Portal license
Creating a technical account via the Chorus Pro portal
The technical user allows the connection to the Chorus Pro system in PLC mode.
Please follow the steps in the attached guide to create these technical credentials: Chorus Technical Account Creation / Track Technical Account Creation.
If you have several establishments, you must create a technical account for each establishment. Icon
The creation of a technical account on the Chorus Pro portal requires a connection with a user with a “Main Manager” attachment on your structure.
A technical account is represented in this form: TECH_xnuméro_SIRET@cpp2017.fr
Creating an account on PISTE
For On Premise and Cloud installations planned after January 16, 2020, the authentication method with the Chorus Pro APIs has changed, you must create an account on PISTE.
https://piste.gouv.fr/
Here is the link to the PISTE documentation:
https://piste.gouv.fr/help-center/guide
The different stages are as follows:
- Account creation. Page 7
- Create an application in production with the subscription to the Chorus Pro APIs. Page 14 Icon Please select all Chorus Pro APIs. This is important for the proper functioning of the module.
- Retrieve OAuth IDs, Client ID, and Secret.
Icon
The 3 pieces of information to keep from the PISTE portal are as follows:
– Le nom de l’application. Il sera utilisé pour la demande de raccordement sur le portail Chorus Pro.
– Le client ID (identifiants Oauth). Utilisé dans la configuration du module Open Bee™ Portal : Connecteur Chorus Pro.
– Le secret (identifiants Oauth). Utilsé dans la configuration du module Open Bee™ Portal : Connecteur Chorus Pro.
Applying for a connection
A connection request must be made to Chorus Pro. If you have several establishments, only one connection request is necessary.
It is not necessary to validate a connection to the Chorus Pro qualification environment, you can work directly on the Chorus Pro production environment.
Open port 5443 (not required for a cloud installation)
The port used by Chorus Pro is 5443.
Check that this port is open at your firewall.
To check if this port is open on the client’s network, you can use PowerShell on Windows and this command:
Test-NetConnection -Port 5443 -ComputerName chorus-pro.gouv.fr -InformationLevel Detailed
You have to look at the TcpTestSucceeded result. If it is set to False, there is a network problem.
If successful:
If this command doesn’t work because it’s not known to PowerShell (for example, on Windows Server 2012), you can use this command:
telnet chorus-pro.gouv.fr 5443
If it works, you should see a _.