...
Template Name | Extension Name | Extension Version |
---|---|---|
Slack Bot | ue-slack-bot | 1.0.02 |
Refer to Changelog for version history information.
...
Software Requirements for Universal Template and Universal Task
Requires Python 3.7.0 or higher. Tested with the Universal Agent bundled Python distribution.
...
- Universal Agent for Windows x64 Version 7.31.0.0 and later with python options installed.
- Universal Agent for Linux Version 7.31.0.0 and later with python options installed.
...
Universal Controller Version 7.31.0.0 and later.
Network and Connectivity Requirements
...
This Universal Task requires the theĀ Resolvable Credentials feature. Check that the Resolvable Credentials Permitted system property has been set to true.
To import the Universal Template into your Controller, follow the instructions here.
When the files have been imported successfully, refresh the Universal Templates list; the Universal Template will appear on the list.
...
Field | Input type | Default value | Type | Description |
---|---|---|---|---|
Slack Bot token | Required | - | Credentials | The Slack bot token as obtained from Slack App. It is used to connect Slack Application with a Workspace. The Credentials definition should be as follows:
|
Slack App token | Required | - | Credentials | The Slack app token obtained from Slack App. It is used to connect the Slack Bot with the corresponding Slack App. The Credentials definition should be as follows:
|
Slack Channel ID | Required | - | Text | The Slack channel ID that the bot will connect. to. |
ACL | Required | - | Script | The JSON script that contains the ACL rules for your Slack. users. |
Universal Controller URL | Required | - | Text | The URL of the target UC (e.g. http://ue.stonebranch.org:8080/uc). |
Universal Controller Credentials | Required | - | Credentials | This extension uses RESTful Web Services API as a client, and in this field the corresponding username & password should be provided. This user should have Web Service Access enabled (directly or through System Default). It is strongly advised not to reuse admin or any existing user but create a new one used only for this specific integration. The Universal Controller Credentials definition should be as follows:
|
UC REST API Timeout | Required | 20 | Text | The timeout (in seconds) that the Slack Bot will wait for UC to respond. If the UC won't respond in the specified time limit Slack will display a corresponding error to the user. |
Auditing | Optional | True | Checkbox | A variable that if selected the bot will provide auditing logs. |
...
- Granting access to user with email "john.doe@company.com" to execute rerun task instance command.
...
- Granting access to user with email "alice.smith@company.com" to execute rerun task instance and show agents status commands.
...
- Granting access to user with email "john.doe@company.com" to execute all commands related to instances and allow user with email "alice.smith@example" to only run reports and hold task instances.
...
- Granting access to all users to execute all the commands.
{
"*": {[
{
"resource": "*",
"action": "*",
"permission": "ALLOW"
}
}]
}
- Granting access to all users to execute all the commands but forbid a user with user with email "john.doe" to run reports.
...
Example of UE Slack Bot Universal Task for starting the execution of the Slack Bot.
Task Output
Since this universal task is designed to operate endlessly, task output is provided only in case of an error in initialization phase or during task instance cancel.
...
Parameters | Description | Values and Constraints | Required | Default |
---|---|---|---|---|
triggername | The name of the triggered to be created. | Max 255 length string (case insensitive) | True | - |
taskname | The task name to be binded with the created trigger triggername. | Max 255 length string (case insensitive) | True | - |
date | The date which the taskname will be run. | YYYY-mm-dd format | True | Current date |
time | The date which the taskname will be run. In combination with date filed it must be after current time. | HH:MM format | True | Current time + 1 minutes |
timezone | the timezone of the specified time. | UTC-12 to UTC+14 | True | UTC |
Command Examples
...
This document references the following documents.
Document Link | Description |
---|---|
Universal Templates | User documentation for creating, working with and understanding Universal Templates and Integrations. |
Universal Tasks | User documentation for creating Universal Tasks in the Universal Controller user interface. |
Slack Bot API | User guide for Slack Bot API. |
Changelog
ue-slack-bot-1.0.2 (2022-12-15)
Bugfix
: Extension is available for 7.1 and 7.2 UC versions'
ue-slack-bot-1.0.1 (2022-11-22)
Bugfix
: Ignore trailing slash character in field 'Universal Controller URL'
ue-slack-bot-1.0.0 (2022-11-21)
...