Microsoft Teams

This notifier sends a message to a Microsoft Teams channel in case an incident is detected.

To set up your Microsoft Teams integration, provide a Microsoft Teams channel ID in the Teams settings section.

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.

5. Paste the copied link.
   

6. Your integration is now successfully configured.

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 Create an 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. Your integration is now successfully configured.