OAuth is an open standard for authorization, commonly used as a way for Internet users to login on websites by reusing their Facebook, Linkedin or Google account. The Jahia team built several modules that you can easily use to bring social login to your website.
No code is required to use these modules and the login buttons can be added to any webpage with a simple drag and drop.
Here are 2 use cases :
Download the following modules from Jahia store, deploy them to your Jahia website and configure them accordingly using section 5: Jahia Oauth, JCR Oauth provider and Facebook connector
Download the following modules from Jahia store, deploy them to your Jahia website and configure accordingly using section 5: Jahia Oauth, JCR Oauth provider, Linkedin connector and jExperience Oauth data mapper
For more information on how to create your application, please refer to :
Configuration : https://developers.facebook.com/apps/
Documentation : https://developers.facebook.com/docs/facebook-login
Configuration : https://www.linkedin.com/developer/apps
Documentation : https://developer.linkedin.com/docs/signin-with-linkedin
Configuration : https://console.developers.google.com/apis/credentials/oauthclient
Documentation : https://support.google.com/googleapi/answer/6158849
Once you selected, installed and deployed the oauth modules you need on your Jahia website, you can find the configuration in the site settings.
The first screen will list the Oauth connectors that you added to your website.
When selecting a connector, you'll find a screen similar to the one below. Depending on the connector (Facebook or Linkedin), the options can be slightly different since they are related to the provider.
.linkedInOAuthCallbackAction.do
. For instance : http://virtuallvr.com/en/sites/virtuall/home.linkedInOAuthCallbackAction.do . There can be several callback urls.When you're done with the configuration, hit the save button.
A new "ACTIONS" button will appear as per below :
For each connector, you'll need to configure one or more "Actions". The "JCR Oauth provider" will always be here, the "jExperience Oauth data mapper" will only appear if you deploy the module on your website (only possible if jExperience is deployed as well).
The JCR OAuth provider will actually manage the login to Jahia and create a Jahia User if no user is matching the one being authenticated. You can map each attribute coming from the connector to Jahia User attributes.
When using Jahia and jExperience, we recommend to restrict the fields that you'll map in this provider since customer data will find better fit in jCustomer. However, we do recommend you to map the email address, that will be used as a login value (otherwise, a technical id will be generated).
The jExperience data mapper allows you to map each attribute coming from your connector to jExperience profile properties. You'll be able to use this data for analytics or personalization. Keep in mind that Marketing factory is based on jCustomer, and allows you to create as many profiles properties as you want, on the fly.
You'll find the social logins buttons as any Jahia component, under the group "Jahia Oauth button connector".