Clés d'API

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(via Hybride) 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

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 de l'ABONNE : Fiche abonné / onglet Projets

A noter : un indicateur ‘Production’ permet d’identifier des codes projes qui contiennent des données de production

image-20260626-141026.png

Chaque utilisateur doit avoir un droit d’accès à ses codes projets.

Pour cela, il faut activer au niveau de l’UTILISATEUR les codes projets, en passant par Fiche abonné / Utilisateurs puis l’onglet Projets

image-20260626-140900.png

 

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 Projets via la tirette. Son activation va rendre la tuile visible dans la page d’accueil de l’utilisateur (aucun paramétrage à ce niveau).

image-20260702-153935.png

 

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

image-20251029-164055.png

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

image-20251029-164533.png

 

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

image-20260109-160053.png

 

Type

Usage

Type

Usage

Database Query 

Clé de sécurisation interne à myDivalto pour l’utilisation du Requêteur SQL

Erp Gateway 

Clé de sécurisation pour l’application ERP Gateway (pour les installation ERP OnPremise)

Erp Gateway Api 

Contrôle d’accès à l’API SAAS ErpGatewayApi (qui permet de communiquer avec le client ERP Gateway)

Hub Api 

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)

MCP divalto-ia-devkit

Kit de développement IA MCP (Model Context Protocol) (nouveau mai 2026)

La clé HubApi est INDISPENSABLE dans le cadre de la facturation électronique. La clé obtenue dans myDivalto doit être mise dans l’ERP (emplacement variable selon la version)

Une fois validé, un écran affiche la clé générée et permet de la copier/coller avec le bouton

image-20251029-164749.png

 

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

image-20251029-164055.png

Un liste des clé existante est affichée, et doit comporter la clé à régénérer ou révoquer

image-20251029-165301.png

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

image-20251029-164749.png