Contextualizing EZPROXY for improved troubleshooting and problem reports


Derek Zoladz, MLIS
Library Systems Analyst @ OhioNET
derekz@ohionet.org

[https://ohionet.github.io/ohiolink-webinar]

Background

Manage 60+ Instances

Private & Public Academics, Medical & Law Libraries

... significant troubleshooting experience 😍

Schematic Aerial

User Environment

Network Context

Browser in Use

Network Segment

On-Campus

Wifi

4G/LTE

Off-campus

http://proxy.ohiolink.edu:9099/ip

Browser: Rendering Engines

Blink

Gecko

Webkit

Browser: Version & Plugins

Starting Point URLs

Library Controlled

Unknown

Library Properties

A-Z Database List

LibGuides

Platform Dashboards

MARC Records

https://login.{ezproxy_hostname}/login?url={target}

Configuration of EZproxy Application

EZproxy's Role

Database Stanzas, i.e. config.txt

Common Issues

What does EZproxy do?

EZproxy does a few things

OCLC's Stanza OSO

							Title Oxford Scholarship Online - OSO
URL https://www.oxfordscholarship.com
HJ https://oxfordscholarship.com
HJ oxfordscholarship.com
HJ www.oxfordscholarship.com
DJ oxfordscholarship.com
							
						

Database Stanza

Directive => Title

							Title Oxford Scholarship Online - OSO
URL https://www.oxfordscholarship.com
HJ https://oxfordscholarship.com
HJ oxfordscholarship.com
HJ www.oxfordscholarship.com
DJ oxfordscholarship.com
							
						

starts a new database stanza

Directive => URL

							Title Oxford Scholarship Online - OSO
URL https://www.oxfordscholarship.com
HJ https://oxfordscholarship.com
HJ oxfordscholarship.com
HJ www.oxfordscholarship.com
DJ oxfordscholarship.com
							
						

Essentially, a glorified HJ directive

Directive => HJ

							Title Oxford Scholarship Online - OSO
URL https://www.oxfordscholarship.com
HJ https://oxfordscholarship.com
HJ oxfordscholarship.com
HJ www.oxfordscholarship.com
DJ oxfordscholarship.com
							
						

Authorizes an EZproxy starting point

Directive => DJ

							Title Oxford Scholarship Online - OSO
URL https://www.oxfordscholarship.com
HJ https://oxfordscholarship.com
HJ oxfordscholarship.com
HJ www.oxfordscholarship.com
DJ oxfordscholarship.com
							
						

Tells EZproxy to rewrite (or proxy) a domain

Common Errors & Issues

Enabling HTTP and HTTPS

							HJ https://oxfordscholarship.com
HJ oxfordscholarship.com
							
						

If no protocol is defined, HTTP assumed

Passing Wrong Parameters

							
https://{hostname}/login?url=http://infotrac.galegroup.com/itweb/uni-account?db=NRC

https://{hostname}/login?url=http://infotrac.galegroup.com/itweb/old-uni-account?db=PPRC
							
						

Using the wrong account ID in starting point URL

Authentication & Vendor Platforms