GitHub
L’application GitHub de Cursor connecte vos dépôts pour vous permettre d’utiliser des fonctionnalités telles que les agents cloud et Bugbot.
Configuration
Nécessite un accès administrateur à Cursor et à l’organisation GitHub.
- Accédez aux Intégrations dans le tableau de bord
- Cliquez sur Connecter à côté de GitHub (ou sur Gérer les connexions si GitHub est déjà connecté)
- Choisissez Tous les dépôts ou Dépôts sélectionnés
- Retournez au tableau de bord pour configurer les fonctionnalités de vos dépôts
Pour déconnecter votre compte GitHub, retournez au tableau de bord des intégrations et cliquez sur Déconnecter le compte.
Configuration de la liste d’adresses IP autorisées
Si votre organisation utilise la fonctionnalité de liste d’adresses IP autorisées de GitHub pour restreindre l’accès à vos dépôts, Cursor peut être configuré pour utiliser un proxy de sortie hébergé avec un nombre limité d’adresses IP.
Avant de configurer des listes d’adresses IP autorisées, contactez hi@cursor.com pour activer cette fonctionnalité pour votre équipe. Cette étape est requise pour les deux méthodes de configuration ci-dessous.
Activer la configuration de la liste d’adresses IP autorisées pour les applications GitHub installées (recommandé)
La liste d’adresses IP est déjà préconfigurée pour l’application GitHub de Cursor. Vous pouvez activer la liste d’autorisation pour les applications installées afin qu’elles héritent automatiquement de cette liste. Il s’agit de l’approche recommandée, car elle nous permet de mettre à jour la liste et votre organisation reçoit automatiquement ces mises à jour.
Pour l’activer :
- Accédez aux paramètres de sécurité de votre organisation
- Accédez aux paramètres de la liste d’adresses IP autorisées
- Cochez « Autoriser l’accès par les applications GitHub »
Pour obtenir des instructions détaillées, consultez la documentation GitHub.
Ajoutez directement des adresses IP à votre liste d’autorisation
Si votre organisation utilise des listes d’autorisation définies par l’IdP dans GitHub ou ne peut pas utiliser la liste d’autorisation préconfigurée, ajoutez les adresses IP du proxy indiquées dans Proxy de sortie Git et liste d’adresses IP autorisées.
Réseau avancé
Les instances auto-hébergées prennent en charge plusieurs méthodes de connexion autres que la liste d’autorisation d’adresses IP. Pour plus d’informations sur la configuration et les options de réseau privé prises en charge, consultez Connectivité privée.
Disponible pour les clients Enterprise. Utilisez AWS PrivateLink lorsque votre GitHub Enterprise Server est hébergé sur AWS ou peut être placé derrière un AWS Network Load Balancer. PrivateLink permet à Cursor d’accéder à GHES et, si nécessaire, à GHES d’envoyer des webhooks à Cursor sans passer par l’internet public.
Idéal pour : les instances GHES hébergées sur AWS et les équipes qui souhaitent une connectivité privée via un endpoint VPC
Sécurité : chiffrement HTTPS, AWS PrivateLink, stratégies d’endpoint VPC, tokens d’accès de compte de service
Inconvénients : nécessite une coordination avec Cursor et la configuration d’un service endpoint AWS.
Disponible pour les clients Enterprise. Utilisez Cloudflare Tunnel lorsqu’AWS PrivateLink n’est pas une option pratique ou si vous avez besoin d’un modèle de déploiement sortant uniquement. Votre réseau exécute cloudflared et Cursor fournit le nom d’hôte et le token du tunnel.
Idéal pour : les environnements sans accès réseau entrant
Sécurité : chiffrement HTTPS, Cloudflare Tunnel, tokens d’accès de compte de service
Inconvénients : nécessite d’exécuter et de maintenir cloudflared dans votre environnement.
Autorisations
L’application GitHub demande les autorisations suivantes pour prendre en charge les fonctionnalités de Cursor :
| Autorisation | Objectif |
|---|---|
| Accès au dépôt | Cloner votre code et créer des branches de travail |
| Pull requests | Créer des PR et laisser des commentaires de revue |
| Issues | Suivre les bugs et les tâches identifiés lors des revues |
| Vérifications et statuts | Rendre compte de la qualité du code et des résultats des tests |
| Actions et flux de travail | Surveiller les pipelines CI/CD et relancer la CI depuis les pull requests |
| Administration | Lire les règles de protection des branches et les vérifications requises pour déterminer si une PR peut être fusionnée |
| Rôles personnalisés du dépôt | Déterminer les niveaux d’accès des utilisateurs afin d’afficher les options de fusion et de revue appropriées |
| Propriétés personnalisées de l’organisation | Afficher les métadonnées de dépôt définies par l’organisation dans les filtres |
Toutes les autorisations respectent le principe du moindre privilège.
Périmètres Git protégés
Associez votre organisation GitHub à votre organisation Cursor afin que seules vos équipes puissent utiliser ses dépôts avec les agents cloud, les automatisations et Bugbot. La protection d’un périmètre nécessite des droits de propriétaire ou d’administrateur sur l’organisation GitHub. Voir Périmètres Git protégés.
Dépannage
- Installez l’application GitHub avec accès au dépôt
- Vérifiez les autorisations du dépôt pour les dépôts privés
- Vérifiez les autorisations de votre compte GitHub
- Accordez à l’application l’accès en écriture aux pull requests
- Vérifiez les règles de protection des branches
- Réinstallez l’application si son installation a expiré
- Vérifiez si elle est installée au niveau de l’organisation
- Réinstallez depuis github.com/apps/cursor
- Contactez le support si l’installation est corrompue
Étapes suivantes
Une fois votre intégration GitHub connectée, configurez les fonctionnalités qui l'utilisent :
- Bugbot — examens automatisés de PR qui détectent les bugs et les problèmes de sécurité
- Agents cloud — agents IA qui s'exécutent dans le cloud sur vos dépôts