Microsoft Teams
Source integration to Microsoft Teams, a messaging app.
You can only configure this source to run through the integration on the web frontend.
During the initial setup of the Teams integration, an admin account will need to provide permission as part of the OAuth2 flow.
To enable the necessary functionality in the Teams integration, the following scopes are required:
- ChannelMessage.Read.All: This scope allows Trufflhog to access and read messages in all public and private channels within the Teams workspace, unless specific include/exclude filters are applied during the setup process. Please note that scanning direct messages is currently not supported.
Currently, each integration can only be configured to scan a single team. If you want to scan multiple teams, you will need to create separate integrations. However, we plan to enhance this capability in the future, allowing multiple teams to be scanned from a single integration.
When configuring the Teams scanner from the UI Dashboard the Team ID is referencing your Microsoft Teams ID number. This can be found by going into your Teams app in the lefthand pane, click the … button next to the team, and click “Get link to team”. Please be sure the menu is for the team and not for a channel.
The Team ID will come right after groupId in the link provided. (ex. groupId=xxxxx&tenantId=xxxxxx).
Microsoft teams is only available with web configuration.
Feature | Supported |
|---|---|
Scan archive files | ✅ |
Scan attachments | ✅ |
Scan base64 encoded data | ✅ |
Scan binaries | ✅ |
Scan Microsoft Office files | ✅ |
Scan direct messages | ❌ |
Scan private channels (if authorized by tenant admin) | ✅ |
Exclude / Include filters | ✅ |
Auto resume | ✅ |
