Skip to main content
La CLI signe les requêtes avec une clé API d’espace de travail, le même identifiant que celui utilisé par l’API REST. Créez-en une dans le tableau de bord sous Settings → API & MCP. La clé complète n’est affichée qu’une seule fois.

​
Connexion

La CLI propose d’ouvrir la page des paramètres dans votre navigateur, puis vous demande la clé. La saisie reste masquée. Avant tout enregistrement, la clé est vérifiée auprès de l’API : une clé mal saisie ou révoquée n’est donc jamais enregistrée. Une fois la connexion réussie, vous voyez l’espace de travail, le nom de la clé et ses portées. La clé est enregistrée dans le trousseau de votre système : Si aucun trousseau n’est disponible, la CLI utilise un fichier accessible uniquement à son propriétaire dans ~/.config/famulor et vous l’indique.
La déconnexion supprime la clé de votre ordinateur uniquement. Pour invalider la clé elle-même, révoquez-la sous Settings → API & MCP.

​
CI et scripts

Dans les pipelines, définissez FAMULOR_API_KEY à partir de votre gestionnaire de secrets. Cette variable est prioritaire sur toute connexion enregistrée, et rien n’est écrit sur le disque :
Pour enregistrer une clé sans invite interactive et sans qu’elle apparaisse dans l’historique de votre shell, transmettez-la par un pipe :

​
Plusieurs espaces de travail

Une clé API appartient à un seul espace de travail. Enregistrez un profil pour chaque espace de travail et passez de l’un à l’autre :
FAMULOR_PROFILE sélectionne un profil pour toute une session de shell.

​
Domaines en marque blanche

Si vous utilisez Famulor sous votre propre domaine, connectez-vous une fois à ce domaine. Le profil le mémorise, et chaque commande l’utilise ensuite :
Les chemins de l’API, les clés et les portées sont les mêmes sur tous les domaines.

​
Vérifier votre configuration

famulor doctor vérifie en une seule fois votre version de Node.js, la connexion enregistrée, l’hôte, la connexion réseau et API Access, et vous indique ce qu’il faut corriger :