Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bitsofinfo/slack-payload-handler
Tekton EventListener Webhook interceptor target intended to simplify dealing w/ slack interactive messages & slack slash commands
https://github.com/bitsofinfo/slack-payload-handler
kubernetes slack tekton-triggers tektoncd
Last synced: 25 days ago
JSON representation
Tekton EventListener Webhook interceptor target intended to simplify dealing w/ slack interactive messages & slack slash commands
- Host: GitHub
- URL: https://github.com/bitsofinfo/slack-payload-handler
- Owner: bitsofinfo
- License: apache-2.0
- Created: 2020-02-11T20:37:15.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-10-02T20:01:09.000Z (about 4 years ago)
- Last Synced: 2023-03-24T07:19:46.280Z (over 1 year ago)
- Topics: kubernetes, slack, tekton-triggers, tektoncd
- Language: Go
- Homepage:
- Size: 26.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# slack-payload-handler
[](https://hub.docker.com/repository/docker/bitsofinfo/slack-payload-handler)
Simple utility you can use as a custom [Tekton triggers webhook interceptor](https://github.com/tektoncd/triggers/blob/master/docs/eventlisteners.md#Webhook-Interceptors) when receiving [Slack interactive message payloads](https://api.slack.com/interactivity/handling#payloads) in response to user interaction (i.e. clicking on buttons etc) to trigger things in your Tekton CICD system. It can also be used respond to [Slack slash commands](https://api.slack.com/interactivity/slash-commands#app_command_handling).
For Slack interactive message posts, for convience it lightly mutates the original JSON and adds an `action_values` property which is just an array of the selected `values` under `actions`. Completely ignorable if you don't want to use it.
There are no additional mutations for Slack slash command posts.
## Usage
```
Usage of ./slack-payload-handler:
-debug-request
Optional, print requests to STDOUT, default false
-debug-response
Optional, print responses to STDOUT, default false
-listen-port int
Optional, port to listen on, default 8080 (default 8080)
```
## Docker example
```
docker run -p 8080:8080 -it bitsofinfo/slack-payload-handler \
slack-payload-handler --debug-request true --debug-response true --listen-port 8080
```
## Example
Simulate a interactive message post:
```
$> ./slack-payload-handler --debug-request true --debug-response true
$> curl -k -X POST localhost:8080 --data-urlencode 'payload={"x":"b","actions":[{"value":"1"}]}'
{"action_values":["1"],"actions":[{"value":"1"}],"x":"b"}
```
Simulate a slash command message post:
```
$> ./slack-payload-handler --debug-request true --debug-response true
$> curl --location --request POST 'http://localhost:8080/' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=123' \
--data-urlencode 'command=mycommand' \
--data-urlencode 'dog=cat'
{"command":"mycommand","dog":"cat","token":"123"}
```
## Test slack dummy payload
```
$> ./slack-payload-handler --debug-request true --debug-response true
$> curl -k -X POST localhost:8080 --data-urlencode "payload=$(cat slack.test.json)"
```
## See an example of it in use
https://github.com/bitsofinfo/cicdstatemgr/tree/master/examples/tekton
## notes
https://github.com/nlopes/slack/pull/638
https://github.com/gorilla/mux/issues/531