Zephr User Guide

Configure Third-party Authentication

76 views 0

You can configure the authorisation settings when using a third-party sign on. This uses OAuth 2.0 to log in to third-party applications using the Zephr login information. For further information on the OAuth 2.0 Authorization Code Grant, refer to the OAuth 2.0 Authorization Framework documentation.

To configure the authorisation settings, complete the following steps:

  1. Select the Third Party Authentication button in the Add a Site screen

    The Third Party Authentication Settings screen displays, as illustrated below:

    Third Party Authentication

  2. Select the Enable Oath 2.0 toggle to access data without sharing credentials
  3. Select the Add Allowed Origin button to define origins that can use the third-party authentication settings

    A text box displays, as illustrated below:

    Add Allowed Origin

  4. Enter the base URL in the text box

    The base URL calls the OAuth 2.0 Authorization Server. For example, if the end user is logging in using Zephr credentials from Google, you could use an origin of https://www.google.com/login.

    You can add further origins by repeating steps 3 and 4.

  5. Select the Add redirect URIs button to add a redirect Uniform Resource Identifier (URI)

    A text box displays, as illustrated below:

    Add Redirect URIs

  6. Enter the URI in the text box

    This defines the URL to which the end user is redirected when authorization has been granted, or an error occurs.

    You can add further URIs by repeating steps 5 and 6.

  7. Upload a logo. To do this, you can either drag a file to the drop box, or take the following steps:
    1. Select the Select a File to Upload button
    2. Navigate to your file
    3. Select your file
    4. Select the Open button
  8. Specify a title for the login page. To do this, enter the title you want to use on the login page in the Login Page Title text box
  9. Specify a title for the consent page. To do this, enter the title you want to use on the consent page in the Consent Page Title text box
  10. Define the placeholder for the identifier. To do this, enter the placeholder you want to use in the Identifier Placeholder text box
  11. Select a background colour for your page. You can select a colour in any combination of the following:
    • Select an area in the colour box
    • Select the eyedropper icon to choose a colour used anywhere in your screen
    • Select the colour from the colour bar
    • Enter the red, blue and green colour values in the R, G and B text boxes
    • Select the arrows beside the RGB text boxes to use hue, saturation and lightness colour values. Enter the values in the H, S and L text boxes
    • Select the arrows beside the HSL text boxes to use a hex colour value. Enter the hex value in the text box
  12. Select the Done button to return to the Add a Site screen

An example of using third-party authentication on your pages is given in the Example Authentication Pages topic.