Slack
ο»ΏSlack is a messaging platform that connects people to the information they need. TruffleHog will scan public and private channels that the user has access to.
If you want to send your TruffleHog results to Slack, visit our Slackο»Ώ notifier page instead.
To configure slack, you need to be able to add an app to Slack
ο»Ώ
Web configuration is strongly recommended for scanning Slack.
You will need to be able to create a single workspace app.
If you are able, we recommend using the Slack install from the UI because not only is it much easier, but it also scans faster because it has higher rate limits.
You may create your own single workspace Slack app to utilize with TruffleHog and provide the refresh token in the token field in the example above. Below are the steps to create the app.
Start creating the app hereο»Ώ
Give the app a name a choose the workspace you want to TruffleHog to operate on. (You will need seperate apps to utilize a multiple workspaces)
![Document image Document image](https://images.archbee.com/S23bFlGfp3a-8_a9YY_cE/z539l431V6P6byuEIyWem_image.png?format=webp)
Update the βUser Token Scopesβ section with the following scopes:
- users:read
- users:read.email
- channels:history
- channels:read
- groups:history
- groups:read
- files:read
![Document image Document image](https://images.archbee.com/S23bFlGfp3a-8_a9YY_cE/-00fT1Yj7sp5vBBo1aRpG_image.png?format=webp)
Make sure everything is saved and looks correct, then install your app!
![Document image Document image](https://images.archbee.com/S23bFlGfp3a-8_a9YY_cE/yhXC2ea-LUCVIGGoIHfuf_image.png?format=webp)
If your account does not permissions to install the app it may send a request to your Slack admin asking for them to approve it. If so, it may be a good idea to give them a heads up before you do this :)
![Document image Document image](https://images.archbee.com/S23bFlGfp3a-8_a9YY_cE/fAyOd84R7bUGuf_HgC2RJ_image.png?format=webp)
Copy your newly minted token and paste it into the token field from the local configuration file above (TIP: Remove the channels line and values if you want trufflehog to scan all accessible channels.)
![Document image Document image](https://images.archbee.com/S23bFlGfp3a-8_a9YY_cE/-d4ALVBwZJE5F2xOQ3udo_image.png?format=webp)
![Document image Document image](https://images.archbee.com/S23bFlGfp3a-8_a9YY_cE/dAtyovtUJqeObDYQqFWnP_image.png?format=webp)
Once you run your local scan, TruffleHog will pick up and scan the configured Slack source automatically!
Feature | Supported |
---|---|
Scan archive files | β |
Scan attachments | β |
Scan base64 encoded data | β |
Scan binaries | β |
Scan Microsoft Office files | β |
Scan direct messages | β |
Scan private channels (only those that authorizing user is in) | β |
Exclude / Include filters | β |
Real-time scanning | β |
Auto resume | β |
ο»Ώ