Cet article s'adresse au client Skello ou Ă son comptable qui a Ă©tĂ© dĂ©signĂ© Ă lâEtape 2 : Choisir la personne en charge de la connexion comme la personne en charge de connecter Skello Ă Silae.
Cet article dĂ©taille comment procĂ©der Ă lâEtape 4 : RĂ©cupĂ©rer les 3 clĂ©s de connexion de Silae nĂ©cessaires Ă la connexion de Skello Ă Silae.
Voici les 3 clés de connexion que vous allez devoir récupérer et copier précieusement sur votre ordinateur ou presse papier :
Le Client ID
Le Client Secret
La Clé Principale
â ïž Important : avant dâaller plus loin, vous devez impĂ©rativement avoir :
Créé votre compte sur le portail API de Silae (Etape 1 - Comment créer son compte API sur Silae ? ).
effectué les pré-requis indispensables (Etape 3 - Les pré-requis indispensables)
Pour plus dâinformation sur les 5 Ă©tapes de connexion, veuillez vous rĂ©fĂ©rer au guide complet de connexion Comment connecter Skello au logiciel Silae ?
A - Se connecter au portail API Silae
Une fois votre compte crĂ©Ă© sur le portail API, veuillez accĂ©der Ă la page dâaccueil du portail API en cliquant sur ce lien : https://api-portal.silae.fr et en rentrant les identifiants dĂ©finis Ă lâĂ©tape 1 - CrĂ©ation dâun compte API Silae. (Comment crĂ©er son compte API sur Silae ? )
Dans âMes comptes APIâ, vous trouverez les deux comptes crĂ©Ă©s par dĂ©faut par Silae :
le compte de production
le compte de Test : le nom du compte commencera par 'TEST' (cet environnement est fictif et sert uniquement Ă tester la connexion; les Ă©tapes suivantes sont identiques pour le compte test et le compte de production)
B - Activer le compte API
Cliquez sur âMes comptes APIâ dans votre portail API Silae
Cliquez sur les 3 points rouges au bout de ligne de votre compte de production
Cliquez sur Modifier
Dans lâonglet Informations GĂ©nĂ©rales, activez le compte en cliquant sur le bouton âActiver le compteâ
C - RĂ©cupĂ©rer le âClient IDâ
Toujours dans lâonglet Informations GĂ©nĂ©rales, copiez-collez le Client ID et gardez le prĂ©cieusement. Câest la premiĂšre de vos 3 clĂ©s de connexion quâil faudra communiquer Ă Skello (soit dans Skello directement si vous ĂȘtes un client Skello, soit dans le formulaire reçu par email si vous ĂȘtes son comptable et que vous nâavez pas accĂšs Ă Skello).
D - RĂ©cupĂ©rer le âClientSecretâ
Dans l'onglet 'Gestion des ClientsSecrets',
Cliquez sur 'Régénérer',
Une fenĂȘtre sâouvre comme ci-dessous :
Copiez le ClientSecret, et conservez-le aussi trĂšs prĂ©cieusement. Câest la deuxiĂšme clĂ© de connexion quâil faudra communiquer Ă Skello.
Attention, pour des questions de sĂ©curitĂ©, une fois la fenĂȘtre fermĂ©e, le ClientSecret ne pourra plus ĂȘtre affichĂ©. Pensez bien Ă enregistrer ce ClientSecret.
(NB : Si vous utilisez ce ClientSecret pour dâautres connections API avec dâautres logiciels, il devra ĂȘtre aussi modifiĂ© sur vos autres logiciels).
E. Configurer lâaccĂšs API (par le partenaire Silae)
Pour définir une configuration API, vous avez besoin de :
Un compte API REST
Un utilisateur Silae (contact existant ou fictif) qui doit avoir les droits nécessaires pour exécuter les fonctions API REST.
L'opération s'effectue depuis l'environnement de production de Silae.
Accédez à l'environnement de production de Silae
Dans lâonglet ParamĂ©trage Paie, utilisez la fonction API :
â
SĂ©lectionnez le compte API de production qui vient d'ĂȘtre activĂ©.
DĂ©signez lâutilisateur Silae avec les droits d'accĂšs nĂ©cessaires pour l'usage des fonctions API. VĂ©rifiez quâil est bien autorisĂ© Ă accĂ©der Ă la fonction Configuration dâAPI comme ci-dessous :
â
Vous nâavez pas encore dâutilisateur Silae ? Vous pouvez en crĂ©er un fictif. Voici comment faire :
Dans l'onglet 'Admin.collaborateurs', cliquez sur 'Créer un collaborateur',
Renseignez son adresse e-mail fictive, par exemple api-skello@votrenomdedomaine.com
SĂ©lectionnez ce collaborateur dans la liste en le cochant,
Cliquez sur 'Droits',
Puis cliquez sur 'AccĂšs Ă la gestion des droits' et cochez 'Production', 'Gestion interne' et 'Analyse de production'.
Enfin, Cliquez sur 'Valider et fermer'.
retournez dans Paramétrage Paie > bouton API
Cliquez sur 'Créer une configuration'
Dans le champ 'Compte API', sélectionnez le compte API du client Skello (NOM DE LA SOCIETE - NOM DU CLIENT),
Dans le champ 'Utilisateur Silae', sélectionnez l'utilisateur précédemment créé
Cochez 'AccÚs à un ou plusieurs dossiers' et ajoutez uniquement les dossiers de paie du client concerné.
Copiez et sauvegardez lâID unique de configuration d'accĂšs API : il permet d'identifier la clĂ© dâaccĂšs API. Cet identifiant peut ĂȘtre copiĂ© dans le presse-papier (clic droit).
Pour chaque Ă©tablissement, vous aurez un unique ID de configuration dâaccĂšs API.
F. Récupérer la clé principale
L'opĂ©ration s'effectue depuis Mes Comptes API de la page d'accueil du portail API accessible Ă lâadresse suivante : https://api-portal.silae.fr
Cliquez à nouveau sur les 3 points situés à droite du compte API de test désigné
GrĂące Ă l'ID unique de configuration API fourni par votre gestionnaire de paie, identifiez le compte Ă activer et cliquez sur les 'trois points' au bout de la ligne et cliquez sur 'Modifier',
SĂ©lectionnez la fonction Modifier
Accédez à l'onglet Configuration d'accÚs API
Cliquez sur les 3 points situés à droite du compte API de test désigné puis:
Activez la configuration d'accĂšs API
Régénérez la clé principale ou secondaire (aussi appelée SubscriptionKey - Pas de différence entre la clé principale et secondaire).
Une fenĂȘtre sâouvre avec la ClĂ© Principale. Copiez-lĂ et gardez-lĂ prĂ©cieusement. Câest la troisiĂšme clĂ© de connexion quâil faudra communiquer Ă Skello.
Attention, pour des questions de sĂ©curitĂ©, une fois la fenĂȘtre fermĂ©e, la ClĂ© Principale ne pourra plus ĂȘtre affichĂ©e. Pensez bien Ă enregistrer cette ClĂ© Principale.
Et voilĂ , vous avez rĂ©cupĂ©rĂ© les 3 clĂ©s nĂ©cessaires Ă Ă©tablir la connexion entre Skello et Silae. Ne les rentrez pas dans Skello pour le moment. Veuillez retourner sur le đComment connecter Skello au logiciel Silae ? pour passer Ă lâĂ©tape 5.