Aller au contenu principal

Microsoft Teams

Ce notifieur peut envoyer des messages à un canal Microsoft Teams pour les événements du cycle de vie des incidents (depuis Internal Monitoring et/ou Public Monitoring) et les alertes honeytoken.

Pour configurer votre intégration Microsoft Teams, fournissez un lien de canal Microsoft Teams dans la section des paramètres Teams et configurez les événements pour lesquels vous souhaitez recevoir des notifications.

Comment intégrer​

  1. Rendez-vous sur l'app store Microsoft Teams et ajoutez l'application GitGuardian. 1

  2. Sélectionnez le canal où vous souhaitez envoyer les alertes.
    2

    Un message de bienvenue est envoyé à votre canal :
    3

  3. Copiez le lien vers le canal :

    • Cliquez avec le bouton droit sur le nom du canal.
      4
    • Sélectionnez Get link to channel.
      5
  4. Ajoutez l'intégration à votre équipe dans la section d'intégration Microsoft Teams des paramètres de votre dashboard. 6

    Configuration au niveau de l'équipe :

    • Free workspace : vous pouvez uniquement configurer les alertes sur la « All-incidents team ».
    • Growth ou Enterprise workspace : vous pouvez configurer l'intégration sur n'importe quelle équipe :
      • Créez-la dans la « All-incidents team » pour recevoir des notifications pour tous les incidents du workspace.
      • Créez-la dans une équipe spécifique pour recevoir des notifications uniquement pour les incidents de cette équipe.

    Cela peut être fait directement depuis la page d'intégration ou depuis la page de l'équipe.

  5. Collez le lien copié.
    7

  6. Sélectionnez les événements auxquels vous souhaitez vous abonner et que vous souhaitez recevoir.

  7. Votre intégration est maintenant configurée avec succès. 8

Événements​

Vous pouvez vous abonner aux événements suivants depuis GitGuardian Internal Monitoring et/ou GitGuardian Public Monitoring (si votre workspace et votre équipe ont accès à Public Monitoring) :

NomDescription
New incident detectedUn nouvel incident a été détecté.
New occurrence detectedUne nouvelle occurrence a été détectée pour cet incident.
Incident Validity changedLa validité a été mise à jour pour cet incident.
Incident status changeDéclenché lorsque le statut d'un incident est mis à jour.
    Incident resolvedCet incident a été résolu.
    Incident ignoredCet incident a été ignoré.
    Incident reopenedCet incident a été rouvert.
    Incident regressionUne nouvelle occurrence a été détectée par le scan en temps réel d'une source connectée pour un incident précédemment marqué comme résolu (manuellement ou par l'auto-résolveur).
    Incident Severity changedLa sévérité a été mise à jour pour cet incident.
Risk score updated (plans Growth et Enterprise)Le score de risque a été mis à jour pour cet incident. Non envoyé pour les incidents publics sur les workspaces où l'analyse par agents est activée.
Incident assignmentsDéclenché lorsqu'un incident est assigné, réassigné ou désassigné.
    Incident assignedCet incident a été assigné à un utilisateur.
    Incident reassignedCet incident a été réassigné à un autre utilisateur.
    Incident unassignedUn utilisateur a été désassigné de cet incident.
Incident accessDéclenché lorsque l'accès d'un utilisateur à un incident change.
    Incident access grantedL'accès à cet incident a été accordé à un utilisateur.
    Incident access revokedL'accès à cet incident a été révoqué pour un utilisateur.
Publicly sharedDéclenché lorsque le lien de partage public d'un incident change.
    Incident shared publiclyUn utilisateur a généré un lien de partage public pour cet incident.
    Incident unshared publiclyUn utilisateur a désactivé le lien de partage public pour cet incident.
MessagesDéclenché lorsqu'un nouveau message est ajouté à un incident.
    Feedback submittedUn feedback a été soumis pour cet incident.
    New comment on an incidentUne nouvelle note a été créée pour cet incident.

Filtrer les notifications par critères d'incident​

Vous pouvez définir des règles de filtrage afin que ce notificateur n'envoie des notifications que pour les incidents correspondant aux critères que vous choisissez — par severity, score de risque ML, validité, type de secret ou tags GitGuardian, à la fois sur les incidents d'internal monitoring et de public monitoring. Le score de risque est l'exception : il n'est pas disponible sur les incidents publics si l'analyse par agents est activée pour le workspace. Si vous ne définissez aucune règle, tous les incidents sont notifiés (comportement par défaut).

Consultez Filtrer les notifications par critères d'incident pour la liste complète des critères et des remarques importantes sur le moment d'envoi des notifications.

Configurer MS Teams pour GitGuardian self-hosted​

  1. Configurez votre application Microsoft Teams
    9

    Pour intégrer Microsoft Teams à la plateforme GitGuardian Self-Hosted, vous devez créer votre propre application Microsoft Teams. Cette application servira d'interface pour envoyer des notifications via un bot. Suivez ces étapes :

    a. Pourquoi avons-nous besoin d'un bot ?

    • Le bot agit comme l'interface pour envoyer des messages dans Microsoft Teams et servira d'expéditeur de toutes les notifications GitGuardian.
    • Les utilisateurs peuvent ajouter le bot à leurs canaux Teams préférés via le Microsoft Teams Store et le lier à la plateforme GitGuardian pour activer les notifications d'équipe.

    b. Utilisez le Microsoft Teams Developer Portal

    • Accédez au Microsoft Teams Developer Portal.
    • Créez votre application en suivant ces étapes :
      • Cliquez sur New app.
      • Complétez la section Basic Information avec les détails requis :
        • Name, Display Name, Description (courte et longue).
        • Developer/Company Name.
        • Liens vers les Terms of Service et la Privacy Policy.

    c. Ajoutez un bot

    • Naviguez vers la section Add Features et ajoutez un bot :
      • Créez une nouvelle identité Entra pour le bot ou liez-le à une identité de bot existante.
      • Sous What can your bot do?, sélectionnez Only send notifications.
      • Définissez la portée sur Team et Group Chat pour une flexibilité maximale.

    d. Publiez l'application

    • Naviguez vers la section Publish to org pour publier l'application de manière privée au sein de votre organisation.
    • Une fois publiée, l'application sera disponible dans le Microsoft Teams Store pour votre organisation.
    • Si l'application est bloquée par les administrateurs IT ou nécessite une approbation, complétez les étapes de validation dans le Microsoft Teams Admin Portal.

    e. Copiez le Client ID et le Client Secret de votre bot depuis votre application Microsoft Teams dans GitGuardian pour finaliser l'intégration :

    • Dans le portail Azure, recherchez votre application et sélectionnez Microsoft Entra ID.
    • Trouvez l'Application ID (Client ID) dans la section Overview.
    • Générez un Client Secret dans Certificates & Secrets et copiez-le immédiatement (il n'est affiché qu'une seule fois).
  2. Sélectionnez le canal où vous souhaitez envoyer les alertes.
    2

    Un message de bienvenue est envoyé à votre canal :
    3

  3. Copiez le lien vers le canal :

    • Cliquez avec le bouton droit sur le nom du canal.
      4
    • Sélectionnez Get link to channel.
      5
  4. Ajoutez l'intégration à votre équipe dans la section d'intégration Microsoft Teams des paramètres de votre dashboard. 6

  5. Collez le lien copié.
    10

  6. Sélectionnez les événements auxquels vous souhaitez vous abonner et que vous souhaitez recevoir (voir le tableau des Événements ci-dessus).

  7. Votre intégration est maintenant configurée avec succès. 8