Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Customizing authentication screens in your Pega application

Updated on March 15, 2022

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 Editing the source HTML of your login screen.

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 RecordsTechnicalHTML.
  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.
  • Previous topic Enforcing policies from the Security Policies landing page
  • Next topic Activating your basic authentication service

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us