Strillone

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

Usage

Deploy the application

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

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:

• Slack

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:

• Either through the DNSimple dashboard
• Or via the DNSimple API

Configuration

Name	Type	Default	Description
DNSIMPLE_URL	String	"https://dnsimple.com"
WEB_SERVER_HOST	String	"0.0.0.0"	The HTTP host the service binds to.
WEB_SERVER_PORT	String	"4000"	The HTTP port the service listens on.

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.

Photo: New York Media

License

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