This project provides a Slack integration to enable starting video conferences from Slack and easily inviting Slack members to conferences.
Enables starting and joining Jitsi Meet meetings from within Slack
These instructions will get you started with the ability to run the project on your local machine for development purposes.
A working setup for the Go Programming Language is needed. Here is a getting started guide. The project is currently using go version 1.16 along with module support.
A slack account needs to be created as well as an
app. The app created is intended for
development purposes. The following functionality must be enabled in the Add features and functionality section of the slack app configuration:
- App Home
- Bot Name: 'jitsi_meet'
- Slash Commands
- set up '/jitsi' with: https://[server]/slash/jitsi
- OAuth & Permissions
- redirect URL: https://[server]/slack/auth
- Scopes: chat:write, commands, im:write, users:read
- Event Subscriptions:
- request URL: https://[server]/slack/event
- Subscribe to workspace events: 'app_uninstalled'
Note: This uses Slack v2 OAUTH 2.0. For legacy support, see: v0.1.2
SLACK_SIGNING_SECRET=<signing secret of slack app>
SLACK_CLIENT_ID=<client id of slack app>
SLACK_CLIENT_SECRET=<client secret of slack app>
SLACK_APP_ID=<slack app id>
SLACK_APP_SHARABLE_URL=<slack app url for sharing install>
DYNAMO_REGION=<dynamodb region used>
TOKEN_TABLE=<dynamodb table name for storing oauth tokens>
SERVER_CFG_TABLE=<dynamodb table name for server config info>
JITSI_TOKEN_SIGNING_KEY=<key used to sign conference asap jwts>
JITSI_TOKEN_KID=<key identifier for conference asap jwts>
JITSI_TOKEN_ISS=<issuer for conference asap jwts>
JITSI_TOKEN_AUD=<audience for conference asap jwts>
JITSI_CONFERENCE_HOST=<conference hosting service i.e. https://meet.jit.si>
HTTP_PORT=<port to run HTTP, default is 8080>
STATS_PORT<port to serve Prometheus stats, default is to prevent stats>
Note that JITSI_TOKEN_SIGNING_KEY is a dataurl that contains a
base64-encoded PKCS1 or PKCS8 key, and should look something like:
data:application/pkcs1;kid=[urlencoded kid];base64,[base64 pkcs1 key]
Clone this project and build with go build cmd/api/main.go or build and run
with go run cmd/api/main.go
Dependency management for this project uses go module as of go version 1.16. More information can be found at go command documentation.
This project uses Semantic Versioning for the code and associated docker containers. Versions are tracked as tags on this repository.
This project is licensed under the Apache 2.0 License LICENSE