README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# Two Factor Gateway

A set of Nextcloud two-factor providers to send authentication codes via Signal, SMS and Telegram.

[![Build Status](https://travis-ci.org/nextcloud/twofactor_gateway.svg?branch=master)](https://travis-ci.org/nextcloud/twofactor_gateway)
[![Code Coverage](https://scrutinizer-ci.com/g/nextcloud/twofactor_gateway/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/nextcloud/twofactor_gateway/?branch=master)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/nextcloud/twofactor_gateway/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/nextcloud/twofactor_gateway/?branch=master)
[![Read the Docs](https://img.shields.io/readthedocs/nextcloud-twofactor-gateway.svg)](https://nextcloud-twofactor-gateway.readthedocs.io/en/latest/)

![](https://raw.githubusercontent.com/ChristophWurst/twofactor_gateway/ae08ce30abfa866c7c7a486d850d4be07b83d82d/screenshots/challenge.png)

## Supported Messaging Gateways
This app uses external messaging gateways services for sending the code. See the 
[admin documentation]  on how to configure the specific providers.

## Login with external apps
All modern applications communicating with Nextcloud now use Login flow so you 
will be able to log in just like you would on the web, including, but not
limited to SMS-based authentication.

Absent support for the Login flow, after enabling Two Factor SMS, your legacy
applications will accept device passwords. To manage them, 
[see more here](https://docs.nextcloud.com/server/14/user_manual/session_management.html#managing-devices)

[admin documentation]: https://nextcloud-twofactor-gateway.readthedocs.io/en/latest/Admin%20Documentation/