An open API service indexing awesome lists of open source software.

https://github.com/secnex/teams-webhook-finder

Find all teams where used the webhook connector in Microsoft Teams
https://github.com/secnex/teams-webhook-finder

deprecated microsoft teams webhook

Last synced: 11 months ago
JSON representation

Find all teams where used the webhook connector in Microsoft Teams

Awesome Lists containing this project

README

          

# Microsoft Teams Webhook Finder

This tool builds on the Microsoft Graph API and the [Microsoft API Wrapper](https://github.com/SecNex/ms-api-wrapper) by [SecNex](https://secnex.io)

![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/SecNex/teams-webhook-finder/total)

## 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:

```json
{
"client": {
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"tenant_id": "YOUR_TENANT_ID"
}
}
```

4. Run the executable file.

**On Windows:**

```powershell
.\webhook-finder.exe
```

**On Unix:**

```bash
chmod +x webhook-finder
./webhook-finder
```
5. 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](LICENSE) file for details.