Zephr User Guide

Account Branded Pages

9 views 0

The Account Branded Pages section allows you to upload a logo for use on the company account management pages and configure sign-in with OpenID Connect.

For further information on creating company account management pages, see the Create a Page topic.

To complete the Account Branded Pages section, complete the following steps:

  1. Select the Pages Activate toggle

    The field expands to allow you to upload a logo, as illustrated below:

    Upload Logo

  2. Upload the logo to use in your company account management pages

    To upload a logo, 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

    A further field displays, as illustrated below:

    Access URL

  3. Enter the address used to access the related company account management pages in the Account Specific URL text box

    For example, the following illustration defines /zephr as the URL to append to your site URL to access the page:

    Pages - Account Branded Pages - Logo Upload

  4. Select the Confirm button

    All pages that you have created to be used as a template for account-branded pages are listed.

  5. Select the checkbox beside the page you want to use as a template for this account-branded page, as illustrated below:

    Pages - Selecting an Account Branded Page

  6. If you want to use OpenID Connect to add a simple identity layer on top of the OAuth 2.0 protocol, select the Federated Authentication toggle

    Further fields display, as illustrated below:

    OpenID Connect Fields

  7. Enter the OAuth 2.0 client identifier, which can be found in your OpenID Connect console, in the Client ID text box
  8. Enter the client secret, which can be found in your OpenID Connect console, in the Client Secret text box
  9. Enter the authorisation endpoint, which can be found in your OpenID Connect console, in the Authorization Endpoint text box
  10. Enter the token endpoint, which can be found in your OpenID Connect console, in the Token Endpoint text box
  11. Enter the user information endpoint, which can be found in your OpenID Connect console, in the User Info Endpoint text box
  12. If you want to associate information supplied by OpenID Connect with the user attributes stored in Zephr, map your user attributes to related OpenID Connect fields

    Note: If you map fields to user attributes, the information is used to pre-fill fields on your registration form.

    To map a user attribute to an OpenID Connect field, complete the following steps:

    1. Select the Add User Attribute and Field Name button

      The Attribute Mapping dialog box displays, as illustrated below:

      User Attribute Mapping

    2. Select the user attribute to associate with the OpenID Connect field from the User Attribute drop-down menu

      Note: You must create user attributes before you can map them to an OpenID Connect field. For further information on creating user attributes, see the Add a User Attribute topic.

    3. Enter the name of the OpenID Connect field in the Field Name text box
  13. Select the Save button to save the mapping and return to the Add Account screen. Selecting the Cancel button displays the Add Account screen without adding any mappings

For an example of creating an Account Branded Page, see the How to Create Account-branded Pages topic.