Customizing authentication screens in your Pega application

To customize the login screen of your authentication service, edit the source HTML in the pyDisplayAuthScreenSelector.

Before you begin: Editing the HTML of the login screen requires configuring an HTML rule. For more information about HTML rules for the user interface, see About HTML rules.

You must complete the following task before you can configure a basic authentication service: Creating an authentication service.

Before you customize pages, you must create an alternate access group and ruleset for the custom authentication screen, then apply the access group and ruleset to the pyDisplayAuthScreenSelector rule. For more information, see the following topics:

To edit the source HTML of your authentication service login page:

  1. Open the existing authentication HTML rule from the navigation panel in Dev Studio by clicking Records > Technical > HTML.
  2. In the Stream name column, click the search icon (▼).
  3. In the Search Text field, enter pyDisplayAuthScreenSelector.
  4. Click Apply.
  5. Click the row containing pyDisplayAuthScreenSelector.
  6. n the Generate For list, select whether your customized login screen uses HTML directives or JavaServer Pages (JSP) tags.
  7. In the Browser Support list, select whether Modern browsers or IE only support your customized login screen.
  8. In the Accessibility list, select to tag whether or not your customized login screens meets your accessibility requirements.
  9. In the HTML source field, enter your customized login page HTML. Observe Pega Guardrails and analyze potential security risks of the customized login page.
  10. If your customized login references clipboard pages, click the Pages and Classes tab.
  11. Enter the required clipboard pages and the classes to which they belong.
  12. Click Save.

    The customized HTML of your login page is built into your application instance of Pega-Engine.

  13. In the Actions list, select Preview.
  14. Confirm the login page reflects your customized HTML.