Avant de commencer
Vous avez besoin du rôle Owner ou Admin dans Enclave. Dans Azure DevOps, le compte avec lequel vous vous connectez doit disposer de Project Administrator sur les projets à analyser, ou de l’autorisation Edit Subscription. Enclave s’en sert pour créer les service hooks qui envoient les événements de push. Sans cela, Enclave peut lire votre code mais ne voit pas les nouveaux commits.Connecter Azure DevOps
1
Ouvrez les intégrations
Ouvrez Settings → Integrations dans app.enclave.ai. Cliquez sur Connect à côté de Azure DevOps.
2
Choisissez votre mode de connexion
Choisissez l’option qui correspond à votre façon de vous connecter à Azure DevOps.
- Microsoft Entra ID
- Jeton d'accès personnel
Utilisez cette option pour un compte professionnel ou scolaire.
- Cliquez sur Microsoft Entra ID et connectez-vous avec Microsoft.
- Sous Choose organizations to connect, sélectionnez les organisations Azure DevOps qu’Enclave doit lire.
- Cliquez sur Connect.
3
Vérifiez la connexion
De retour dans Settings → Integrations → Azure DevOps, l’organisation apparaît sous Organizations avec son nombre de dépôts.
Autorisations
Enclave utilise la connexion pour :- Lire les dépôts, les branches et les pull requests. Enclave lit votre code et son historique.
- Créer et supprimer des abonnements aux service hooks. Enclave s’abonne aux événements de push et de pull request pour savoir quand le code change.
- Créer et mettre à jour des work items Azure Boards pour les findings. Cela nécessite l’autorisation Work Items (read & write). La connexion d’Azure DevOps connecte aussi Azure Boards. Aucune configuration distincte n’est nécessaire.
Gérer la connexion
Ouvrez Settings → Integrations → Azure DevOps pour voir vos organisations connectées.- Resync récupère les projets et dépôts créés après votre connexion. Azure DevOps ne prévient pas Enclave de leur création : cliquez donc sur Resync après en avoir ajouté un. Cette action revérifie aussi les autorisations une fois que vous les avez corrigées.
- Add organization connecte une autre organisation Azure DevOps.
- Remove déconnecte une organisation. Enclave cesse d’analyser ses dépôts. Vous pourrez la reconnecter plus tard.
Dépannage
L'organisation affiche « push events not active »
L'organisation affiche « push events not active »
Enclave a lu vos dépôts mais n’a pas pu créer de service hooks. Accordez au compte utilisé pour la connexion l’autorisation Edit Subscription (ou Project Administrator) sur les projets, puis cliquez sur Resync.
Un nouveau projet ou dépôt n'apparaît pas
Un nouveau projet ou dépôt n'apparaît pas
Cliquez sur Resync sur l’organisation. Pour une grande organisation, la resynchronisation se poursuit après votre clic. Les dépôts apparaissent au fil de leur synchronisation.
La validation du jeton échoue
La validation du jeton échoue
- Azure DevOps rejected this token : le jeton a expiré ou a été révoqué. Créez-en un nouveau.
- This token can’t do everything Enclave needs : recréez le jeton pour qu’il puisse lire le code, lister les projets et gérer les service hooks.
- This token authenticated but can’t see any projects : ajoutez le propriétaire du jeton à un projet dans Project Settings → Permissions.
- We couldn’t reach that Azure DevOps organization : vérifiez le nom de l’organisation et vos règles réseau.
L'organisation affiche « reconnect needed »
L'organisation affiche « reconnect needed »
Enclave ne peut plus utiliser les identifiants de la connexion. Retirez l’organisation, puis connectez-la de nouveau.