Scan data for secrets

Microsoft Teams

5min
ο»Ώ

Source integration to Microsoft Teams, a messaging app.

Configuration

Web configuration

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.

Document image
ο»Ώ

The Team ID will come right after groupId in the link provided. (ex. groupId=xxxxx&tenantId=xxxxxx).

Document image
ο»Ώ

Local configuration

Microsoft teams is only available with web configuration.

Capabilities

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

βœ…

ο»Ώ

Updated 17 Jun 2024
Doc contributor
Doc contributor
Doc contributor
Did this page help you?