Clés d'API
L’application Clés d’API va permettre de gérer les clés d’API Divalto dans le cadre d’une utilisation externe de la plateforme cloud.
Exemple : la clé “HubAPI” permet à divalto ERP dans un usage OnPremise ou SaaS de faire appel aux services de “HubApi” par une clé individuelle et sécurisée
Pour des raisons de sécurité, les clés gérées avec myDivalto sont affichées à l'écran afin de les copier/coller dans l’outil externe qui nécessite cette clé, mais ne sont pas conservées. Une fois la fenêtre fermée il n’est plus possible de trouver cette clé
Suivez notre TUTORIEL VIDEO Tutoriels - comment utiliser myDivalto | Tutoriel vidéo 3 exemple clé d’API ERP (5mn)
Attribution de droits sur les codes projets pour l’utilisateur
Chaque abonné entreprise, ERP ou CRM, a des codes projets SAAS associés.
On peut voir ces codes projets dans les onglets dédiés : Fiche abonné / onglet Applications / Divalto ERP ou Divalto CRM
En ERP HYBRIDE, l’application divalto ERP ne peut pas être activée (au niveau de la tirette) mais les paramètres sont tout de même accessibles
Chaque utilisateur doit avoir un droit d’accès à ces codes projets.
Pour cela, il faut activer au niveau de l’UTILISATEUR les codes projets, en passant par Fiche abonné / Utilisateurs / Choisir un utilisateur / Onglet Applications / Divalto ERP ou Divalto CRM
Activation ‘Clés d’API’ au niveau utilisateur
L’application au niveau de l’abonné est uniquement activée par Divalto. Vous pouvez vérifier dans l’onglet Applications de l’abonné, la présence de la ligne ‘Clés d’API’, mais c‘est l’activation au niveau de l’utilisateur qui est requis par un administrateur.
L’activation de Clés d’API se fait pour chaque utilisateur, dans l’onglet Applications sur la ligne ‘Clés d’API’ via le pictogramme de paramétrage. Son activation va rendre la tuile visible dans la page d’accueil de l’utilisateur (aucun paramétrage à ce niveau).
Générer une clé d'API
La génération est une opération unique, qui consiste à générer une clé, pour un couple type-code projet.
La génération de clé API se fait depuis la tuile ‘Clés d’API' du groupe ‘Administrer’ de la page d’accueil
Un liste des clés existantes est affichée.
Pour générer une clé de type X (comme c’est une opération unique), elle ne doit pas figurer dans cette liste
En cliquant sur ‘Générer une clé d’API' un écran permet d’indiquer des informations pour générer la clé, principalement le TYPE.
Si la liste des codes projets est vide ou incomplète, c’est que l’utilisateur n’a pas accès à ce code projet. Voir le chapitre précédent
Type | Usage |
|---|---|
DatabaseQuery | Clé de sécurisation interne à myDivalto pour l’utilisation du Requêteur SQL |
ErpGateway | Clé de sécurisation pour l’application ERP Gateway (pour les installation ERP OnPremise) |
ErpGatewayApi | Contrôle d’accès à l’API SAAS ErpGatewayApi (qui permet de communiquer avec le client ERP Gateway) |
HubApi | Contrôle d’accès à l’API SAAS HubApi (qui sert d’interface d’interconnexion de produits Divalto ou externes) |
Flexio | Contrôle d’accès dédié à Flexio pour ses flex app (nouveau avril 2026) |
Odata | Contrôle d’accès utilisé par Flexio (avant avril 2026) |
Une fois validé, un écran affiche la clé générée et permet de la copier/coller avec le bouton
Regénérer ou révoquer une clé existante
Regénérer consiste à remplacer la clé d’API par une nouvelle
Révoquer consiste à supprimer la clé d’API existante
Les deux actions (régénérer et révoquer) ont un effet immédiat sur la clé d’API stockée dans la plateforme cloud. Veillez à recopier rapidement la nouvelle clé dans votre application externe pour garantir la continuité de fonctionnement
La génération de clé API se fait depuis la tuile ‘Clés d’API' du groupe ‘Administrer’ de la page d’accueil
Un liste des clé existante est affichée, et doit comporter la clé à régénérer ou révoquer
Cliquez sur le bouton Regénérer ou Révoquer, et validez.
Une fois validé, un écran affiche la clé générée et permet de la copier/coller avec le bouton