Connecteur Sage 100

Dossiers et clés

Déclarer les dossiers Sage de votre client, activer l'écriture et créer des clés limitées aux bons droits.

3 min de lectureMis à jour le 30 septembre 2026

Toutes les commandes se lancent depuis le dossier du programme, dans un PowerShell administrateur :

cd "C:\Program Files\Maillon\Sage100"

Les changements de configuration sont pris en compte sans redémarrer le service.

Déclarer un dossier

Ajouter le dossier

.\maillon-sage100.exe dossier add --id BIJOU --server "SRV-SAGE\SAGE100" --database BIJOU --sql-user maillon_reader --sql-password "..." --label "Bijou SA"

--id : identifiant court du dossier, utilisé dans les clés et par l'assistant.
--server et --database : l'instance SQL et la base Sage.
--label : nom lisible, affiché à l'assistant.

Si le serveur utilise l'authentification Windows, remplacez --sql-user et --sql-password par --integrated.

Tester la connexion

.\maillon-sage100.exe dossier test --id BIJOU

La commande vérifie la connexion SQL puis liste les tables Sage attendues : chaque ligne doit indiquer OK.

Capture à venir

PowerShell : résultat de dossier test avec « SQL connection OK » puis la liste des tables Sage marquées OK.

public/docs/captures/sage-100-dossier-test.png

Un dossier prêt : connexion SQL validée et tables Sage trouvées.

Répétez l'opération pour chaque société du client. dossier list affiche les dossiers déclarés, dossier remove --id ID en retire un.

Activer l'écriture

Pour qu'un dossier accepte les écritures (tiers, documents, comptabilité, stock), indiquez le fichier de gestion commerciale, éventuellement le fichier comptable, et l'utilisateur Sage dédié :

.\maillon-sage100.exe dossier set-om --id BIJOU --om-gescom "C:\Sage\BIJOU.gcm" --om-compta "C:\Sage\BIJOU.mae" --om-user "MAILLON" --om-password "..."

dossier list indique alors SQL + Objets Metiers pour ce dossier.

Les droits Sage s'appliquent

Chaque dossier ouvre une session Sage dédiée avec cet utilisateur. Ses autorisations Sage limitent ce que les agents peuvent faire, en plus des droits de la clé : c'est une seconde barrière utile.

Créer une clé

Une clé donne accès à une liste de dossiers avec certains droits. Créez une clé par usage (un agent de relance, un assistant de consultation...) plutôt qu'une clé unique pour tout.

# Consultation seule, sur un dossier
.\maillon-sage100.exe key create --name "Assistant compta" --scopes read --dossiers BIJOU

# Lecture et documents commerciaux, sur deux dossiers
.\maillon-sage100.exe key create --name "Agent devis" --scopes read,documents --dossiers BIJOU,ACME

La clé commence par s100_ et n'est affichée qu'une seule fois : copiez-la immédiatement dans un gestionnaire de mots de passe.

Capture à venir

PowerShell : création d'une clé avec son identifiant, ses droits, ses dossiers et la valeur s100_ affichée une seule fois.

public/docs/captures/sage-100-key-create.png

La valeur de la clé n'est plus jamais réaffichée : seule son empreinte est conservée.

Les droits disponibles (read, write, documents, accounting, stock, delete, settings) sont détaillés dans la référence des outils.

Gérer les clés

.\maillon-sage100.exe key list                 # identifiant, préfixe, état, droits, dossiers
.\maillon-sage100.exe key revoke --id KEY_ID   # coupe l'accès immédiatement

Où sont stockées les informations ?

Élément	Stockage
Configuration	`C:\ProgramData\Maillon\Sage100\config.json`, lisible par les seuls administrateurs
Mots de passe SQL et Sage	Chiffrés par Windows (DPAPI, portée machine)
Clés	Empreinte SHA-256 uniquement
Journal d'audit des écritures	`audit\AAAA-MM.jsonl`, à côté de la configuration

Pour placer la configuration ailleurs, définissez la variable d'environnement MAILLON_SAGE100_CONFIG. maillon-sage100.exe config-path affiche le chemin utilisé.