Advanced functionality for custom pages

You can enhance custom pages that you develop by incorporating advanced functionality in them. For example, you might want to use Forms or Windows authentication methods in your custom pages.

Custom authentication

You can configure applications that contain custom pages to use their own authentication systems. With custom authentication, you can create Relativity applications that use specialized access to application components. Relativity supports Forms Authentication or Windows Authentication methods.

Use the following steps when incorporating these authentication methods in your custom pages:

Note: Applications with custom pages can use Forms or Windows Authentication methods. They can also run in Anonymous mode.

Manually enable Forms or Windows Authentication in IIS

  1. Locate the IIS application for your custom pages current deployment. See Find a custom page's physical deployment, for more information.
  2. Disable Anonymous authentication and enable your chosen authentication method (Forms or Windows) via IIS.
  3. Note: manual configuration will need to done each time your custom page is redeployed due to your application or relativity upgrading.

Enable Forms or Windows Authentication via your custom page's web.config

    Note: IIS must be configured to allow applications to change their own authentication methods.

  1. Navigate to Feature Delegation at the root of the IIS server and set Authentication - Anonymous, Authentication - Windows, and/or Authentication - Forms to Read/Write.
  1. Insert the following sections into your Custom Page's web.config as desired:
    • To disable anonymous authentication:
    • Copy
      <system.webServer>
          <security>
              <authentication>
                  <anonymousAuthentication enabled="false" />
              </authentication>
          </security>
      </system.webServer>
    • To enable Forms authentication:
    • Copy
      <system.web>
          <authentication mode="Forms" />
      </system.web>
    • To enable Windows Authentication:
    • Copy
      <system.web>
          <authentication mode="Windows" />
      </system.web>
  2. Values set via your web.config will automatically deploy with your Custom Page after each upgrade, and do not require further manual intervention.