Relier un projet Vercel à son dossier local.

Fonctionnement actuel

Pendant la bêta, Nivem vérifie le dossier local du projet. Lorsqu’il a été lié avec la CLI Vercel, le fichier .vercel/project.jsoncontient les identifiants techniques du projet et de son espace.

1. ouvre le dossier du projet dans Nivem ;
2. lie ce dossier depuis un terminal avec la commande vercel link si nécessaire ;
3. retourne dans Nivem et relance la détection ;
4. vérifie le projet proposé avant de confirmer l’association.

Parcours OAuth prévu

Le parcours cible permettra de connecter d’abord un compte Vercel dans Nivem, de choisir l’espace autorisé, puis de retrouver le projet qui correspond au dossier local. L’utilisateur validera chaque association.

Cette intégration est en cours de configuration et ne doit pas être considérée comme disponible tant que la bêta correspondante n’a pas été annoncée.

Permissions minimales prévues

Integration Configuration · Read

Identifier l’installation autorisée par l’utilisateur.

Projects · Read

Lister les projets et vérifier leur correspondance avec un dossier local.

Deployments · Read

Afficher l’état et l’historique utile des déploiements du projet lié.

Nivem ne demande pas d’accès en écriture aux projets, aux domaines, à la facturation, aux variables d’environnement ou aux drains dans ce parcours. Aucun webhook optionnel n’est requis pour la première version.

Données, secrets et révocation

Lorsque l’OAuth sera actif, les jetons seront destinés au stockage sécurisé du système et ne devront jamais apparaître dans la base métier, les logs ou les exports. Nivem conservera localement les identifiants du projet lié et les données de lecture utiles à l’interface.

La connexion pourra être retirée depuis Nivem et depuis les paramètres du compte Vercel. Après révocation, les données locales du projet restent sous le contrôle de l’utilisateur ; les rafraîchissements Vercel cessent.

Support

En cas de mauvaise association ou de connexion bloquée, consulte la page de support et indique le message d’erreur sans transmettre de jeton ni de fichier contenant un secret.