Keybase is a messaging app that allows you to send end-to-end encrypted messages to other people and teams.
Using the opensentinel integration, you can add your Keybase team channels and private DMs as automation destinations - all managed through your dashboard and handled by our automated bot sentinelbot.
You will need a Keybase account as well as their chat application installed for the next few sections, so sign up for a free account if you have not already done so.
This guide will walk you through the details of setting up the individual components - or building blocks. If you're looking for a high-level walkthrough of how these pieces fit together, read through our reference on Creating your first Automation Recipe.
Head over to the the Linked Accounts section of your dashboard.
Click the Add
button to bring up the Connect an External Account dialog.
Choose Keybase
from the service dropdown list, enter in your Keybase username, and click Connect
.
You'll get a summary result which will include your verification code.
Now open up a Keybase chat window with @sentinelbot
and message it the verification code (e.g. !verifyme X-XXXXXXX
).
After it confirms your verification code, the service status will change to Active
and your Keybase account will be ready for you to use in opensentinel.
You might have to refresh the page if you still see the status as Inactive
.
The opensentinel Keybase integration is managed through our automated bot sentinelbot.
Adding this bot to your team allows you to use your team channels as automation destinations - for webhooks and other integrations.
On your team page, navigate to the Bots
section and click the Install bots
button.
Type sentinelbot
in the search bar and click on the result.
In the Install as
prompt, choose Restricted bot (recommended)
and click the Review
button.
Leave the default options as is and click the Install
button.
That's all there is to it, you're now ready to set up any of your team channels as an opensentinel automation Destination.
Adding a team channel as an automation destination to opensentinel allows you to receive notifications from webhooks and other opensentinel Automation Sources (Integrations).
Note: you'll need to add opensentinel to your team as a prerequisite for this section.
In the Keybase app, navigate over to the team channel you want to use as an automation destination and issue the !add-destination
command.
In this example, we'll be adding the #feedback
channel in the @pipernet
Keybase team.
After the operation completes successfully it will print out a summary.
Finally head over to the Automation Destinations section of your dashboard.
From here you can edit the target to rename it if needed.
You might need to refresh the page if you don't immediately see the new automation destination.
You can now use your Keybase channel to receive notifications from webhooks and other opensentinel automation sources!
Note: instead of teams, you also have the ability to receive opensentinel notifications in DMs - follow the same instructions as above but instead of a team channel, issue the !add-destination
command in a 1-on-1 conversation with @sentinelbot
and you will see the same results.
In order to cut down on spam & abuse, opensentinel only allows team members with a writer
(or higher) role to create automation destinations within their teams.
The following bot commands are supported by @sentinelbot
:
Command | Description |
---|---|
!add-destination | Adds the current channel/conversation as an opensentinel automation destination. |
!help | basic help |