Skip to content
dnsimplePublic

About

Listen to incoming webhooks from DNSimple, and publish them to a Slack channel or other messaging service.

Topics

Resources

Contributing

Stars

23 stars

Watchers

8 watching

Forks

Repository files navigation

Strillone

Strillone is a service to publish the events generated from a DNSimple account to a messaging service, using the DNSimple webhooks.

ci

Example

Usage

Deploy the application

You can use the following button to deploy the service to Heroku.

Deploy

Check the deploy

Make sure the app is properly deployed. If you access the homepage, you should see a JSON response like the following one:

{"ping":"1458412047","what":"dnsimple-strillone"}

Configure the Publishers

Configure the target of the messages. We currently support the following publishers:

See below for the specific configurations.

Create the webhook

Once you configured the publisher and generated the webhook URL, use the URL to create a new webhook in your DNSimple account.

Slack configuration

Strillone integrates with Slack using the Slack Incoming Webhook feature.

Step 1: Set up a Slack Incoming Webhook

  1. Go to your Slack workspace and create a new Incoming Webhook
  2. Choose the channel where you want the DNSimple notifications to appear
  3. Slack will provide you with a webhook URL that looks like this:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Step 2: Create your Strillone webhook URL

To connect Strillone to your Slack webhook, you need to construct a special URL:

  1. Take your Strillone application URL (e.g., https://your-strillone-domain.com)
  2. Add /slack to it
  3. Extract the unique path from your Slack webhook URL (the part after services/)
  4. Combine them together

For example:

  • Your Strillone app is deployed at: https://my-strillone-app.herokuapp.com
  • Your Slack webhook URL is: https://hooks.slack.com/services/T12345/B67890/ABCDEFGHIJKLMNO
  • Your Strillone webhook URL will be: https://my-strillone-app.herokuapp.com/slack/T12345/B67890/ABCDEFGHIJKLMNO

Step 3: Add the webhook to DNSimple

Use this newly created URL when setting up your webhook in DNSimple:

Configuration

Strillone reads its configuration from environment variables. .env.example lists them with their defaults.

Name Type Default Description
BIND_ADDRESS String "" The address the HTTP server listens on. Empty listens on all interfaces.
PORT Int 4000 The port the HTTP server listens on. Heroku sets it.
DNSIMPLE_URL String "https://app.dnsimple.com" Dashboard link host; can be overridden per deployment.
SLACK_URL String "https://hooks.slack.com/services" Slack incoming webhook base URL.
LOG_LEVEL String "info" Log verbosity: debug, info, warn, or error.

About the name

The word strillone (literally someone who shouts a lot, in practice the equivalent of newspaper boy) comes from Italian and it refers to the newspaper sellers in the street, who were used to yell the titles in the front page to catch the attention and sell more newspapers.

Strillone

Photo: New York Media

License

Copyright (c) 2016-2024 DNSimple Corporation. This is Free Software distributed under the MIT license.

About

Listen to incoming webhooks from DNSimple, and publish them to a Slack channel or other messaging service.

Topics

Resources

Contributing

Stars

23 stars

Watchers

8 watching

Forks

Releases

Packages

Used by

Contributors

Languages