dexy

Dexy

Introduction

Dexy is a simple command line tool to do 3LO authentication with an external provider and give a token back.

Installation

Linux

wget https://github.com/Chronojam/dexy/releases/download/v1.0.0/linux-amd64 -O dexy && sudo mv dexy /usr/local/bin/dexy

MacOSX

wget https://github.com/Chronojam/dexy/releases/download/v1.0.0/darwin-amd64 -O dexy && sudo mv dexy /usr/local/bin/dexy

Windows

Grab the windows binary from the release page and give it a .exe extension

Usage

Dexy works on client_id/client_secret pairs. As such you'll need to generate one and authorize it with your provider. In dex this might look like this:

staticClients:
- id: dexy
  secret: dexy-secret
  name: 'Dexy'
  redirectURIs:
  # This needs to be a local address, as dexy will start a webserver
  # for you to callback too, it will need to match the host/port in the dexy config
  - 'http://localhost.com:10000/oauth2/callback'`

Dexy also has its own configuration file, which it will search for in the following locations:

$HOME/.dexy.yaml
./.dexy.yaml
/etc/.dexy.yaml

auth:
  dex_host: "https://dex.mycompany.com"
  callback_host: "localhost"
  callback_port: 10111
  # This will generate a callbackurl like http://localhost:10111/oauth2/callback
  client_id: "dexy"
  client_secret: "dexy-secret"

It can only support a single provider at a time, if you need to change providers, you can delete the dexy token file in ~/.dexy-token.yaml

Building

Pretty self explainatory but

make test
make build

Will drop the compiled binaries under .build/

Contributing

All PR's are welcome, just open one aganist master