Development Setup

Setup your Picnic Auth dev instance.

  1. Initial Setup
  2. Running the Server
  3. Testing

Initial Setup

Start by cloning the repository:

# ssh
$ git clone git@github.com:simonneutert/picnic-auth.git
# https
https://github.com/simonneutert/picnic-auth.git

Running the Server

Optional If you manage your .env file, then copy the .env.example file to .env:

$ cp .env.example .env

And replace the values with your own. There are helping comments in the .env.example/.env file.

Finally, run the server:

When the .env file is present:

$ deno run -A server.ts

Else, generate a random JWT secret on the fly:

$ PICNIC_JWT_SECRET="$(openssl rand -hex 64)" deno run -A server.ts

More about deno run/serve.

Testing

Test with httpie:

# httpie example for default project settings:
$ http POST ":8080/auth" username=picnic password=mypicnic

Copy the token value from the response (replace JWT-TOKEN with it) and test against the protected route:

$ http -A Bearer -a 'JWT-TOKEN' POST ":8000/auth/bearer"

Voilà! You have a working Picnic Auth instance.