Skip to content
This repository has been archived by the owner. It is now read-only.
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

This project is no longer maintained.


digitalocean-callback

DigitalOcean authorization helper, built with Scotty. Intended to supply the callback URL for the authorization code flow.

Usage

Listens for HTTP GET requests. All requests are forwarded to the DigitalOcean /v1/oauth/token endpoint.

If an incoming request includes an authorization code, the helper requests an access token. If an access token is granted, the helper redirects the user to the target URL, with additional access_token and scope parameters.

On failure, the user is also redirected to the target URL, with an error parameter.

The state parameter is included both on success and on failure, if it was supplied with the authorization code request.

To help distinguish requests made to the target URL, vendor=digitalocean is always included.

Query parameter Description
access_token Access token. Included on success.
scope Space-separated list of scopes. Included on success.
error Either no_code or no_token. Included on failure.
state Arbitrary string. Optional.
vendor Always digitalocean.

Configuration

Authentication credentials and defaults can be configured by setting environment variables.

TLS is used if server.key and server.crt are found in the run-time data files directory.

Environment variable Description
DIGITALOCEAN_CLIENT_ID Application identifier. Required.
DIGITALOCEAN_CLIENT_SECRET Authentication token. Required.
CALLBACK_URL Helper’s own URL. Required.
TARGET_URL URL to which the user is redirected. Required.
PORT HTTP listening port. Defaults to 8080.

Deployment

Installs in seconds on most Linux and OS X machines, using Halcyon.

$ halcyon install https://github.com/mietek/digitalocean-callback
$ export DIGITALOCEAN_CLIENT_ID=…
$ export DIGITALOCEAN_CLIENT_SECRET=…
$ export CALLBACK_URL=…
$ export TARGET_URL=…
$ digitalocean-callback

Deploying to Heroku

Ready to deploy in one click to the Heroku web application platform, using Haskell on Heroku.

Deploy

Clicking the button is equivalent to executing the following commands:

$ git clone https://github.com/mietek/digitalocean-callback
$ cd digitalocean-callback
$ heroku create -b https://github.com/mietek/haskell-on-heroku
$ heroku config:set DIGITALOCEAN_CLIENT_ID=…
$ heroku config:set DIGITALOCEAN_CLIENT_SECRET=…
$ heroku config:set CALLBACK_URL=…
$ heroku config:set TARGET_URL=…
$ git push heroku master
$ heroku ps:scale web=1
$ heroku open

About

Made by Miëtek Bak. Published under the BSD license.

About

DigitalOcean authorization helper

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published