README.md

Passwordless in Python using py_webauthn

Note: this demo is based on another demo by duo labs. Blog post.

Required software (and others) for running locally

• Python 3.11+
• Windows only: Microsoft Build Tools for Visual Studio 2022
  • Or MinGW (for building the CFFI dependency)
• Unix based systems only: any C compiler
  • macOS: Xcode
    • Easy way, just execute: xcode-select --install
  • Linux distros: GCC
    • Debian/Ubuntu: sudo apt install build-essential
    • Fedora: sudo dnf install @development-tools
    • Arch: sudo pacman -S base-devel
    • Alpine: sudo apk add build-base

Optional

• Docker (for running the Dockerfile)
• A Google Account in the case of running with Google colaboratory.

Getting Started running locally

In this directory, run the following commands:

1. Generate a new venv (Virtual environment):

   Unix:

   python3 -m venv venv

   Windows:

   py -m venv .venv

2. Activate the venv:

   Unix:

   source venv/bin/activate

   Windows:

   venv\bin\Activate.bat

3. Install the dependencies:

   pip install -r requirements.txt

4. Run the server:

   Unix:

   ./start-server.sh

   Windows:

   .\start-server.ps1

Running with Docker

1. Build the image:

   docker build -t passwordless .

2. Run the container:

    docker run -p 5000:5000 passwordless

Running on Google Colab

Go ahead and try it out on Google Colab by clicking the badge below:

Make sure you have an active Google Account for this.

Google Colab is a free Jupyter notebook environment that requires no setup and runs entirely in the cloud. It also allows you to run a local server with a proxy and a public URL to access it.

You can modify source code directly in the browser and run it in the cloud.