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
- Locate the IIS application for your custom pages current deployment. See Find a custom page's physical deployment, for more information.
- Disable Anonymous authentication and enable your chosen authentication method (Forms or Windows) via IIS.
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.
- Navigate to Feature Delegation at the root of the IIS server and set Authentication - Anonymous, Authentication - Windows, and/or Authentication - Forms to Read/Write.
- Insert the following sections into your Custom Page's web.config as desired:
- To disable anonymous authentication:
<system.webServer> <security> <authentication> <anonymousAuthentication enabled="false" /> </authentication> </security> </system.webServer>
- To enable Forms authentication:
- To enable Windows Authentication:
- Values set via your web.config will automatically deploy with your Custom Page after each upgrade, and do not require further manual intervention.
<system.web> <authentication mode="Forms" /> </system.web>
<system.web> <authentication mode="Windows" /> </system.web>