README.md

Casdoor Authenticator App

Casdoor Authenticator App is a mobile application for iOS and Android that provides multi-factor authentication using the TOTP protocol. This app helps secure user accounts by generating time-based one-time passwords (TOTP). The app is developed using the React Native framework.

Features

• Multi-platform support (iOS/Android)
• TOTP-based multi-factor authentication
• Account synchronization with Casdoor
• Integration with Casdoor's central service and desktop client

Quick Start

git clone git@github.com:casdoor/casdoor-app.git
cd casdoor-app
npm install && npm run start

Installation

You can download the latest version of the Casdoor Authenticator App from the GitHub Releases page.

• Android: Download and install the APK file directly on your device.

Building from Source

If you prefer to build the app yourself, follow these steps:

Common Steps

git clone git@github.com:casdoor/casdoor-app.git
cd casdoor-app
npm install

android build

npm install && npx expo prebuild --platform android
cd android && ./gradlew assembleRelease

The APK file in the app/build/outputs/apk/release/ directory.

Note: You'll need to have the necessary development environments set up for React Native, Android. Refer to the React Native documentation for detailed setup instructions.

Usage

• Open the app on your mobile device.
• Scan QR codes to add accounts and generate TOTP codes for login.
• Log in to your accounts for synchronization with Casdoor.

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.