Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/nextcloud/twofactor_totp

🔑 Second factor TOTP (RFC 6238) provider for Nextcloud
https://github.com/nextcloud/twofactor_totp

2fa otp rfc-6238 security totp two-factor two-factor-authentication

Last synced: about 2 months ago
JSON representation

🔑 Second factor TOTP (RFC 6238) provider for Nextcloud

Host: GitHub
URL: https://github.com/nextcloud/twofactor_totp
Owner: nextcloud
License: agpl-3.0
Created: 2016-06-04T11:17:10.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-07-31T14:35:22.000Z (about 2 months ago)
Last Synced: 2024-07-31T18:04:40.902Z (about 2 months ago)
Topics: 2fa, otp, rfc-6238, security, totp, two-factor, two-factor-authentication
Language: JavaScript
Homepage: https://apps.nextcloud.com/apps/twofactor_totp
Size: 27.8 MB
Stars: 283
Watchers: 12
Forks: 57
Open Issues: 45
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING
- Codeowners: .github/CODEOWNERS
- Authors: AUTHORS.md

Awesome Lists containing this project

README

        # Two Factor Totp

![Downloads](https://img.shields.io/github/downloads/nextcloud/twofactor_totp/total.svg)

[![Build Status](https://travis-ci.org/nextcloud/twofactor_totp.svg?branch=master)](https://travis-ci.org/nextcloud/twofactor_totp)

[![Sauce Test Status](https://saucelabs.com/browser-matrix/nextcloud-totp.svg)](https://saucelabs.com/u/nextcloud-totp)

Tested with the following apps:

* [Aegis](https://github.com/beemdevelopment/Aegis) (open source) Available via [F-Droid](https://f-droid.org/en/packages/com.beemdevelopment.aegis/) and [Google Play](https://play.google.com/store/apps/details?id=com.beemdevelopment.aegis). It features a built-in QR-code reader.

* [FreeOTPPlus](https://github.com/helloworld1/FreeOTPPlus/) (open source) Availabe via [F-droid](https://f-droid.org/packages/org.liberty.android.freeotpplus/) and [Google Play](https://play.google.com/store/apps/details?id=org.liberty.android.freeotpplus).

* [OTP Authenticator](https://github.com/0xbb/otp-authenticator) (open source) Availabe via [F-Droid](https://f-droid.org/en/packages/net.bierbaumer.otp_authenticator/) and [Google Play](https://play.google.com/store/apps/details?id=net.bierbaumer.otp_authenticator). It features a built-in QR-code reader.

* [Google Authenticator](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2) (proprietary)

* [KeePassXC (Linux, Windows, macOS)](https://keepassxc.org/) (open-source) Available via [download](https://keepassxc.org/download/), package repositories or [GitHub](http://www.github.com/keepassxreboot/keepassxc/) (Keepass also provides a plugin and Keepass2Android allows to use TOTP token)

* [SailOTP (SailfishOS)](https://github.com/seiichiro0185/sailotp) (open source) Available via JollaStore or [Openrepos.net](https://openrepos.net/content/seiichiro0185/sailotp)

* [OTP Auth](https://cooperrs.de/otpauth.html) (proprietary) Availabe via [Apple's App Store](https://itunes.apple.com/us/app/otp-auth/id659877384)

* [Authy (Twilio Authy)](https://authy.com/) (proprietary) for Android and IOS. Availabe via [Google Play](https://play.google.com/store/apps/details?id=com.authy.authy) and [Apple's App Store](https://apps.apple.com/de/app/twilio-authy/id494168017)

Tested with the following hardware devices:

* [Nitrokey Pro](https://shop.nitrokey.com/shop/product/nitrokey-pro-2-3)

* [Nitrokey Storage](https://shop.nitrokey.com/shop)

## Installation

### Nextcloud 25 and newer

The app is [shipped](https://docs.nextcloud.com/server/latest/developer_manual/app_publishing_maintenance/release_process.html#shipped-apps) and comes with the installation of Nextcloud Server. No additional steps are necessary.

### Nextcloud 24 and older

The app is available through the [app store](https://apps.nextcloud.com/apps/twofactor_totp). It can be [installed through Nextcloud's app management UI](https://docs.nextcloud.com/server/latest/admin_manual/apps_management.html#managing-apps).

## Enabling TOTP 2FA for your account

![](screenshots/enter_challenge.png)

![](screenshots/settings.png)

## Login with external apps

Once you enable OTP with Two Factor Totp, your aplications (for example your Android app or your GNOME app) will need to login using device passwords. To manage it, [know more here](https://docs.nextcloud.com/server/stable/user_manual/en/session_management.html#managing-devices)

## Development setup

* `composer i`

* `npm ci`

* `npm run build` or `npm run dev` [more info](https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/npm.html)