Zephr User Guide

Login Providers

18 views 0

In many cases, our customers want their end-users to be able to register and log in using Social Sign-In. Zephr enables this functionality through our Login Providers feature.

Our Login Providers feature allows Zephr Admin Users to add access links to a range of OAuth 2.0 Social Sign On providers on both a global and site-specific basis.

At present, this can be set up for Facebook, Google, LinkedIn, Apple, Microsoft and Twitter.

Once configured, it can be used within Zephr’s out-of-the-box Registration Forms and Pages for easy registration and login.

Setting up a Login Provider is done in a series of stages. First, a Login Provider is created at a global level. During this set-up, you can choose to have this Login Provider be automatically assigned to all new Sites you add.

Post set up of a global Login Provider, you will need to navigate to the Login Provider settings for your pre-existing sites, to set relevant Login Providers for each.

Following this, you will be able to use these Login Providers across your registration and login forms.

Global Login Providers

To create a global Login Provider, navigate to Settings > Login Providers.

Here you’ll find a list of all your current global Login Providers. To a new option, click Add a Login Provider.

Give your Login Provider a Name, and then select the Type of provider that it is.

Once you have a Type selected, a tickbox will appear allowing you to use this Login Provider as the default account for all new sites. By selecting this, every new site added to Zephr will, by default, have these settings assigned for use on any registration and login forms or pages, provided you have selected the social sign on option.

These settings can be altered in the site settings at a later point.

Next, you will need to add the relevant client credentials for the Login Provider you have selected.

Login Providers - Global Login Provider Settings

The process for getting these values varies between providers but is well documented, and can be found with the following links:

Complete the details for the platform you wish to configure, then click Save.

Once complete, you can then repeat this process for all other providers.

You will be able to create as many Login Providers of the same Type as you wish – for example, linking a different Facebook Login Provider for each of your Sites – however, you will only be able to have one Facebook provider per Site.

To edit or delete a Login Provider, simply select it from the list and make the relevant changes, or click Delete This Provider. If you are editing the details, be sure to click Save.

Note: Global Login Providers will not be set for pre-existing Sites. To manage the Login Providers for these sites, follow the details below.

Site-Specific Login Providers

To set up a site-specific Login Provider, navigate to Delivery > Sites and then click on the Site you wish to configure.

Scroll to the bottom of the page and select Login Providers. Here you will see a list of the Login Providers you have added for a particular site.

To add a new Login Provider, click Add Login Provider, then select an option from the list of global Login Providers you have added.

Once complete, click Done, then click Save to save your Site settings.

Using Login Providers on a Form or Page

Once you have set the relevant Login Providers for each of your sites, you can enable social sign on for your forms or pages.

Login Providers Within a From

To add or edit your Login Providers within a form, start by creating a new registration form within a rule, or editing an existing one.

Within the component settings, you’ll find a section called Login Providers, above the Your Form fields. Tick the relevant Login Providers you would like to have available on the form, then click Save.

Login Providers - Form Input

Remember to save the component, outcome, and rule.

Login Providers Within a Page

To add or edit your Login Providers within a page, start by creating a new page under Delivery > Pages, or edit an existing one.

When the form first loads, add or edit the Title, Page Type, URLs and template settings as required, then click Continue.

On the next page, select Login Provider Configuration. In this section, select the Login Providers you wish to use, then click Done. Complete any other changes you wish to make, then click Save.