LinkedIn
Copied!

Table of Contents

Configuring the browser requestor

Version:

Only available versions of this content are shown in the dropdown
Applicable to Theme Cosmos applications

By associating a browser requestor and your application with an unauthenticated access group and ruleset, you enable customization of your login screens. When you define an unauthenticated access group in the browser requestor form, you give unauthenticated users access to the login screens of your application.

Configure an authentication service. For more information, see Creating an authentication service.
  1. Create an access group with roles for unauthenticated users:

    1. In the navigation pane of Dev Studio, click Records Security Access Group .

    2. In the Access Group Name column, click the Filter icon.

    3. In the Search Text field, enter PRPC:Unauthenticated.

    4. Click the resulting row.

    5. In the rule form header, in the list next to the Save button, click Save As.

    6. On the Save Access Group As form, enter a short description and a name for the access group, for example Unauthenticated.

    7. Click Create and Open.

    8. In the Application section of the Access Group rule form, enter the Name and Version of the application that you want to customize.

    9. In the Available portals section, select the portal for which you want to customize the login screen HTML and CSS.

    10. Click Save.

  2. Create an application ruleset to hold the additional rules available for unauthenticated users:

    1. In the header of Dev Studio, click Create SysAdmin RuleSet .

    2. On the Create Ruleset Version form, enter the following information:

      • A ruleset name. Include a hyphen (-) and unauthenticated after the ruleset name, for example: <MyCorpSplash>-unauthenticated
      • The ruleset version, for example: 01-01-01
      • A description for the ruleset.
      For security reasons, do not use an existing ruleset that contains other parts of your application to hold the additional rules for unauthenticated users.
    3. Note the unauthenticated ruleset name and version for future use.

    4. Click Create and open, and then click Save.

  3. Add the unauthenticated ruleset that you created in step 2 to the unauthenticated access group instance that you created in step 1:

    1. In the navigation pane of Dev Studio, click Records Security Access Group .

    2. On the Access Group tab, select your unauthenticated access group by clicking the access group name.

    3. On the Advanced tab of the selected access group form, in the Run time configuration section, in the Production Rulesets setting, add the ruleset that you created.

    4. Click Save.

  4. Add the unauthenticated ruleset that contains the unauthenticated access group to your application:

    1. In the header of Dev Studio, select Configure Application Structure Ruleset Stack.

    2. Select the application for which you want to edit the web login HTML and CSS by clicking the application name.

    3. On the Definition tab of the application, click Add ruleset.

    4. Add the unauthenticated ruleset that you created to associate with the browser requestor.

    5. Click Save.

  5. Update the browser requestor type to use the unauthenticated access group:

    1. In the header of Dev Studio, select Configure System General Requestors .

    2. In the Requestors list, select the browser requestor type that is associated with the system that you created.

    3. In the Access Group Name field, enter the access group that you created.

    4. Click Save.

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.