# Authentification

Toutes les requêtes vers l'API NSE doivent être authentifiées. NSE prend en charge deux méthodes d'authentification pour l'accès à l'API :

1. **Compte de service (Service Account)** — une identité machine, rattachée à une organisation, authentifiée via OAuth 2.0 Client Credentials et utilisée avec un jeton Bearer JWT. Destiné aux intégrations backend/serveur à serveur qui ne sont pas liées à un utilisateur humain spécifique.
2. **Jeton d'accès personnel (Personal Access Token, PAT)** — un jeton lié à un utilisateur individuel, envoyé via un en-tête dédié. Destiné aux scripts, aux intégrations rapides ou à l'automatisation effectuée au nom de cet utilisateur.


Il n'existe aucun type de jeton offrant un accès illimité, à l'échelle de l'organisation, à toutes les enveloppes, modèles et fichiers. Chaque requête — qu'elle soit authentifiée via un compte de service ou un PAT — est limitée aux permissions de l'identité associée au jeton (le compte de service ou l'utilisateur propriétaire, selon le cas).

## Méthode 1 : Compte de service (JWT via Client Credentials)

Un compte de service est une identité créée et gérée au sein d'une organisation, utilisée pour authentifier des intégrations backend sans connexion utilisateur.

### Créer un compte de service

1. Accédez à **Paramètres de l'organisation** → **Utilisateurs** → **Comptes de service**.
2. Cliquez sur **Créer un compte de service** et indiquez un **ID client** (doit être unique).
3. Lors de l'enregistrement, NSE provisionne le compte et renvoie un **Secret client**. Enregistrez-le immédiatement — comme un mot de passe, il ne peut plus être récupéré une fois la page quittée.


Les comptes de service sont rattachés à l'organisation dans laquelle ils ont été créés, et peuvent être consultés, gérés et supprimés depuis la même page **Comptes de service**.

### Obtenir un jeton

Utilisez le flux Client Credentials pour obtenir un jeton Bearer JWT.

## Méthode 2 : Jeton d'accès personnel (PAT)

Un jeton d'accès personnel authentifie les requêtes API **en tant qu'utilisateur individuel qui l'a créé** — il hérite de l'ensemble complet des permissions de cet utilisateur (pas de portées distinctes).

### Créer un PAT

1. Accédez à **Paramètres** → **Compte utilisateur** → **Jetons d'accès personnels**.
2. Cliquez sur **Nouveau jeton d'accès personnel**, indiquez un **Nom** et une **Date d'expiration** (les deux sont obligatoires).
3. Cliquez sur **Enregistrer**. La valeur complète du jeton n'est affichée **qu'une seule fois**, au format `nse_pat_<chaîne de 40 caractères>`. Copiez-la immédiatement — elle ne peut plus être récupérée après avoir quitté la page.


La liste affiche ensuite uniquement le nom, la date de création et la date d'expiration — jamais la valeur du jeton. Les jetons peuvent être supprimés à tout moment depuis la même page.

### Utiliser un PAT

Envoyez le PAT dans un en-tête dédié — et non dans `Authorization` :

```
Personal-Access-Token: nse_pat_<valeur>
```