|Initial release||September 20, 2010|
|Operating system||Android, iOS, BlackBerry OS|
|License||Proprietary freeware (earlier versions were under Apache License 2.0)|
Google Authenticator is a software-based authenticator by Google that implements two-step verification services using the Time-based One-time Password Algorithm (TOTP; specified in RFC 6238) and HMAC-based One-time Password algorithm (HOTP; specified in RFC 4226), for authenticating users of mobile applications.
When logging into a site supporting Authenticator (including Google services) or using Authenticator-supporting third-party applications such as password managers or file hosting services, Authenticator generates a six- to eight-digit one-time password which users must enter in addition to their usual login details.
Typical use case
To use Authenticator, the app is first installed on a smartphone. It must be set up for each site with which it is to be used: the site provides a shared secret key to the user over a secure channel, to be stored in the Authenticator app. This secret key will be used for all future logins to the site.
To log into a site or service that uses two-factor authentication and supports Authenticator, the user provides username and password to the site, which computes (but does not display) the required six-digit one-time password and asks the user to enter it. The user runs the Authenticator app, which independently computes and displays the same password, which the user types in, authenticating their identity.
With this kind of two-factor authentication, mere knowledge of username and password is not sufficient to break into a user's account; the attacker also needs knowledge of the shared secret key, or physical access to the device running the Authenticator app. An alternative route of attack is a man-in-the-middle attack: if the computer used for the login process is compromised by a trojan, then username, password and one-time password can be captured by the trojan, which can then initiate its own login session to the site or monitor and modify the communication between user and site.
The service provider generates an 80-bit secret key for each user (whereas RFC 4226 §4 requires 128 bits and recommends 160 bits). This is provided as a 16, 26 or 32 character base32 string or as a QR code. The client creates an HMAC-SHA1 using this secret key. The message that is HMAC-ed can be:
- the number of 30-second periods since the Unix epoch (TOTP); or
- the counter that is incremented with each new code (HOTP).
A portion of the HMAC is extracted and converted to a six-digit code.
Pseudocode for one-time password (OTP)
function GoogleAuthenticatorCode(string secret) is message := floor(current Unix time / 30) hash := HMAC-SHA1(secret, message) offset := last nibble of hash truncatedHash := hash[offset..offset+3] // 4 bytes starting at the offset Set the first bit of truncatedHash to zero // remove the most significant bit code := truncatedHash mod 1000000 pad code with 0 from the left until length of code is 6 return code
Google Authenticator uses default parameters which are weaker than the suggestions in RFC 6238. Such defaults can be reasonably exploited, as demonstrated in Hashcat's TOTP cracking engine. For this reason, operators using Google Authenticator should take care with the secrets being used.
Other authentication software
The Google Authenticator app for Android was originally open source, but later became proprietary. Google made earlier source for their Authenticator app available on its GitHub repository; the associated development page states:
"This open source project allows you to download the code that powered version 2.21 of the application. Subsequent versions contain Google-specific workflows that are not part of the project."
Following Google Authenticator ceasing to be open source, a free-software clone named FreeOTP was created, predominantly a fresh rewrite but including some code from the original. Google provides Android, BlackBerry, and iOS versions of Authenticator.
Several other versions of authentication software are available. Those that use TOTP and HMAC in addition to other two-factor authentication can authenticate with the same sites and processes as Google Authenticator. Some of the listed software is available in versions for several platforms.
- Windows Phone 7.5/8/8.1/10: Microsoft Authenticator, Virtual TokenFactor
- Windows Mobile: Google Authenticator for Windows Mobile
- Java CLI: Authenticator.jar
- Java GUI: JAuth, FXAuth
- J2ME: gauthj2me, lwuitgauthj2me, Mobile-OTP (Chinese only), totp-me
- Palm OS: gauthj2me
- Python: onetimepass pyotp
- PHP: GoogleAuthenticator.php
- Ruby: rotp, twofu
- Rails: active_model_otp
- webOS: GAuth
- Windows: gauth4win, MOS Authenticator, WinAuth
- .NET: TwoStepsAuthenticator
- Multi-platform: SAASPASS Authenticator
- HTML5: html5-google-authenticator
- MeeGo/Harmattan (Nokia N9): GAuth
- Sailfish OS: SGAuth, SailOTP
- Apache: Google Authenticator Apache Module
- PAM: Google Pluggable Authentication Module, oauth-pam
- Backend: LinOTP (Management Backend implemented in python)
- Browser extension: Authenticator
- Multi-platform: Twilio Authy
- Multi-platform: Duo Mobile
- Android, Apple iOS, and iPadOS: IBM Verify
- Apple iOS and iPadOS (with z/OS): IBM TouchToken
- OTP Auth
- "Google Is Making Your Account Vastly More Secure With Two-Step Authentication - TechCrunch". TechCrunch. 2010-09-20. Retrieved 2016-03-12.
- "GitHub - google/google-authenticator: Open source version of Google Authenticator (except the Android app)". GitHub.
- Willis, Nathan (22 January 2014)."FreeOTP multi-factor authentication". LWN.net. Retrieved 10 August 2015.
- "RFC 4226 - HOTP: An HMAC-Based One-Time Password Algorithm". Tools.ietf.org. 2005-02-15. Retrieved 2019-03-25.
- "Attacking Google Authenticator". unix-ninja.
- "google-authenticator - Two-step verification - Google Project Hosting".
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2 A
- "Google Authenticator". App Store.
- "Authenticator". 4 April 2013.
- "Virtual TokenFactor". 26 February 2012.
- "[APP]Google Authenticator for Windows Mobile". XDA Developers.
- "http://blog dot jamesdotcuff dot net". Archived from the original on 2014-08-01. Retrieved 2012-01-19.
- "mclamp/JAuth". GitHub.
- "kamenitxan/FXAuth". GitHub.
- "gauthj2me - Google Authentification in Java Mobile, j2me - Google Project Hosting".
- "lwuitgauthj2me - Google Authenticator for J2ME phones - Google Project Hosting".
- "chunlinyao / mobile-otp — Bitbucket".
- "totp-me - TOTP for Java ME - Google authenticator".
- "gauth.prc - gauthj2me - Google Authenticator for Palm OS (converted from java) - Google Authentification in Java Mobile, j2me - Google Project Hosting".
- "tadeck/onetimepass". GitHub.
- "pyotp/pyotp". GitHub.
- "chregu/GoogleAuthenticator.php". GitHub.
- "rotp - RubyGems.org - your community gem host".
- "ukazap/twofu". GitHub.
- "heapsource/active_model_otp". GitHub.
- "gauth4win - Google Authenticator for windows - Google Project Hosting".
- "MOS Authenticator Home".
- "winauth - Windows Authenticator for Battle.net / World of Warcraft / Guild Wars 2 / Glyph / WildStar / Google / Bitcoin - Google Project Hosting".
- "glacasa/TwoStepsAuthenticator". GitHub.
- "gbraad/html5-google-authenticator". GitHub.
- Techtransit. "Nokia Store: Download GAuth and many other games, wallpaper, ringtones and mobile apps on your Nokia phone".
- "google-authenticator-apache-module - Apache Module for Two-Factor Authentication via Google Authenticator - Google Project Hosting".
- "oauth-pam - PAM for use with OAuth Websites - Google Project Hosting".
- "Authenticator-Extension/Authenticator". GitHub.
- "Authy". App Store.
- "Duo Mobile". App Store.
- "IBM Verify User Guide".
- "IBM TouchToken". App Store.
- "OTP Auth". App Store.
- Google Authenticator on Google Help
- Google Authenticator (Android) and Google Authenticator (other) legacy source code on GitHub
- Google Authenticator PAM module source code on GitHub
- Google Authenticator implementation in Python on Stack Overflow
- Authenticator on F-Droid
- Django-MFA Implementation Using Google Authenticator - Django-mfa is a simple package to add extra layer of security to your django web application. It gives web app a randomly changing password as an extra protection.
- Source code of version 1.02 on GitHub