- 14 May 2023
- 2 Minutes to read
- Print
- DarkLight
- PDF
Slack - Send Message to Channel
- Updated on 14 May 2023
- 2 Minutes to read
- Print
- DarkLight
- PDF
Slack - Send Message to Channel posts a message to a Slack channel for Assets that match the results of the selected saved query, and match the Enforcement Action Conditions, if defined or assets selected on the relevant asset page.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
- Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs and Adapter Fetch History Modules
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
- Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
- Configure Action Conditions - Toggle on to enter a condition statement. See Configuring Enforcement Action Conditions to learn more about condition statement syntax.
- Use stored credentials from Slack Adapter - Select this option to use Slack connected adapter credentials.
When you select this option, the Select Adapter Connection drop-down is available, and you can choose which adapter connection to use for this Enforcement Action.
To use this option, you must successfully configure a Slack adapter connection.
Required Fields
These fields must be configured to run the Enforcement Set.
Channel ID - The ID of the channel to which to send the messages.
Incident Description - Specify an incident description to be included in the Slack message.
Instance Name - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
Host Name or IP Address - The hostname or IP address of the Slack server.
Authentication Token - An Authentication Token associated with a user account that has the Required Permissions to fetch assets.
Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
HTTPS proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
If Use stored credentials from Slack adapter is not enabled, the above fields are required.
- Top Results Count (max 100) - Set the top number of results to be displayed. The default value is 20.
Tunnel Name - For Axonius-hosted (SaaS) deployments. Select the tunnel through which to connect to perform the action.
API
Axonius uses the Slack Post Message API
Permissions
The following permissions are required:
Bot tokens: chat:write
User tokens: chat:write, chat: write:user, chat:write:bot
For more details about other Enforcement Actions available, see Action Library.