How to change the response IIS sends when errors occur

Version Affected: All

Description:  

How to change the response IIS sends when errors occur.

Cause:  

When an error occurs in IIS an error code and message is sent back to the browser, e.g. a 404 error.

It is possible to configure what happens when such errors occur and display a different message or redirect the user somewhere else. 

This can be useful when wanting to suppress 404 errors when a realm or page isn't found or display a friendly message to the end user.

Resolution:  

1. Open IIS Manager
2. Click on "Default Web Site" in the left hand pane
3. Then Click on Error Pages:

4. Double click the error you want to change e.g. 404, and you'll now see this dialog where you can decide what will happen:

Special Considerations:  

Be aware that by default, requests going to localhost (i.e. browsing from the IdP itself) will still see detailed error messages but requests from anywhere else will see the custom error response configured above.

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.