Gigya provides a variety of integration options for adding third party login to your site. To get you started quickly, we have described the easiest option below.
How it Works
The most straightforward way to add third party login to your site is to place Gigya's Login plugin alongside your current registration/sign-in UI. Our plugin simply presents the social networks' logos. When a user clicks on one of the logos, we then prompt that person to sign in to that provider and approve the connection with your site. Once the user connects, you can retrieve the social network user ID. You can use the ID as an identifier to either create a new account in your database or, if the user connects again and the ID exists in your database, sign the user into your site.
Run the Example:
The Example Code:
Step 1 - Add the Gigya Login Plugin to Your Sign-up and Sign-in Pages
The code example above demonstrates the two essential pieces of code that you should add to your sign-up and sign-in pages.
Add lines 3-5 to the section of your web-page
This code includes loading Gigya's Web SDK with an API key.
Add lines 8-14 to the <body> section of your web-page
This code defines a <div> section and presents the Gigya Login plugin in it.
redirectURL parameter in the code above (line 13) to the URL on your website that will handle the login response.
Note: We strongly advise providing a secure https URL.
Step 2 - Handle Login Response
Upon a successful authentication of the user, Gigya will return the User object from the Social Network. You can pull various data from this object, such as the User ID and other fields, depending upon your permissions with the social network, available within the User object, as well as the UID. Use the UID to sign-in or register the user in your database.
The following code shows how we implement this on the Success page you will redirect to by using the above example.
When implementing the Login response page, please do the following:
- To avoid fraud, we recommend verifying the authenticity of the signature received from Gigya.
- Check whether the user is new to your site. To do that, retrieve the UID parameter from the URL (see the URL string above) and look up the UID in your database.
- If the UID already exists in your user management system, identify the user and complete her sign-in process.
- If the UID is new, you should register the new user. From the URL parameters that you receive from Gigya, you can use the information that is relevant to your site in your registration process and store the new user in your database.
We have reviewed the basic steps needed to implement Gigya's social login.
We recommend that you also take a look at the various features we offer for social login, like account linking and connection with multiple providers.
To learn how to implement the social login best practice, please read the Best Practice Implementation page.