Skip to main content

Table of Contents

Customizing authentication screens in your Pega application


Only available versions of this content are shown in the dropdown

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

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.

Related Content


Customizing the login screen
Did you find this content helpful?

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us