Microsoft Teams

This notifier can send messages to a Microsoft Teams channel for incident lifecycle events (from Internal and/or Public Monitoring), honeytoken alerts.

To set up your Microsoft Teams integration, provide a Microsoft Teams channel link in the Teams settings section and configure which events you want to receive notifications for.

How to integrate

1. Go to the Microsoft Teams app store and add the GitGuardian app.

2. Select the channel where you want to send alerts.
   

   A welcome message is sent to your channel:
   

3. Copy the link to the channel:

   • Right-click the channel name.
     
   • Select Get link to channel.
     

4. Add the integration to your team in the Microsoft Teams integration section of your dashboard settings.

   Team-level configuration:

   • Personal workspace: You can only configure alerting on the 'All-incidents team'.
   • Business workspace: You can configure the integration on any team:
     • Create it within the 'All-incidents team' to receive notifications for all workspace incidents.
     • Create it within a specific team to receive notifications only for that team's incidents.

   This can be done directly from the integration page or from the team page.

5. Paste the copied link.
   

6. Select the events you would like to subscribe to and receive.

7. Your integration is now successfully configured.

Events

You can subscribe to the following events from GitGuardian Internal Monitoring and/or GitGuardian Public Monitoring (if your workspace and team have access to Public Monitoring):

Name	Description
New incident detected	A new incident has been detected.
New occurrence detected	A new occurrence has been detected for this incident.
Incident resolved	This incident has been resolved.
Incident ignored	This incident has been ignored.
Incident reopened	This incident has been reopened.
Incident regression	A new regression was found for this incident.
Incident assigned	This incident has been assigned to a user.
Incident reassigned	This incident has been reassigned to a different user.
Incident unassigned	A user was unassigned from this incident.
Incident Severity changed	The severity has been updated for this incident.
Incident Validity changed	The validity has been updated for this incident.
Incident access granted	A user has been granted access to this incident.
Incident access revoked	Access to this incident has been revoked for a user.
Incident shared publicly	A user has generated a public sharing link for this incident.
Incident unshared publicly	A user has deactivated the public sharing link for this incident.
Feedback submitted	A feedback has been submitted for this incident.
New comment on an incident	A new note has been created for this incident.

Setup MS Teams for self-hosted GitGuardian

1. Configure Your Microsoft Teams App
   

   To integrate Microsoft Teams with the Self-Hosted GitGuardian platform, you must create your own Microsoft Teams app. This app will serve as the interface for sending notifications via a bot. Follow these steps:

   a. Why Do We Need a Bot?

   • The bot acts as the interface for sending messages in Microsoft Teams and will serve as the sender of all GitGuardian notifications.
   • Users can add the bot to their preferred Teams channels via the Microsoft Teams Store and link it to GitGuardian Platform to enable team notifications.

   b. Use the Microsoft Teams Developer Portal

   • Access the Microsoft Teams Developer Portal.
   • Create your app by following these steps:
     • Click New app.
     • Complete the Basic Information section with the required details:
       • Name, Display Name, Description (short and long).
       • Developer/Company Name.
       • Terms of Service and Privacy Policy links.

   c. Add a Bot

   • Navigate to the Add Features section and add a bot:
     • Create a new Entra identity for the bot or link it to an existing bot identity.
     • Under What can your bot do?, select Only send notifications.
     • Set the scope to Team and Group Chat for maximum flexibility.

   d. Publish the App

   • Navigate to the Publish to org section to publish the app privately within your organization.
   • Once published, the app will be available in the Microsoft Teams Store for your organization.
   • If the app is blocked by IT admins or requires approval, complete the validation steps in the Microsoft Teams Admin Portal.

   e. Copy your bot's Client ID and Client Secret from your Microsoft Teams app into GitGuardian to complete the integration:

   • In the Azure portal, search for your app and select Microsoft Entra ID.
   • Find the Application ID (Client ID) in the Overview section.
   • Generate a Client Secret in Certificates & Secrets and copy it immediately (it’s only shown once).

2. Select the channel where you want to send alerts.
   

   A welcome message is sent to your channel:
   

3. Copy the link to the channel:

   • Right-click the channel name.
     
   • Select Get link to channel.
     

4. Add the integration to your team in the Microsoft Teams integration section of your dashboard settings.

5. Paste the copied link.
   

6. Select the events you would like to subscribe to and receive (see the Events table above).

7. Your integration is now successfully configured.