This feature is in maintenance-only mode. New customers will not have access to this feature.
Gigya offers one-time password (OTP) authentication, also known as SMS Login, as an additional login method that can be included in the Gigya login UI.
In websites with OTP, site users can enter their phone number to receive a one-time verification code to their mobile device. This code is entered in the website in order to log in or register immediately.
The benefits of this login method include:
- Secure: Strong identification.
- Convenient: No need to create or remember a username/password combination.
- Global: The service applies to users in all countries, and is particularly useful in countries where email addresses are less prevalent than mobile phones.
- User-friendly: Gigya's OTP functionality is set up as a custom third-party identity provider, through which users can log in, just like they can log in through Facebook or Twitter.
After users register to the site with their mobile device, they can be prompted to link their social network identities as additional authentication methods, providing the website with rich permission-based identity data. And conversely, if a user registering through OTP is already registered to the site through another authentication method, the OTP identity can be added to the user's existing account through Gigya's account linking functionality (see details below).
Implementation is mostly carried out by the Gigya team: all the customer has to do is add the custom OTP provider to the Gigya login UI (see Implementation section below for details).
Currently, verification codes are sent through SMS messaging only.
- SMS Login (OTP) is a premium product that requires separate activation. If you are interested in adding it to your site package, please contact your Gigya Account Manager.
- SMS Login uses SAML, which is not supported natively on iOS. To use SMS Login on iOS, use a WebView.
Watch an Instructional Video
If you have a Gigya Academy membership, you can watch instructional videos about this and other Gigya products. To access Gigya Academy content, you should first make sure you are logged into the Gigya Console.
To watch a video about SMS Login, Gigya Academy members can use this link.
Basic Login/Registration Flow
- SMS Login is offered as another button in the Gigya social login UI. The custom button is fully customizable.
- When a site user clicks the SMS Login button, the following window is displayed:
- The user selects their country, enters their phone number and clicks the Get Code button.
- If the phone number is valid, the user is sent an SMS message containing a random numeric code (by default the code is 6 digits long but this can be configured).
- The system displays the following window in which the user can enter the code. There is also an option to request a resend (see resending policies below).
- Once the user has entered the correct code:
- If the user exists in the website (has already registered using mobile authentication with this phone number), they are logged in to their account.
- If this is a new user, a new account is created.
Mobile Login/Registration Flow
The flow when logging in with OTP in a mobile browser is identical to the desktop flow.
Account Linking Flow
This optional flow allows site users who are already registered to start using OTP to log into their existing accounts.
To enable the flow, the website has to:
- Have Account Linking enabled through the Gigya console.
- Make sure the federation policy is configured properly.
- Require an email address for registration.
Codes are sent by SMS through major, highly reliable SMS gateways. The service uses multiple gateways for optimal performance. When a user reports not having received the code, the service switches to a different gateway to resend the code.
The following OTP settings can be customized for each website. Discuss your preferences with your Account Manager before implementation.
Gigya offers extensive language support in OTP imlementations. Error messages, and the actual SMS received by users, are available in the following languages:
|Chinese (Hong Kong)||zh-hk|
|Hindi (*SMS TFA Only)||hi|
|Kannada (*SMS TFA Only)||kn|
|Marathi (*SMS TFA Only)||mr|
In addition, the text and style of the OTP registration screen can be customised. For more information, see below.
Caps and Limitations
The following service caps and limitations can be configured based on the website's requirements:
- Code expiration
- How many code resends can be requested by a user
- SMS messages per IP
- Code requests per phone number
- Authentication attempts by a user (how many times they can retry entering the code)
To learn about adjusting the default settings please contact your Account Manager.
All codes are valid until their default expiration time, new codes will not invalidate any previous codes received that are still valid.
Custom HTML Style (CSS)
You can change the look and feel of the OTP screens using custom CSS.
These are the relevant HTML elements that may be involved:
Gigya's OTP offering is set up in the website as a SAML-based identity provider through which users can log in, just like they can log in through Facebook or Twitter.
The SAML setup will be carried out by your Account Manager.
The customer will only have to do the following:
1. Provide Required Details to Gigya
In order to set up your OTP implementation, your Account Manager needs the following information:
- Which site(s) you want to implement OTP in, if you have more than one site set up with a Gigya API Key
- Your desired OTP service settings, such as interface language, rate limits, etc. See the Customization Options section for the available settings. To learn about the default rate limits. please contact your Account Manager.
2. Add SMS Login Button
After the custom SAML identity provider is created, you need to edit your Gigya login UI to add a custom button for SMS Login/OTP (see customButtons).
To build the button object:
Set the idpName property to the name of the custom IDP provider created by Gigya for the purpose (ask your Gigya Account Manager for the correct name).
- Set the type property to "saml".
Set the iconURL and lastLoginIconURL properties to the default images created by Gigya or create icons of your own.
- Your login UI may include multiple custom button objects, each representing a different SAML-based identity provider.
- A user cannot be connected to more than one SAML identity provider for the life of their account. Therefore, if the user connects through OTP, they will not be able to add a connection to another SAML identity provider in the future.
Best Practice: Add Prompt for Social Identities
An optional (but recommended) function is to ask users who have registered through OTP to add another login method to their account.
This prompt should appear after registration is finished.
This has several benefits:
- Added security for the user: if their mobile device is lost or temporarily unavailable, they can use another identity to log in.
- Added value for the website: users who add a social network connection provide the website with all the rich permission-based identity data Gigya usually offers.