Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cedarcode/webauthn-rails-demo-app

Rails app demonstrating a WebAuthn password-less login
https://github.com/cedarcode/webauthn-rails-demo-app

rails ruby webauthn webauthn-demo webauthn-server

Last synced: 2 months ago
JSON representation

Rails app demonstrating a WebAuthn password-less login

Host: GitHub
URL: https://github.com/cedarcode/webauthn-rails-demo-app
Owner: cedarcode
License: apache-2.0
Created: 2018-05-22T14:33:53.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-11-08T17:15:06.000Z (2 months ago)
Last Synced: 2024-11-08T18:23:18.664Z (2 months ago)
Topics: rails, ruby, webauthn, webauthn-demo, webauthn-server
Language: Ruby
Homepage: https://webauthn.cedarcode.com
Size: 1.17 MB
Stars: 101
Watchers: 6
Forks: 41
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# WebAuthn Rails Demo App

Application demonstrating a [WebAuthn](https://en.wikipedia.org/wiki/WebAuthn) password-less login built with Ruby on Rails + [webauthn](https://github.com/cedarcode/webauthn-ruby) ruby gem.

If you want to see an implementation of WebAuthn as a second factor authenticator in a Rails application, you can check it in [webauthn-2fa-rails-demo](https://github.com/cedarcode/webauthn-2fa-rails-demo).

## Want to try it?

### Option 1 — Visit the hosted version

* Visit https://webauthn.cedarcode.com
* Try logging in with
* a username;
* a [WebAuthn compatible authenticator](https://github.com/cedarcode/webauthn-ruby#prerequisites).

### Option 2 — Run it locally

#### Prerequisites

* Ruby

#### Setup

```
$ git clone https://github.com/cedarcode/webauthn-rails-demo-app
$ cd webauthn-rails-demo-app/
$ cp .env.example .env
$ bundle install
$ bundle exec rake db:setup
```

#### Running

```
$ bundle exec rails s
```

Now you can visit http://localhost:3000 to play with the demo site.

## Development

### Gem Update Policy

#### Gemfile Version Constraints

In `Gemfile` define gem dependencies using a version contrainst of `~> MAJOR.MINOR` by default (or ~> `0.MINOR.PATCH` if
latest `MAJOR` is `0`), unless you have reasons to use something different. An example of an exception could be
`rails`, which is known to make backwards-incompatible changes in minor level updates, so in that case we use
`~> MAJOR.MINOR.PATCH`.

#### Updating

```
$ gem install bundler-audit
$ bundle audit --update
$ bundle update --conservative --group test development
$ bundle update --strict --patch
$ bundle update --strict --minor
$ bundle update --major
$ bundle outdated --groups
```