# Clés API

Ouvrir un accès machine, révocable sans rien casser d'autre.

## À quoi sert une clé

Elle permet à un script, à la ligne de commande ou à un assistant IA de parler à Naoshift sans session de navigateur : envoyer un export, lire vos données, générer un rapport. Vos collecteurs ont leurs propres identifiants : rien à faire ici pour eux.

Pour la ligne de commande sur votre propre poste, passez plutôt par **Paramètres › Mon compte › Clés API et CLI** : le poste y est enrôlé avec vos droits.

## Les étapes

1. Ouvrez **Paramètres › Organisation › Utilisateurs et rôles**, puis **Inviter et gérer**.
2. Passez sur l'onglet **Comptes de service**.
3. Cliquez sur **+ Nouvelle clé**, nommez-la d'après ce qui va s'en servir, et choisissez son expiration : 30, 90 ou 365 jours. Une clé expire toujours.
4. Cochez ses **Portées**. Sans rien cocher, elle ne peut que lire : un droit d'écriture ne se donne jamais implicitement.
5. Cliquez sur **Générer**.
6. **Copiez la clé tout de suite** : elle ne sera plus jamais affichée. Rangez-la dans votre coffre à secrets.

> Naoshift ne garde que l'empreinte de la clé : personne ne peut vous la remontrer, et nous non plus.

## Une clé par usage

Quand un script et un assistant partagent une clé, impossible de lire sa colonne **Dernier accès** utilement, ni de révoquer l'un sans casser l'autre. Une clé agit dans votre société : traitez-la comme un mot de passe.

Avant de révoquer, regardez **Dernier accès** : une clé utilisée il y a une heure est sans doute encore branchée quelque part. La révocation est immédiate et définitive.

### J'ai perdu la clé

Elle n'est pas récupérable. Créez-en une autre, remplacez-la chez ce qui s'en sert, puis révoquez l'ancienne.

### Quelqu'un s'en va

Ses clés ne s'arrêtent pas avec son compte : passez en revue cet onglet, et révoquez celles qu'il a créées.

### Mon appel est refusé

Vérifiez l'expiration de la clé et la société dans laquelle elle a été créée : une clé ne lit que cette société.
