Code/README_connexion.md
Fabrication du Numérique 91bb36fb8b Corrections mineures
2025-05-11 16:01:49 +02:00

46 lines
1.9 KiB
Markdown

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