CCH Answers

How do you configure EZproxy to work with IntelliConnect?

Issue

You wish to configure OCLC's (formerly Useful Utilities') EZproxy so that remote users can access IntelliConnect using IP authentication.

Resolution

Entries need to be made to the EZproxy configuration file (ezproxy.cfg or config.txt) to configure EZproxy to allow access to IntelliConnect. The entries in the configuration file differ if you are using Proxy By Port or Proxy By Hostname.

• Proxy By Port

The EZproxy configuration file (ezproxy.cfg or config.txt) needs to have entries that allow SSL (https) processing. Note that an SSL certificate is required (see http://www.oclc.org/support/documentation/ezproxy/cfg/ssl). A purchased certificate from a certificate authority can be used or a free self-signed certificate can be created from within EZproxy. A self-signed certificate will cause a browser warning when users access your EZproxy server. For more information on differences in browser behavior, consult SSL Certificate Options.

Follow the link below for EZproxy SSL processing configuration steps:

http://www.oclc.org/support/documentation/ezproxy/cfg/ssl

Resolution Steps for Proxy By Port

Important note: These steps must be performed by the EZproxy administrator. Some of the resolution steps require access to the EZproxy’s server operating system and may require assistance of the server’s administrator.

1. Stop EZproxy. 
2. Open the EZproxy configuration file (ezproxy.cfg or config.txt) in a text editor such as Notepad.
3. Add the following entry for IntelliConnect

Title IntelliConnect
URL http://intelliconnect.cch.com/scion/auth.jsp
DJ cch.com
HJ intelliconnect.cch.com

4. After making the changes, save the EZproxy configuration file. 
5. Start EZproxy.

• Proxy By Hostname

The EZproxy configuration file (ezproxy.cfg or config.txt) needs to have entries that allow SSL (https) processing. Note that an SSL certificate is required (see http://www.oclc.org/support/documentation/ezproxy/cfg/ssl). A purchased certificate from a certificate authority can be used or a free self-signed certificate can be created from within EZproxy. A self-signed certificate will cause a browser warning when users access your EZproxy server. For more information on differences in browser behavior, consult SSL Certificate Options.

Follow the link below for EZproxy SSL processing configuration steps:

http://www.oclc.org/support/documentation/ezproxy/cfg/ssl

Once SSL is configured, the following entry needs to be added to the EZproxy configuration file:

LoginPortSSL 443 

Port 443 is the preferred number as this is the standard port for use with https.

Resolution Steps for Proxy By Hostname

Important note: These steps must be performed by the EZproxy administrator. Some of the resolution steps require access to the EZproxy’s server operating system and may require assistance of the server’s administrator.

1. Stop EZproxy. 
2. Open the EZproxy configuration file (ezproxy.cfg or config.txt) in a text editor such as Notepad. 
3. Enter the following line to enable SSL: LoginPortSSL 443
4. Add the following entry for IntelliConnect:

Title IntelliConnect
URL https://intelliconnect.cch.com/scion/auth.jsp
DJ cch.com
HJ intelliconnect.cch.com
Domain cch.com

5. After making the changes, save the EZproxy configuration file. 
6. Restart EZproxy.