> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connexion et espaces de travail

> Clés API, trousseau du système, identifiants pour la CI, un profil par espace de travail et domaines en marque blanche

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

```bash theme={null}
famulor auth login
```

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 :

| Système | Emplacement de la clé |
| - | - |
| macOS | Trousseau |
| Windows | Gestionnaire d'identification |
| Linux | Secret Service (par exemple GNOME Keyring ou KWallet) |

Si aucun trousseau n'est disponible, la CLI utilise un fichier accessible uniquement à son propriétaire dans `~/.config/famulor` et vous l'indique.

```bash theme={null}
famulor auth whoami     # espace de travail, nom de la clé et portées de la connexion
famulor auth status     # toutes les connexions enregistrées, et si la connexion active fonctionne encore
famulor auth logout     # supprimer la clé enregistrée de cet ordinateur
```

<Note>
  La déconnexion supprime la clé de votre ordinateur uniquement. Pour invalider la clé elle-même, révoquez-la sous **Settings → API & MCP**.
</Note>

## 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 :

```bash theme={null}
export FAMULOR_API_KEY="fam_..."
famulor list-calls --status completed --limit 50
```

Pour enregistrer une clé sans invite interactive et sans qu'elle apparaisse dans l'historique de votre shell, transmettez-la par un pipe :

```bash theme={null}
printf '%s' "$FAMULOR_API_KEY" | famulor auth login --with-token
```

## 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 :

```bash theme={null}
famulor auth login --profile agency     # connecter un deuxième espace de travail
famulor auth switch agency              # en faire le profil par défaut
famulor list-assistants --profile default   # utiliser un autre profil ponctuellement
```

`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 :

```bash theme={null}
famulor auth login --base-url app.example.com
```

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 :

```bash theme={null}
famulor doctor
```