Troubleshooting Browser Login Problems

A user tries to login via IE or Netscape to a Domino server and is getting a
login error. Creating custom error messages is a very simple way to get more
information and assist in troubleshooting.
Create a database called Custom Error Messages (httperror.nsf). Make Default
access reader. Create 2 forms, one called authorerror and one called

The authorerror form will come up when the Database ACL is stopping an
authenticated user from getting in. Make sure that it indicates so.

The authenerror form will come up when a user is not authenticated with the
server. Make sure that it indicates so.

Make sure that you have created a Domino Configuration database DOMCFG.nsf in
the \data directory on the server.

In the Domino Config, create a Mapping Error Messages entry and fill it in
similar to below:

Error Message and Response Mapping
Site Information
Server type: Virtual Server

IP Address:
Comment: TCINET Custom Errors
Authentication Failure
Target Database file name: httperror.nsf
Target Form name: Authenerror
Authorization Failure
Target Database file name: httperror.nsf
Target Form name: Authorerror
General Error Message
Target Database:
Target Form:
Delete Document Response
Target Database:
Target Form:

Save and restart the HTTP service.

For an IE user, after 3 attempts to login, they will get the appropriate error

For a Netscape user, have them hit cancel when they get the Authorization
Failed, Retry? window.

Depending on the error, you will know whether to check their HTTP Password/User
Name or the ACL of the database they are attempting to access.

Please note, this doesn't work when Session Authentication is enabled.

This was first published in November 2000

There are Comments. Add yours.

TIP: Want to include a code block in your comment? Use <pre> or <code> tags around the desired text. Ex: <code>insert code</code>

REGISTER or login:

Forgot Password?
By submitting you agree to receive email from TechTarget and its partners. If you reside outside of the United States, you consent to having your personal data transferred to and processed in the United States. Privacy
Sort by: OldestNewest

Forgot Password?

No problem! Submit your e-mail address below. We'll send you an email containing your password.

Your password has been sent to:

Disclaimer: Our Tips Exchange is a forum for you to share technical advice and expertise with your peers and to learn from other enterprise IT professionals. TechTarget provides the infrastructure to facilitate this sharing of information. However, we cannot guarantee the accuracy or validity of the material submitted. You agree that your use of the Ask The Expert services and your reliance on any questions, answers, information or other materials received through this Web site is at your own risk.