Institutions that are using Windows Active Directory should also review LDAP Authentication for information on how to authenticate using LDAP. LDAP support is available in all versions of EZproxy.
The Windows Domain authentication described here is only available in EZproxy for Windows. In addition, to authenticate against a given domain, the computer running EZproxy must either be a member of that domain or be a member of a domain that has a trust relationship with the given domain.
To enable domain authentication, the account used to run EZproxy must possess the "Act as part of the operating system" right. If you run EZproxy as a service under the "local system" account, it will automatically have this right. If you run EZproxy interactively for testing or as a service under a different account, you must grant this right to this account by following these steps.
Once this is in place, simply edit user.txt/ezproxy.usr and add a line like this:
replacing your-domain with the domain name for authentication.
When using Domain authentication, EZproxy records errors for any failed attempt. These error message looks like this:
LogonUser for rdoe returned 1326
The numbers that appear at the end of these lines are the Windows error. These are the most common error codes:
|1326||Invalid username or password|
|1793||Account is expired|
|1909||Password must be changed before first login|
A complete list of all possible error codes is available at:
If you encounter an error code and are unclear what it means, please contact firstname.lastname@example.org for help.
If you use password expiration within your domain, you can configure EZproxy to support password changing for expired password.
For versions of EZproxy dated prior to 2005-01-22, the following steps only work for people who are required to change their password at first login, but does not help for people whose passwords have expired. Versions of EZproxy dated 2005-01-22 and later handle both pre-expired accounts and ongoing password expirations.
To enable EZproxy to allow users to change their expired passwords, use these steps:
Open a "Command Prompt" window by going to Start | Run..., typing
in the Open: box, then clicking OK.c: md \ezproxy cd \ezproxy
Create the files for handling password expiration by typing the command:
These steps create the file wexpired.htm in the docs subdirectory. The presence of wexpired.htm tells EZproxy to handle expired passwords. You can edit this file to customize it to your needs, but care must be taken to leave the pieces that refer to ^0, ^1, ^2, and ^3 in the same form to insure EZproxy can insert information into this form when it is presented to users who have expired passwords.