Cet article explique comment configurer l'intégration des activités de l'application pour GitHub.
Présentation
Activités de l'application vous fournit une solution basée sur API pour la visibilité hors bande de toutes les activités effectuées par n'importe quel utilisateur dans une application SaaS connectée. Pour offrir Activités de l'application la visibilité des données au sein d'une application, vous devez configurer une intégration avec l'application requise. Une fois l'intégration créée, si un champ a changé ou expiré, vous pouvez le modifier depuis la page Ressources > Intégrations > Applications intégrées. Pour plus d'informations, voir Qu'est-ce que le contrôle des applications via API avec Activités de l'application.
Pour configurer l'intégration des activités de l'application, vous devez :
Configurer l'intégration au sein de l'application SaaS
Créer le connecteur API dans la CMA
Une licence CASB est requise pour App Activities. Cette licence inclut le contrôle des applications et des données et Activités de l'Application via API. Pour plus d'informations sur l'achat d'une licence CASB, veuillez contacter votre représentant Cato.
Avantages de la connection de GitHub
Après avoir créé ce connecteur, vous pouvez visualiser et surveiller l'activité dans votre environnement GitHub. Par exemple,
Connexions des utilisateurs
Clonage de dépôts
Commits
Requêtes de tirage
Modification des paramètres des dépôts/organisations
Alertes des analyses de code/vulnérabilités
Cela vous aide à identifier et à répondre aux activités suspectes, et vous pouvez recevoir des alertes pour ces activités :
Analyses de sécurité de code
Analyses de vulnérabilité (Dependabot)
Analyses de secrets
Configuration de l'intégration GitHub
Pour configurer l'intégration GitHub, créez un nouveau jeton d'accès personnel.
Pré-requis
Vous devez avoir acheté une licence GitHub Enterprise
Ces autorisations (permissions) sont fournies :
Utilisateur - lire:utilisateur
Audit_log - lire:audit_log
Organisme - lire:organisme
Entreprise - lire:entreprise
Repository - événements de sécurité:Lire
Remarque :
À partir de mars 2026, le connecteur GitHub pourra collecter des événements de sécurité pour l'audit et la corrélation inter-plateformes. Si vous avez créé ce connecteur avant mars 2026, vous devez régénérer le jeton d'accès, avec la portée supplémentaire
security_events:Lireet ajouter le nouveau jeton dans le CMA.Pour régénérer le jeton d'accès, dans le Centre développeur GitHub, sélectionnez le jeton existant utilisé pour l'intégration Cato. Cliquez sur Regenerate token, et sous la section Répertoire, assurez-vous que
security_events:Lireest sélectionné. Cliquez sur Regenerate token pour appliquer les modifications. Suivez l'étape 2 ci-dessous pour ajouter le nouveau jeton au CMA.
Étape 1 : Configurer l'intégration dans le centre développeur GitHub
Dans le centre développeur GitHub, identifiez le jeton d'accès à saisir dans le CMA.
Pour configurer l'intégration GitHub :
Dans le Centre des développeurs GitHub, accédez à Jetons d'accès personnels > Jetons (classique).
Cliquez sur Générer un nouveau jeton.
Définissez la date d'expiration du jeton.
Nous vous recommandons de définir la date d'expiration pour la durée maximum autorisée d'un an.
Ajoutez les portées listées ci-dessus.
Cliquez sur Générer un jeton.
Copiez et enregistrez le nouveau jeton d'accès pour pouvoir l'ajouter dans l'Application de gestion Cato.
Accédez à Paramètres > Entreprises.
Cliquez sur le nom de votre entreprise.
La page de connexion de votre entreprise s'affiche.
Copiez et enregistrez le dernier segment de l'URL pour pouvoir l'ajouter dans le CMA. Par exemple, dans l'URL
https://github.com/enterprises/cato, copiez et enregistrezcato.
Étape 2 : Créez le connecteur API dans le CMA
Une fois que vous avez configuré une intégration avec l'application requise, ajoutez les détails dans le CMA.
Pour créer le Connecteur API dans le CMA :
Dans le menu de navigation, cliquez sur Ressources > Intégrations.
Cliquez sur l'onglet Intégrations Configurées.
Cliquez sur New.
Le panneau Nouvelle intégration s'ouvre.
Sélectionnez l'application SaaS que vous souhaitez ajouter.
Dans la liste déroulante Capacité, sélectionnez Activités de l'application.
Ajoutez les détails créés au cours de l'étape un.
Cliquez sur Sauvegarder.
L'application est visible sur le tableau des Applications intégrées avec un statut Connecté.
Après avoir connecté vos APIs, vous pouvez suivre les activités de l'application dans le Tableau de bord des activités Cloud. Les données peuvent prendre quelques minutes pour apparaître.
Limitation connue
Tous les événements sont récupérés
Sources
Point de terminaison du journal d'audit de l'entreprise - Interrogation du point de terminaison des événements
GraphQL et point de terminaison des utilisateurs - Interroger les utilisateurs GitHub.