/teams-webhook-finder

Find all teams where used the webhook connector in Microsoft Teams

Primary LanguageGoMIT LicenseMIT

Microsoft Teams Webhook Finder

This tool builds on the Microsoft Graph API and the Microsoft API Wrapper by SecNex

GitHub Downloads (all assets, all releases)

Prerequirements

  • Entra ID Enterprise Application registered in Azure AD/Entra ID tenant.
  • Azure AD application with the following permissions:
    • AppCatalog.Read.All
    • Team.ReadBasic.All
    • TeamAppInstallation.ReadForTeam.All
  • Client ID, client secret, and tenant ID of the app registration.

Quick Start

  1. Download the latest release from GitHub.
  2. Create the configuration file config.json in the same directory as the executable file.
  3. Add the following content to the configuration file:
{
    "client": {
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET",
        "tenant_id": "YOUR_TENANT_ID"
    }
}
  1. Run the executable file.

On Windows:

.\webhook-finder.exe

On Unix:

chmod +x webhook-finder
./webhook-finder
  1. Read the display name of the Microsoft Teams teams where the webhook is installed/used.

Configuration

The configuration file config.json must contain the following fields:

  • client_id: The client ID of the Azure AD application.
  • client_secret: The client secret of the Azure AD application.
  • tenant_id: The tenant ID of the Azure AD application.

License

This project is licensed under the MIT License - see the LICENSE file for details.