Microsoft Teams

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

Pour mettre en place 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. Allez dans le Microsoft Teams app store et ajoutez l'application GitGuardian.

2. Sélectionnez le canal vers lequel vous souhaitez envoyer les alertes.
   

   Un message de bienvenue est envoyé dans votre canal :
   

3. Copiez le lien vers le canal :

   • Faites un clic droit sur le nom du canal.
     
   • Sélectionnez Get link to channel.
     

4. Ajoutez l'intégration à votre équipe dans la section d'intégration Microsoft Teams des paramètres de votre tableau de bord.

   Configuration au niveau équipe :

   • Workspace personnel : vous pouvez uniquement configurer l'alerting sur l'équipe « All-incidents ».
   • Workspace business : vous pouvez configurer l'intégration sur n'importe quelle équipe :
     • Créez-la dans l'équipe « All-incidents » pour recevoir les notifications de tous les incidents du workspace.
     • Créez-la dans une équipe spécifique pour recevoir les 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é.
   

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

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

Événements

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

Nom	Description
New incident detected	Un nouvel incident a été détecté.
New occurrence detected	Une nouvelle occurrence a été détectée pour cet incident.
Incident resolved	Cet incident a été résolu.
Incident ignored	Cet incident a été ignoré.
Incident reopened	Cet incident a été rouvert.
Incident regression	Une nouvelle régression a été trouvée pour cet incident.
Incident assigned	Cet incident a été assigné à un utilisateur.
Incident reassigned	Cet incident a été réassigné à un autre utilisateur.
Incident unassigned	Un utilisateur a été désassigné de cet incident.
Incident Severity changed	La sévérité a été mise à jour pour cet incident.
Incident Validity changed	La validité a été mise à jour pour cet incident.
Incident access granted	Un utilisateur s'est vu accorder l'accès à cet incident.
Incident access revoked	L'accès à cet incident a été révoqué pour un utilisateur.
Incident shared publicly	Un utilisateur a généré un lien de partage public pour cet incident.
Incident unshared publicly	Un utilisateur a désactivé le lien de partage public pour cet incident.
Feedback submitted	Un feedback a été soumis pour cet incident.
New comment on an incident	Une nouvelle note a été créée pour cet incident.

Configurer MS Teams pour GitGuardian Self-Hosted

1. Configurez votre application Microsoft Teams
   

   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 les notifications via un bot. Suivez ces étapes :

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

   • Le bot agit comme l'interface pour envoyer les 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. Utiliser 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 Terms of Service et Privacy Policy.

   c. Ajouter 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 à Team et Group Chat pour une flexibilité maximale.

   d. Publier l'application

   • Naviguez vers la section Publish to org pour publier l'application en interne au sein de votre organisation.
   • Une fois publiée, l'application sera disponible dans le Microsoft Teams Store de 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 compléter l'intégration :

   • Dans le Azure portal, cherchez 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 vers lequel envoyer les alertes.
   

   Un message de bienvenue est envoyé dans votre canal :
   

3. Copiez le lien vers le canal :

   • Faites un clic droit sur le nom du canal.
     
   • Sélectionnez Get link to channel.
     

4. Ajoutez l'intégration à votre équipe dans la section d'intégration Microsoft Teams des paramètres de votre tableau de bord.

5. Collez le lien copié.
   

6. Sélectionnez les événements auxquels vous souhaitez vous abonner et recevoir (voir la table Events ci-dessus).

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