SUPPORT

Un problème de certificat ? Besoin d'être dépanné rapidement ? Nos ingénieurs répondent à vos questions.

0 897 690 444 Service 0,80 €/min +prix appel
Menu
picture of tbs certificates
picture of tbs certificates
Les produits
Notre gamme
Partenaires
Support
Numéro vert
Focus


Installer un certificat pour l'utilisation de l'API ANAPLAN

Pour pouvoir utiliser l'API ANAPLAN, vous devez acquérir un certificat client avec l'attribut S/MIME comme le Sectigo S/MIME Mailbox-Validated.

Génération de la clé privée et du CSR

Il n'existe pas d'outil propre à ANAPLAN pour générer la clé privée et le CSR. Il faut donc utiliser un outil tiers, le plus connu étant OpenSSL. Vous avez également la possibilité d'utiliser notre outil en ligne Keybot :

Installation du certificat

Récupération du certificat au format PEM

ANAPLAN a besoin d'un certificat au format PEM. Pour récupérer ce certificat :

  • Rendez-vous sur la page statut du certificat (lien disponible dans le mail de livraison ou en vous connectant sur votre espace client).

  • Cliquez sur "Voir le certificat" pour faire apparaitre une popup et cliquez sur le lien "Voir le certificat au format X509 avec chaine".

  • Téléchargez le fichier dont le nom commence par "pem-XXXXXXXXXX-XXXXXX.pem".

  • Ouvrez le fichier .pem avec un éditeur de texte (Bloc-notes de Windows ou Notepad++). Dans ce fichier vous trouverez plusieurs "blocs" commençant par
    -------BEGIN CERTIFICATE-------
                 ...
                 ...
                 ...
     -------END CERTIFICATE-------

  • Conservez uniquement le premier bloc de ce fichier et supprimez tout le reste. Enregistrez le fichier avec un nouveau nom, par exemple "certificat.pem".

Import de votre certificat sur la plateforme Anaplan

Cette partie va servir à ce que votre certificat soit connu d'Anaplan, afin que vous soyez autorisé à utiliser l'API.

  • Connectez-vous sur l'interface d'administration d'Anaplan (anaplan.com) avec les droits administrateurs.

  • Dans le coin en haut à gauche, cliquez sur l'icone avec le trois traits horizontaux et naviguez vers Administration->Security->Certificates

  • Cliquez sur "Add certificates" et allez chercher le fichier sauvegardé precedemment ("certificat.pem")

Configuration du certificat pour Anaplan Connect v.1.4.X

La configuration se fait à l'aide d'un script : en .bat pour Windows, en .sh si vous etes sous Linux

Vous avez deux possibilités pour implémenter le certificat dans le fichier de configuration :

  • soit via un certificat et sa clé privée en deux fichiers distincts.
  • soit via un keystore JAVA

Ci-dessous, nous montrerons comment configurer le certificat et sa clé privée dans un script Windows.

Récupérez votre fichier précédemment sauvegardé, ainsi que la clé privée de votre certificat. Pour rappel, cette clé privée a été générée :

  • soit lors de la commande avec notre outil Keybot. Vous avez donc téléchargé un fichier avec comme extension .pkey protégé par un mot de passe.
  • soit avec OpenSSL. Votre fichier de clé privée peut avoir l'extension .key, .pkey ou .pem, protégé par un mot de passe ou non.

Définissez un chemin ou seront sauvegardés ces deux fichiers. C'est ce chemin qu'il faudra indiquer dans le script pour Anaplan Connect. Voici un exemple de script sur Windows qui permet de tester :

@echo off

set CertPath="C:\Anaplan_Connect\Certs\Public Certificate.pem"
set PrivateKey="C:\Anaplan_Connect\Certs\Private Key.pem:"

set WorkspaceId="workspaceGUID"
set ModelId="modelGUID"
set ServiceUrl="https://api.anaplan.com"
set AuthUrl="https://auth.anaplan.com"

set FileName="Employee.txt"
set FilePath="C:\Anaplan_Connect\Imports\Employee.txt"
set ImportName="New Hire from Employee.txt"
set DumpName="C:\Anaplan_Connect\Errors\My Errors.txt"
set Chunksize=15

set Operation=-debug -chunksize %Chunksize% -file %FileName% -put %FilePath% -import %ImportName% -execute -output %DumpName%

set Credentials=-certificate %CertPath% -pkey %PrivateKey%

rem *** End of settings - Do not edit below this line ***

setlocal enableextensions enabledelayedexpansion || exit /b 1
cd %~dp0

set Command=.\AnaplanClient.bat %Credentials% -service %ServiceUrl% -auth %AuthUrl% -workspace %WorkspaceId% -model %ModelId% %Operation%
@echo %Command%
cmd /c %Command%
pause

A NOTER : si votre clé privée est protégée par un mot de passe, vous avez deux possibilités :

  • vous souhaitez utiliser le mot de passe : sur la ligne "set PrivateKey...", il faut indiquer le mot de passe après le signe ":". Exemple :
    set PrivateKey="C:\Anaplan_Connect\Certs\Private Key.pem:motdepasse"
    Dans ce cas de figure, le mot de passe est en clair dans votre fichier de configuration
  • vous souhaitez ne pas utiliser le mot de passe : il faut donc déchiffrer votre clé privée, soit à l'aide d'OpenSSL (voir notre FAQ), soit à l'aide de notre outil en ligne : Déchiffrement de clé privée. Dans le script, sur la ligne "SetPrivateKey, indiquez le chemin ainsi que le nom de votre clé privée et terminez obligatoirement par le sign":" (voir l'exemple ci dessus).

Il ne vous reste plus qu'à sauvegarder votre script.

Liens utiles