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 DX 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 DX website and configure accordingly using section 5: Jahia Oauth, JCR Oauth provider, Linkedin connector and Marketing Factory 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 DX 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 "Marketing Factory Oauth data mapper" will only appear if you deploy the module on your website (only possible if Marketing Factory is deployed as well).
The JCR OAuth provider will actually manage the login to Jahia DX and create a DX User if no user is matching the one being authenticated. You can map each attribute coming from the connector to DX User attributes.
When using Jahia DX and Marketing Factory, we recommend to restrict the fields that you'll map in this provider since customer data will find better fit in Unomi. 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 Marketing Factory data mapper allows you to map each attributee coming from your connector to Marketing Factory profile properties. You'll be able to use this data for analytics or personalization. Keep in mind that Marketing factory is based on Unomi, 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 DX component, under the group "Jahia Oauth button connector".