Editing the source HTML of your login screen
Your Pega application uses several rules that form the source markup HTML and CSS of your login screens. To customize these login screens, you can add your own HTML structure, CSS elements, or background images to the source fields in each of their respective HTML and Text rules.
If you want to edit the source HTML of your login screens, open the HTML rules your Pega application uses, then edit the source HTML. HTML rules containing your login screen source HTML include the following items:| Rule name | Description |
| Web-Login | HTML rule used for the login screen for an unauthenticated
operator session. Used by the /prWeb/
servlet. Prompts users for login ID and password. |
| Web-Login-LDAPAuth | HTML rule used for the LDAP login screen for an unauthenticated operator session. Prompts user for LDAP login ID and passwords. |
| pyDisplayAuthScreenSelector | HTML rule used for an authentication screen for an
unauthenticated operator session. Used by the
/PRAuth/ servlet. Requests users for an
identity provider (IDP) for single sign-on. If users select a
third-party IDP on this screen (such as Google), the user
redirects to an IDP login screen not managed by Pega. Prompts
users for login ID, password, and single sign-on
credentials. |
| pyForgotPassword | HTML rule used for the session Forgot Password screen. |
In the navigation pane in Dev Studio, open the existing HTML rule by clicking .
In the Stream name column, click the Search icon.
In the Search Text field, enter the rule name of the login screen that you want to edit.
Click Apply.
Click the resulting row. Pega Platform displays the HTML rule form.
In the Generate For list, select whether your customized login screen uses HTML directives or JavaServer screen (JSP) tags.
In the Browser Support list, select whether Modern browsers or Microsoft Internet Explorer only (IE only) support your customized login screen.
In the Accessibility list, tag whether your customized login screens meet your requirements when calculating the application Accessibility compliance report. For more about Accessibility compliance reports, see Using the Accessibility report.
In the HTML source field, enter your customized login screen HTML.
- Optional:
If your customized login references to clipboard pages, click the Pages and Classes tab.
- Optional:
Enter the required clipboard pages and the classes to which they belong.
- Optional:
Click Save. The customized HTML of your login screen is built into your application instance of Pega-Engine.
Click Check-in to add changes to the unauthenticated ruleset you created.
In the Actions list, select Preview.
Confirm that the login screen reflects your customized HTML.
If you want to add a new background image to your login screens, see Adding a new background image to your login screen.
- unauthenticated ruleset
After you create an authentication service, you must associate a Browser requestor and Pega application with an unauthenticated Access Group and ruleset to synchronize customizations of your login screens with your application.
- Editing the source HTML of your login screen
Your Pega application uses several rules that form the source markup HTML and CSS of your login screens. To customize these login screens, you can add your own HTML structure, CSS elements, or background images to the source fields in each of their respective HTML and Text rules.
- Customizing login screens for your Pega application
Your Pega application uses several rules that correspond to each screen accessed by unauthenticated operators (users who have not logged in). Pega Express allows you to customize these screensincluding the login screen, authentication screen, logout screen, and other screensthrough their source HTML and custom cascading style sheets (CSS).
Previous topic Configuring a Browser requestor Next topic Adding a new background image to your login screen