Skip to content

Latest commit

 

History

History
executable file
·
74 lines (51 loc) · 2.27 KB

README.md

File metadata and controls

executable file
·
74 lines (51 loc) · 2.27 KB

debauthn

A WebAuthn Authenticator Debugging Tool

GitHub Docker Cloud Automated build Docker Pulls Docker Cloud Build Status GitHub last commit GitHub last commit

Prerequisites

  • A MongoDB server: a docker instance or mongod.
  • A TLS setup. All requests need to use TLS (HTTPS).
  • NodeJS (v10 or v12 recommended).

Start

There is a deployment script that helps with all steps. Run ./deploy.sh --help for more information. A MongoDB should be running (check the configuration files at src/config).

Then run:

./deploy.sh --all

Docker deployment

Local build

This deployment would deploy with docker-compose the MongoDB and DebAuthn. First, review the configuration at docker-compose.yml. Then, run:

./deploy.sh --docker

Public build

You can also use the built image available at Docker Hub. For deplying, use this docker-compose.yml instead.

git clone https://gist.github.com/c76bd20a336782b5c9343bb4456703d0.git
cd c76bd20a336782b5c9343bb4456703d0/
docker-compose up -d

Setting up TLS

In production, it is recommended to use a server like NGINX with TLS that forwards the petitions to DebAuthn.

For development purposes, you can generate self-signed TLS certificates:

mkdir tls
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout tls/private.key -out tls/certificate.crt

Also set TLS=true as an environment variable when running the project.

Dependencies: adding functionality

Apply patches to the dependencies for adding functionality:

npm run postinstall