Configurer la connexion à l'API SIRENE

L'interface avec l'API SIRENE permet de remplir automatiquement les informations d'un prospect, d'un client ou d'un fournisseur grâce au numéro de SIRET ou de SIREN. Si le numéro de SIRET ou de SIREN renseigné est reconnu par l'API SIRENE, alors les champs concernés (comme le nom d'appel ou l'adresse) seront renseignés automatiquement.

L’environnement d’exécution Java (JRE) dispose d’un fichier de configuration (keystore) qui comprend les certificats racines des différentes autorités de certification reconnues. Lorsqu’une connexion est établie vers un autre système en https, cette liste de certificats permet de valider la connexion sécurisée.

Certaines autorités de certification ne sont pas présentes dans le fichier fourni par défaut avec le JRE et il est donc nécessaire de les ajouter manuellement. Dans le cas de l'API SIRENE, il vous faut ajouter le certificat Certigna pour certifier les connexions.

Note

Pour les clients SaaS, l'ajout du certificat est effectué par Akuiteo.

Identifier l'emplacement du JRE Java

1 Connectez-vous au serveur qui héberge l'environnement Akuiteo.
2 Lancez le Manager Tomcat de l'environnement ciblé.
3 Depuis l'onglet Java, notez l'emplacement du JRE utilisé par Tomcat.

Récupérer le certificat Racine de Certigna

1 Rendez-vous sur le site de Certigna : https://www.certigna.com/autorite-crl.
2 Téléchargez le certificat d'autorité Certigna Racine : certigna.der.

Importer le certificat dans le keystore du JRE Java

1 Lancez l'invite de commande en mode administrateur.
2 Lancez la commande suivante :

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

Dans cette commande, vous devez remplacer :

  • [EMPLACEMENT_JRE] par l'emplacement du JRE Java utilisé par Tomcat
  • [EMPLACEMENT_CERTIFICAT] par l'emplacement du certificat certigna.der téléchargé.

Exemple

"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 Redémarrez le serveur Tomcat de l'environnement Akuiteo ciblé pour prendre en compte l'ajout du certificat.

La connexion à l'API SIRENE est configurée dans la Console d'administration, depuis le menu Interfaces tierces > API Sirene.

1 Renseignez les champs suivants pour configurer la connexion :
Champ Description
Utilisation de l'API SIRENE Cochez la case pour utiliser l'API SIRENE.
Jeton pour l'API SIRENE

Renseignez le jeton généré depuis le site https://portail-api.insee.fr/.

Pour récupérer manuellement le jeton :

  1. En tant qu'administrateur, créez un compte sur le site portail-api.insee.fr.
  2. Activez l'API Sirene pour l'application (Akuiteo).
  3. Générez un jeton pour cette application.

Référence

Pour plus d'informations sur le nouveau portail et la génération du jeton, voir la documentation officielle sur la connexion à l'API SIRENE.
2 Cliquez sur Enregistrer pour chaque champ renseigné ou modifié afin de prendre en compte la valeur renseignée.
3 Cliquez sur le bouton Tester pour tester la connexion à l'API SIRENE à partir des valeurs renseignées.