Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure account branded pages

Learn how to configure account branded pages by uploading logos and setting up OpenID Connect for seamless user authentication.

  • You have permission to manage pages and company accounts.

  • Any required user attributes are already created if you plan to use OpenID Connect attribute mapping.

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.

  1. Select the Pages Activate toggle. The field expands to allow you to upload a logo.
  2. Upload a logo for the account branded pages by doing one of the following:
    1. Drag a file into the upload area.
    2. Click Select a File to Upload, select the file, and click Open.
  3. In the Account Specific URL field, enter the URL path used to access the account management pages. For example, the define /zephr as the URL to append to your site URL to access the page.
  4. Click Confirm.
  5. Select the checkbox next to the page you want to use as the template for the account branded page.
  6. If you wish to use OpenID Connect to add a simple identity layer on top of the OAuth 2.0 protocol, select the Federated Authentication toggle.
  7. Enter the following values from your OpenID Connect configuration:
    • Client ID

    • Client Secret

    • Authorization Endpoint

    • Token Endpoint

    • User Info Endpoint

  8. (Optional) Map OpenID Connect fields to Zephr user attributes:
    Note: If you map fields to user attributes, the information is used to pre-fill fields on your registration form
    1. Click Add User Attribute and Field Name button.
    2. Select a value from the User Attribute drop-down list. 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 corresponding OpenID Connect field name.
    4. Click Save.
  9. Add a page, and select Yes for the Use this page as a template for account branded page option.
  10. Activate the pages in the Account Branded Pages section when adding or editing your company account. When a user navigates to the company account-specific page URL, for example /zephr/corporate-accounts, the branded page displays, as shown:Branded Company Account Page Example
  11. If required, allow users to sign in without entering information that has already been supplied by using federated authentication through OpenID Connect. Once set up, users can select the Continue with Open ID Connect button to select an account to use when registering on your site. The accounts that can be selected are based on the authentication configured in OpenID Connect. For example, when registering for an account. After this screen, a further screen displays to request further registration information. Any information retrieved from OpenID Connect, using the mapping of fields to Zephr user attributes, is pre-filled. When the user selects the Complete Registration button, they are added as a user in Zephr and in the relevant company account.
    Note: If all information can be mapped from OpenID Connect fields to the form fields, the screen requesting further information is not displayed and the user is automatically registered.