Configuring the SIRENE API

The SIRENE API is used to automatically fill in information when creating a prospect, a customer or a supplier thanks to the specified SIRET or SIREN number. If the SIRET or SIREN number specified is known by the SIRENE API, the relevant fields (such as the call name or the address) will be filled in automatically.

The Java Runtime Environment (JRE) has a configuration file (keystore) that includes root certificates from the different renowned certification authorities. When a connection is established to another system using https, this list of certificates is used to validate the secured connection.

Some certification authorities are not included in the file provided by default with the JRE, so they must be added manually. In the SIRENE API's context, you must add the Certigna certificate to certify connections.

Note

For SaaS customers, this certificate is added by Akuiteo.

Identifying the JRE's location

1 Connect to the server that hosts the Akuiteo environment.
2 Launch the Tomcat Manager for that environment.
3 From the Java tab, take note of the location of the JRE used by Tomcat.

Retrieving the Certigna's Racine certificate

1 Go to the Certigna's website: https://www.certigna.com/autorite-crl.
2 Download the Certigna's authority certificate: certigna.der.

Importing the certificate into the JRE's keystore

1 Launch the command prompt as an administrator.
2 Launch the following command:

"[JRE_LOCATION]\bin\keytool.exe" -import -alias "certigna" -keystore "[JRE_LOCATION]\lib\security\cacerts" -trustcacerts -file "[CERTIFICATE_LOCATION]\certigna.der" -storepass changeit

In this command, you must replace:

  • [JRE_LOCATION] with the location of the JRE used by Tomcat
  • [CERTIFICATE_LOCATION] with the location of the certigna.der certificate downloaded.

Example

"C:\Program Files\Java\jdk1.8.0_22\jre\bin\keytool.exe" -import -alias "certigna" -keystore "C:\Program Files\Java\jdk1.8.0_22\jre\lib\security\cacerts" -trustcacerts -file "C:\Users\XXX\Documents\certigna.der" -storepass changeit

3 Restart the Tomcat server of the targeted Akuiteo environment to take into account the new certificate.

The connection to the SIRENE API is configured from the Administration console, from the Third-party interfaces > Sirene API menu.

1 Fill in the following fields to configure the connection:
Field Description
SIRENE API use Check the box to use the SIRENE API.
Token for SIRENE API

Specify the token generated from https://portail-api.insee.fr/.

To manually retrieve that token:

  1. As an administrator, create an account on portail-api.insee.fr.
  2. Enable the Sirene API for the application (Akuiteo).
  3. Generate a token for that application.

Reference

For more information about the new portal and the generation of the token, refer to the official documentation about connecting to the SIRENE API.
2 Click on Save for each field that is filled in or modified to take into account the value specified.
3 Click on the Test button to test the connection to the SIRENE API using the values specified.