Mirror of the GitHub SailOTP Repository
Go to file
seiichiro 90314355e0 Fix Empty Token List after Restart for New Installs 2023-02-26 19:11:38 +01:00
icons App icon refresh 2021-06-24 20:47:42 +02:00
qml Prepare Release 1.11.0 2023-02-20 17:03:13 +01:00
rpm Fix Empty Token List after Restart for New Installs 2023-02-26 19:11:38 +01:00
src Fix Empty Token List after Restart for New Installs 2023-02-26 19:11:38 +01:00
translations Add Error Crude Handling for Encryption/Decryption 2023-02-20 16:48:52 +01:00
.gitignore Ignore built files 2022-11-14 21:46:26 +03:00
COPYING Cleanup and Comments for publishing 2014-01-06 20:08:16 +01:00
README.md Fix Empty Token List after Restart for New Installs 2023-02-26 19:11:38 +01:00
harbour-sailotp.desktop Add Sailjail Camera permissions 2023-01-24 23:58:00 +02:00
harbour-sailotp.pro Switch File Encryption to OpenSSL 2023-02-20 16:10:57 +01:00

README.md

SailOTP

SailOTP is a Sailfish Implementation of the Google-Authenticator algorithms, also known as TOPT (timer based) and HOTP (counter based) as described in RFC 6238 and 4226. A growing number of sites uses this algorithm for two-factor-authentication, including Github, Linode and several Google services.

One can add new OTP-entries using the pulley-menu. Codes can be added using the integrated QR-Code-Reader or by manually typing in the token information.

The main view of the app will show a list off all entries and their current One-Time-Tokens. The entries will be regenerated every 30 seconds, the remaining time for the current tokens is shown through a progress bar at the top of the app. HOTP-type tokens are not updated automatically, instead a refresh button is shown on the right of the token to calculate the next value and increment the counter. An entry can be edited, deleted or moved up and down in the list by long-pressing on it.

In edit-mode one can show a QR-Code of the entry (e.g. for importing it on another device) through the pulley menu.

One entry can be stared by tapping the star icon on the left. the stared item will be shown on the ActiveCover. If the Token is timer based, it will be refreshed every 30 seconds. 5 seconds before the token changes it's color will change to red. For counter based tokens a cover action to calculate the next token is shown instead. The item can be unstared by tapping the star icon again on the main view.

From the main view a token can be copied to the clipboard by tapping on it.

From the pulley menu the token database can be exported to a file for backup purposes. The backup is a AES-256-CBC encrypted and Base64 encoded file containing a JSON-representation of the database. It can be decrypted with openssl using the following command:

openssl enc -d -a -aes-256-cbc -in

if you need the information outside of SailOTP.

Importing the file is also possible from the pulley menu. If a file contains tokens that are already in the database (title and secret of the token match an existing one), these tokens will not be added again.

It is also possible to generate tokens for SteamGuard (Steams TOTP-Variant for 2-Factor-Auth). To use this feature, one will have to activate it using the original Steam Android app. After activating it one can get the secret code from '/opt/alien/data/data/com.valvesoftware.android.steam.community/files/Steamguard-$STEAMID'. This file contains json data, including the OTP-URL in the form 'otpauth://totp/Steam:$STEAM_USERNAME?secret=$SECRET&issuer=Steam'. The code from this URL can be added manually using the 'Steam Guard'-OTP-Type in SailOTP.

Contact and Issues

If you find any bugs or want to suggest a feature, feel free to use Githubs Issues feature at https://github.com/seiichiro0185/sailotp/issues or write an email to sailfish AT seiichiro0185.org

License

SailOTP is licensed under a 3-Clause BSD-License. See COPYING for details.

Contributors

The Following people have contributed code or other improvements to SailOTP:

  • SteamGuard support: Robin Appelman
  • Search function: Jyri-Petteri Paloposki
  • Improved App Icon: JSEHV
  • Custom Time Period support: Andrey Skvortsov
  • SailJail Permissions: DrYak

Translations

The following people have contributed to translating SailOTP:

  • Brazilian Portuguese: caio2k
  • Chinese: BirdZhang
  • Finnish: Johan Heikkilä (hevanaa), Jyri-Petteri Paloposki (ZeiP)
  • French: Romain Tartière (smortex)
  • Italian: Tichy
  • Hungarian: 1Zgp
  • Russian: moorchegue
  • Spanish: p4moedo
  • Swedish: Åke Engelbrektson (eson57)
  • English: Stefan Brand (seiichiro0185)
  • German: Stefan Brand (seiichiro0185)

Acknowledgements

SailOTP uses the SHA-1 and HMAC-Implementation from

https://github.com/Caligatio/jsSHA

SailOTP also uses the AES-Implementation from

https://code.google.com/archive/p/crypto-js/

The implementation of the TOTP-algorithm was inspired by:

http://blog.tinisles.com/2011/10/google-authenticator-one-time-password-algorithm-in-javascript/

An adapted version of the QZXing-library is used for QRCode-decoding http://sourceforge.net/projects/qzxing/

The qrencode library is used for QRCode-encoding existing tokens for export to other devices. http://fukuchi.org/works/qrencode/