# Authentification à FabNum avec un token Gitea

Ce document explique comment générer et utiliser un token d'accès personnel Gitea pour vous connecter à l'application FabNum.

## Caractéristiques du token requis

Pour pouvoir vous connecter à FabNum, votre token Gitea doit répondre aux critères suivants :

- Être associé à un compte utilisateur qui est membre de l'équipe **"Administrateurs"** dans l'organisation **"FabNum"**
- Disposer des permissions suffisantes pour :
  - Accéder aux informations de l'utilisateur
  - Lister les équipes d'une organisation
  - Vérifier l'appartenance d'un utilisateur à une équipe

## Procédure pour générer un nouveau token

1. **Connectez-vous à Gitea** :
   - Rendez-vous sur https://fabnum-git.peccini.fr et connectez-vous avec vos identifiants

2. **Accédez aux paramètres de votre profil** :
   - Cliquez sur votre avatar en haut à droite
   - Sélectionnez "Paramètres"

3. **Générez un nouveau token d'accès** :
   - Dans le menu latéral gauche, cliquez sur "Applications"
   - Faites défiler jusqu'à la section "Tokens d'accès personnel"
   - Cliquez sur "Générer un nouveau token"

4. **Configurez le token** :
   - Donnez un nom descriptif à votre token (par exemple "Token FabNum - Connexion")
   - **Important** : Sélectionnez les autorisations suivantes au minimum :
     - `read:user` - Accès en lecture pour les informations utilisateur
     - `read:org` - Accès en lecture pour les organisations et équipes

5. **Générez et copiez le token** :
   - Cliquez sur "Générer un token"
   - **IMPORTANT** : Copiez immédiatement le token généré et conservez-le en lieu sûr. Gitea ne l'affichera plus jamais après cette étape.

## Utilisation du token

Une fois le token généré, utilisez-le pour vous connecter à l'application FabNum :

1. Accédez à l'application FabNum
2. Dans le formulaire d'authentification, collez votre token d'accès personnel Gitea
3. Cliquez sur "Se connecter"