Documentation Index

Fetch the complete documentation index at: https://mfa.rapididentity.com/llms.txt

Use this file to discover all available pages before exploring further.

Enabling Custom Errors For Admin Portal Troubleshooting

Prev Next

Changes to your MFA server environment can cause small discrepencies that can hinder access to the ONE Admin Portal, and usually appears in the form of the error message "Your request cannot be processed." Most of the time, this can be due to an expired SSL certificate.

However, if further digging is required, it can be done by looking at the server's Event Viewer (under Applications) around the time of the attempted access or by enabling the "Custom Errors". Once enabled, when you go to the portal's URL, the error preventing you from using it will be displayed. This will only work if there is an issue present with accessing your MFA portal.

Enabling Custom Errors

  1. Open Notepad as an administrator.

  2. Open: C:\Program Files\Identity Automation\RapidIdentity MFA\WebSite\web.config

  3. Use CTRL+F to find "customErrors".
    customErrors.png

    a. Edit mode="On" to mode="Off".
    b. customErrors appears twice in the file. Find the next appearance and repeat Step 3a.
    c. Save your changes.


  4. Close your browser and perform an iisreset.

  5. Re-open your ONE Admin Portal.

ℹ️ If your Admin Portal is working, you will be able to access and use it while custom errors are turned on. If something is wrong, you will see the error stack trace instead of your admin portal when going to the URL.

Read through the stack trace to determine the source of the problem or share it with our Support team and we can help figure out and resolve your portal access issues.