This add-on is operated by (unnamed)
Last updated 27 June 2019
This is a draft article - the text and URL may change in the future. This article is unlisted. Only those with the link can access it.
The Sentinel Trails add-on is currently in beta.
Table of Contents
Sentinel Trails provides a secure audit trail backed by blockchain technology. You can store your logs and we will guarantee they have not been tampered with. This enables you to adhere to compliance requirements (PCI-DSS, ISO 27001, GDPR, HIPAA and more) as well as prove to third parties that your logs are not modified.
Integration with Sentinel Trails is simple via its RESTful API
The full documentation is available here, including:
- White paper – a white paper explaining the rationale and basic concepts
- Getting started – Introduction to using Sentinel Trails
- Detailed API documentation – an example of using the core API endpoints
- API reference – a full list of API endpoints and their descriptions
- Libraries and plugins – lists all supported libraries and plugins
- Advanced FAQ – answers to advanced technical questions
Provisioning the add-on
Sentinel Trails can be attached to a Heroku application via the CLI:
A list of all plans available can be found here.
$ heroku addons:create sentinel-trails -----> Adding sentinel-trails to sharp-mountain-4005... done, v18 (free)
After you provision sentinel-trails, the
SENTINEL_TRAILS_APPLICATION_ID config vars are available in your app’s configuration. They contain the credentials needed to invoke the Sentinel Trails API. You can confirm this via the
heroku config:get command:
$ heroku config:get SENTINEL_TRAILS_ORGANIZATION_ID
After you provision Sentinen Trails, your application should be configured to fully integrate with the add-on.
After you provision the add-on, it’s necessary to locally replicate its config vars so your development environment can operate against the service.
Use the Heroku Local command-line tool to configure, run and manage process types specified in your app’s Procfile. Heroku Local reads configuration variables from a
.env file. To view all of your app’s config vars, type
heroku config. Use the following command for each value that you want to add to your
$ heroku config:get SENTINEL_TRAILS_ORGANIZATION_ID -s >> .env $ heroku config:get SENTINEL_TRAILS_ORGANIZATION_SECRET -s >> .env $ heroku config:get SENTINEL_TRAILS_APPLICATION_ID -s >> .env
Credentials and other sensitive configuration values should not be committed to source-control. In Git exclude the
.env file with:
echo .env >> .gitignore.
For more information, see the Heroku Local article.
Using with any programming language
Integrating Sentinel Trails is language-independent - you just use your favorite REST client to call our API. You can get started by reading our documentation
For more information on the features available within the Sentinel Trails dashboard, please see the docs at https://logsentinel.com/sentinel-trails/documentation/.
The Sentinel Trails dashboard enables you to perform a wide variety of audit-trail-related tasks, including:
- Monitor your log
- Perform advanced queries on your log data
- Verify the integrity of the log (backed by blockchain technology)
- See trends in your data
- Define fraud detection rules
You can access the dashboard via the CLI:
$ heroku addons:open sentinel-trails Opening sentinel-trails for sharp-mountain-4005
or by visiting the Heroku Dashboard and selecting the application in question. Select Sentinel Trails from the Add-ons menu.
Migrating between plans
Application owners should carefully manage the migration timing to ensure proper application function during the migration process.
heroku addons:upgrade command to migrate to a new plan.
$ heroku addons:upgrade sentinel-trails:newplan -----> Upgrading sentinel-trails:newplan to sharp-mountain-4005... done, v18 ($49/mo) Your plan has been updated to: sentinel-trails:newplan
Removing the add-on
You can remove sentinel-trails via the CLI:
This will destroy all associated data and cannot be undone!
$ heroku addons:destroy sentinel-trails -----> Removing sentinel-trails from sharp-mountain-4005... done, v20 (free)
All Sentinel Trails support and runtime issues should be submitted via one of the Heroku Support channels. Any non-support related issues or product feedback is welcome at firstname.lastname@example.org.