twofactor_webauthn/README.md

1.6 KiB

WebAuthn second factor provider for Nextcloud

REUSE status

Requirements

In order to use this app for authentication, you have to use a browser that supports the WebAuthn standard.

Migration from Two-Factor U2F

It is possible to migrate U2F device registrations to WebAuthn devices registrations. For the migratation, you need command line access to run occ.

# View options – you can run this for all or only specific users
php occ twofactor_webauthn:migrate-u2f --help

# Migrate all users
php occ twofactor_webauthn:migrate-u2f --all

# Disable the U2F app
php occ app:disable twofactor_u2f

# Clean up any U2F registrations
php occ twofactorauth:cleanup u2f

Login with external apps

Once you enable WebAuthn with Two Factor WebAuthn, your applications (for example your GNOME app) will need to login using device passwords. Find out more about this in the user documentation.

Development Setup

This app uses composer and npm to manage dependencies. Use

composer install
npm install
npm run build

to set up a development version of this app.