https://github.com/nextcloud/twofactor_webauthn

WebAuthn Two-Factor Provider for Nextcloud
https://github.com/nextcloud/twofactor_webauthn

nextcloud nextcloud-app webauthn webauthn-framework

Last synced: 4 months ago
JSON representation

WebAuthn Two-Factor Provider for Nextcloud

• Host: GitHub
• URL: https://github.com/nextcloud/twofactor_webauthn
• Owner: nextcloud
• License: agpl-3.0
• Created: 2019-04-28T11:24:17.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-09-29T22:47:59.000Z (4 months ago)
• Last Synced: 2024-09-30T02:41:04.087Z (4 months ago)
• Topics: nextcloud, nextcloud-app, webauthn, webauthn-framework
• Language: PHP
• Homepage: https://apps.nextcloud.com/apps/twofactor_webauthn
• Size: 11.6 MB
• Stars: 49
• Watchers: 5
• Forks: 7
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: COPYING
  • Authors: AUTHORS.md

Awesome Lists containing this project

README

        
# WebAuthn second factor provider for Nextcloud

## 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](https://docs.nextcloud.com/server/stable/admin_manual/configuration_server/occ_command.html).

```shell

# 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](https://docs.nextcloud.com/server/stable/user_manual/en/user_2fa.html#using-client-applications-with-two-factor-authentication).

## Development Setup

This app uses [composer](https://getcomposer.org/) and [npm](https://www.npmjs.com/) to manage dependencies. Use

```bash

composer install

npm install

npm run build

```

to set up a development version of this app.