dex/examples
Yifan Gu 783fa364f6 Documentation: add serity_guide.md to show how to establish TLS.
Also add example tls-setup configs that can be used to generate
TLS CA, server certs, key files using 'cfssl'.
2015-08-29 01:42:21 -07:00
..
app examples: also print raw token in the result. 2015-08-29 01:42:21 -07:00
cli *: move original project to dex 2015-08-18 11:26:57 -07:00
emailtester *: move original project to dex 2015-08-18 11:26:57 -07:00
tls-setup Documentation: add serity_guide.md to show how to establish TLS. 2015-08-29 01:42:21 -07:00
README.md *: move original project to dex 2015-08-18 11:26:57 -07:00

Running Examples

The quickest way to start experimenting with dex is to run a single dex-worker locally, with an in-process database, and then interacting with it using the example programs in this directory.

Build Everything and Start dex-worker

This section is required for both the Example App and the Example CLI.

  1. Build everything:

    ./build
    
  2. Copy static/fixtures/connectors.json.sample

    cp static/fixtures/connectors.json.sample static/fixtures/connectors.json
    
  3. Run dex_worker in local mode.

    ./bin/dex-worker --no-db &
    

Example App

  1. Build and run example app webserver, pointing the discovery URL to local Dex, and supplying the client information from ./static/fixtures/clients.json into the flags.

    ./bin/app --client-id=XXX --client-secret=secrete --discovery=http://127.0.0.1:5556 
    
  2. Navigate browser to http://localhost:5555 and click "login" link

  3. Click "Login with Local"

  4. Enter in sample credentials from static/fixtures/connectors.json:

    user: elroy77
    password: bones
    
  5. Observe user information in example app.

Example CLI

TODO