Skip to content

Password-less key recovery via multi-factor multi-party authentication

License

Notifications You must be signed in to change notification settings

LedgerProject/Anastasis

Repository files navigation

GNU Anastasis

Password-less key recovery via multi-factor multi-party authentication.

Table of contents

Documentation

Documentation about the system and for installing the Anastasis binaries can be found at https://docs.anastasis.lu/.

Upstream Repositories

The canonical repositories are as follows:

Built with

  • GCC
  • TypeScript
  • preact-cli

Software used

Directory structure

  • anastasis-$VERSION: core logic and backend
  • anastasis-gtk-$VERSION: Gtk+ graphical user interface
  • wallet-core-$VERSION: TypeScript implementation of the anastasis client (anastasis-core and anastasis-webui)
    • Other packages in wallet-core, like taler-util and taler-wallet-cli were developed before / independent of LEDGER and are used as dependencies.

Installation instructions

Installation on Debian 11

As root, run:

echo 'deb https://deb.taler.net/apt/debian/ bullseye main' > /etc/apt/sources.list/taler.list
wget -O - https://taler.net/taler-systems.gpg.key | apt-key add -
apt update
apt install anastasis-gtk

Installation on Ubuntu 20.04

Run:

sudo echo 'deb https://deb.taler.net/apt/ubuntu/ focal-fossa main' > /etc/apt/sources.list/taler.list
wget -O - https://taler.net/taler-systems.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install anastasis-gtk

Building GNU Anastasis from source

Follow the build instructions in the

  • anastasis/
  • anastasis-gtk/

subdirectories.

To build the Web UI, run:

cd wallet-core
pnpm run compile
cd packages/anastasis-webui
pnpm run build

The resulting Web application (static files) will be in build/. These files need to be served via HTTP (to serve locally, use e.g. python3 -m http.server).

Trying it out

At this point, you must claim to live in 'Demoland' to test the client software. In lieu of a social security number, you need to pick a prime number (2, 3, 5, 7, ...) to generate a unique identifier in 'Demoland'.

If you want to run your own service, anastasis-gtk contains a script src/testing/test_prepare.sh that can be used to start four Anastasis backends on localhost. In this case, you should claim to live in 'Testland' and you will need a square number (0, 1, 4, 9, 16, ...).

A publicly deployed version of the anastasis-webui runs at https://webui.anastasis.lu/

About

Password-less key recovery via multi-factor multi-party authentication

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published