Library:EZproxy

From UBC Wiki
Jump to: navigation, search

About EZproxy

What is EZproxy?

EZproxy is a web proxy server which acts as an authentication system, verify that users are current UBC authorized users. Many of the journals, ebooks, streaming videos and other online resources to which the Library has licensed access, require this verification for off-campus access because of license agreements between the library and its vendors. Once signed in to the EZproxy server, EZproxy dynamically rewrites URLs of electronic resources and uses its own IP address, producing the same effect as if the off-campus user was on the UBCSecure network or at a Library computer terminal.

Who can use EZproxy?

Current UBC students, faculty, and staff members are able to log into EZproxy using their authorized CWL.

Alumni with Alumni Cards (A-Cards) can also use their authorized CWL to access select resources.

Affiliates College faculty & staff and Faculty Authorized users can log in using their authorized UBC/Library card Barcode & PIN.

If you are having trouble logging in, please contact the UBC Library Help Desk at |library.systems@ubc.ca] .

Is EZproxy the only way to access UBC Library resources?

Generally, you do not need to use EZproxy if you are connected to the UBCSecure wireless network, (not ubcvisitor), or are using a computer located within the UBC network, such as a Library workstation. However, a few resources always require EZproxy.

Some faculty members, staff and graduate students may not need to connect via EZproxy if they have set up a remote desktop on a home computer; simply open the browser on a campus computer to connect as if on campus. Note: Remote desktop software is managed and supported by departmental IT units, not the Library.

EZproxy connectivity is also not necessary for library resources free of subscription-based licensing agreements such as those in cIRcle (UBC's digital repository), UBC Library’s Open Collections, DOAJ Directory of Open Access Journals, or Open Access Indexes & Databases.

Can myVPN be used to connect to UBC Library resources?

UBC's myVPN service does not provide direct access to UBC Library’s electronic resources. The combining of MyVPN and EZproxy can cause access problems. Only use EZproxy.

How do I connect to EZproxy?

To connect to EZproxy, simply go to the Library homepage at www.library.ubc.ca

Click on ‘Login’ on the right side of the top navigation menu. Note: 'Login' is included in the Library's website navigation menu and is available from all other pages on the Library website.

Select ‘EZproxy Login’ from the drop-down as shown below.

Homepage-login.png

Or, search for a resource via one of our discovery gateways such as Summon. When you click on a link to a resource, you will be presented with the EZproxy login page.

On the EZproxy Login page enter your CWL or (for Faculty Authorized researchers, Affiliated Colleges Faculty/Staff) your Library Barcode/PIN.

EZproxyLogin May2019.png


Alternatively, you can also bookmark the EZproxy login page.

If you are off-campus, it is recommended that you log in to EZproxy before accessing the Library and its resources.

Known Problems

  • If you can't connect to a resource via EZproxy, check first to make sure that the problem isn't on the side of the resource. UBC Library has an eResources: Service Bulletins blog that provides the latest news on database and system periods of downtime.
  • If you are having difficulty connecting to EZproxy from a business, corporate, or other secure network it may be due to firewall restrictions and you will need to consult the network admin or IT department in order to configure your firewall settings to allow you access.
  • You may receive an error message when trying to access an electronic resource for which UBC Library does not provide access. You will only be able to access electronic resources which are licensed by UBC Library and have been added to the Library's EZproxy configuration file. If you receive an error message and are denied access to an academic resource that you think the Library may have a license for, please contact the Library's Collections Services Department via the Electronic Resources: Problems, Questions and Comments form.

Getting Help

CWL and Standard Library Login (Barcode/PIN)

For issues related to your CWL account, contact UBC's IT Service Centre Help Desk by:

If you are having trouble with your Standard Library Login, invalid PINs can be reset:

  • Online via the Forgot Your Pin? form.
  • Phoning UBC Library (Vancouver): 604-822-2406
  • Phoning UBC Library (Okanagan): 250.807.9107

Note: New PINs may take up to 20 minutes to take effect.

Resource Access

If you cannot access the resource for any other reason, please contact UBC Library's Collections Services unit using the Library Electronic Resources: Problems, Questions, Comments form, and consult the eResources: Service Bulletins blog for access news.

If there is an urgency to the problem, you can also reach Collections Services' eResources & Access unit by phone at 604-822-4192 between 9:00 a.m. and 5:00 p.m. Monday to Friday.

Tips, Tools, & Troubleshooting

For more on using EZproxy, check out the Library's EZproxy Tips & Troubleshooting page and the EZproxy Toolkit.

Tips

Staying Connected

Once logged in, typically an EZproxy session should remain valid, but will time out after 2 hours of inactivity.

However, in order to stay in an EZproxy session, you must also:

  • Conduct all your research within the same browser you used to log in to EZproxy. The session will, however, bridge across multiple tabs of the same browser:
  • Navigate the web in a pathway, or chain, by following links or using your browser’s forward and back arrows as much as possible, instead of hyperlinking between sites. For example, if you use UBC Library’s Indexes & Databases page to click through to a database, you will be connected and ‘in’ an EZproxy session. You can search the database for materials and all of your results will be available to you, but if you then decide to click on a site you have bookmarked or type in a URL for a new site directly into your browser address bar, you will jump ‘out’ of the session. If you find this happening a lot to you or are interested in having additional support for connecting to resources, see the Library's EZproxy Toolkit.


When in doubt, check your URL address for the word ‘ezproxy.’ If it’s there, then you’re connected.
Ezproxy-url2.png

Ezproxy-url3.png


If you are connected but still not able to access a resource or are prompted to pay for it, please contact the Library's Electronic Resources department via the online Problems, Questions and Comments form.

Setting Up Your Browser

If you're having problems, it may be that you need to configure or reset your web browser settings.

Enabling Cookies

EZproxy uses cookies to store and send data that verifies you are in a connected session and an authorized user. Therefore, successful use of EZproxy requires that your browser has cookies enabled. For information on how to enable cookies, follow the instructions on UBC IT's Browser Help page.

Clearing Your Cache

Your browser may also be caching — temporarily storing and automatically retrieving — web content from past sessions, including failed sessions. If this is the case you'll need to delete this content from your browser's memory by clearing your cache and restarting your browser.

Enabling JavaScript

Some resources may also require that you have JavaScript enabled. UBC IT also provides instructions on How to Enable Javascript.

Using Google Scholar

When using Google Scholar It is best NOT to sign into EZproxy first. If you have a Google/Gmail account, sign in.

Setting Up Your Library Links

On the Google Scholar homepage:

  • Click on "Settings" and then "Library Links"
  • Find and select "University of British Columbia - UBC eLink" and/or "University of British Columbia Library - UBC eLink" and "Save"

It is advisable to create an account so that your Library Links settings can be saved for future visits. Without an account, you will need to set your Library Links manually.

Once configured, Google Scholar will display a "UBC eLink" beside results that it recognizes as available at UBC Library. Click on the UBC eLink to connect to the resource (full-text online or print). Off-campus users will be prompted to authenticate via EZproxy.

UBC elink.png

Keeping Updated

Sometimes databases experience temporary periods of downtime. If you're sure you've got EZproxy working but still can't connect to a resource, check the UBC Library eResources: Service Bulletins blog first to make sure the resource itself isn't the problem.

You can also follow the UBC eResources Twitter feed to find out the moment access has been restored.

The Library's eResources & Access unit is responsible for managing the e-resources lifecycle, including troubleshooting access problems and providing day-to-day support to users by responding to queries.

Finding Help

There are many services offered by the Library that can help you access the e-resources and digital collections you need.

Tools

EZproxy Link Generator

EZproxy Link Generator

Want to create a link to a UBC Library licensed resource for off-campus use? Use our EZproxy Link Generator!

How do I use the EZproxy Link Generator?

Paste the URL into the box below and click "create." This will add the EZproxy prefix to your URL, therefore triggering the system to authenticate users and ensuring the link will work off-campus.

The resulting URL can also be shared with your UBC colleagues and students and embedded into other content, like Canvas and Research Guides.

For best results, we recommend using a persistent URL, or PURL, with the link generator. A PURL is a link to a specific web page that remains stable over time. Many people don't know that some urls are "session-based" and only work for the duration of your search session. If you try to access a session-based url after you log-off, navigate away from the page and/or several hours later you will get an error message instead of the page you were expecting. To learn more, see our guide to Finding Persistent URLs.

If you do not wish to use the link generator tool above, you can paste the following prefix directly in front of your PURL (i.e. no spaces between the prefix and the PURL)

https://ezproxy.library.ubc.ca/login?url=


EZproxy Bookmarklet

EZproxy Bookmarklet

The EZproxy Bookmarklet is a great tool if you find yourself often jumping out of an EZproxy session while navigating the web; it's also very useful if you prefer to access e-resources without needing to first visit the Library website (for example, if you are a heavy user of a specific database).

A bookmarklet is a button you can add to your bookmarks bar in whatever browser you are using; once clicked, the bookmarklet uses JavaScript to dynamically rewrite the page you are currently on and add the EZproxy prefix to its URL. If you are already connected, the reloaded page should present you with the content you're looking for; if you're not, you will first be prompted to login and then will be automatically redirected back to your original page.

How do I install the EZproxy Bookmarklet?

Bookmarklet Script/Link/Button? goes here
For Chrome Users

To install the EZproxy Bookmarklet in Chrome, drag the button to your Bookmarks Bar. If your bookmarks bar is hidden, go to the View menu option and select "Always Show Bookmarks Bar." It is recommended that you put the bookmarklet somewhere prominent in the bar (see below image) so it is easy to find and click while researching. You can also edit and rename the bookmarklet.

For Firefox Users

To install the EZproxy Bookmarklet in Firefox, right click on the button and select "Bookmark This Link" to add it to your bookmarks or drag the link to your Bookmarks Toolbar. If your bookmarks toolbar is hidden, go to the View menu option, select "Toolbars" and check "Bookmarks Toolbar." You can also edit and rename the bookmarklet.

For Safari Users

To install the EZproxy Bookmarklet in Safari, drag the button to your Toolbar. If your toolbar is hidden, go to the View menu option and select "Show Toolbar." It is recommended that you put the bookmarklet somewhere prominent in the bar (see below image) so it is easy to find and click while researching. You can also edit and rename the bookmarklet.

For Internet Explorer Users

To install the EZproxy Bookmarklet in Internet Explorer, right click on the button and select "Add to Favorites..." from the menu. If a dialogue box asks you if you'd like to continue, click 'Yes.' In the 'Add a Favorite' options, choose the 'Create In' drop-down menu and select 'Favorites Toolbar. You can also rename the bookmarklet here if you want to. Click Add.

For iPad Users

To install the EZproxy Bookmarklet on an iPad, in Safari save this page as a bookmark, then edit the bookmark to rename it to something more descriptive about it being a bookmarklet for EZproxy, and paste the following JavaScript into the URL field:

javascript:void(location.href="https://ezproxy.library.ubc.ca/login?url="+location.href)

How do I use the EZproxy Bookmarklet?

Whenever you are unable to access an e-resource from a website or database or prompted to pay for an article, click on the EZproxy Bookmarklet.

Before-bookmarklet.png

The page should then reload via EZproxy, providing you with access.

After-bookmarklet.png

Known Problems

In order for the EZproxy Bookmarklet to work, you must have JavaScript enabled in your browser.

If you do and are still unable to gain access to a electronic resource, it could be because EZproxy attempted to automatically reload a URL for a page, such as a vendor website error page or a publisher database login page, that does not belong to a resource (i.e. is not actually the page where the article or chapter is hosted). Trying to proxy such a page will therefore not produce the desired result (a link to a resource or full-text download) and instead will redirect you to the following error page:

950x

In these cases, you may be able to access the resource by using your browser's Back button to navigate before a point where you encountered the vendor or publisher landing page (for example, the link to the resource from Google Scholar). Clicking on the link again should then provide you with direct access.

This error page will also occur when attempting to proxy any non-academic resource website, whether it be Google, UBC's homepage, Wikipedia, or Facebook.

You may also receive this error message if UBC Library does not have licensed access to a particular resource or has not added the resource to its EZproxy config file. If you receive an error message and are denied access to an academic resource that you think the Library may have a license for, please contact the Library's Technical Services Department via the Electronic Resources: Questions and Comments form.

UBC LibX Toolbar

LibX

LibX is a browser tool which works much like the EZproxy bookmarklet with one notable difference: the bookmarklet is intended only for pages that you're already on and reloads the current URL via EZproxy; LibX, on the other hand, can also activate EZproxy to rewrite new links just prior to clicking on them. This functionality is especially useful for avoiding the bookmarklet error message page described above as proxied access is provided before arriving on the vendor and publisher sites, so that sites can identify that you are licensed for access and therefore won't redirect you to a generic landing page or login screen.

LibX was developed by the University Libraries and the Department of Computer Science at Virginia Tech and is available for academic libraries to use under the Mozilla Public License for free software. While the toolbar offers a range of functionality, the UBC Library edition of LibX focuses exclusively on providing support for proxying e-resources for off-campus access.

How do I install LibX?

The UBC Library edition was developed with LibX release version 2.0 . Currently, UBC'c LibX is only available for Chrome.

For Chrome Users

To install the EZproxy Bookmarklet in Chrome, click here. You will be taken to a new page with a button for adding UBC LibX 2.0 to Chrome.

Chrome button.png

After clicking on the button, a pop-up window will appear you asking you to confirm that you want to install LibX as a browser extension. If you are ok with adding the extension, click Add. For more information on LibX Privacy Policy, please see the LibX Settings section.

Chrome pop-up.png

A new pop-up window will appear in the top right-hand corner of your browser notifying you that you have added the extension successfully. An icon for LibX (a blue UBC image) will also appear in your browser.

Chrome added.png

Clicking on the UBC icon will give you access to the drop-down LibX toolbar.

Chrome toolbar.png


How do I use LibX?

You can use LibX in one of two ways:

1. As a drop-down toolbar from your browser, featuring a search box for the UBC Library Catalogue, Google Scholar, the UBC Journal Collection, and Summon and links to popular content on the UBC Library website; and

2. As a right-click context menu within webpages.

You can access EZproxy support with both of these options; it's up to you to decide how you want to use LibX!

To active EZproxy when in the toolbar, click on the Proxies tab in the left sidebar navigation menu and, under EZproxy, select "Reload page with this proxy."

To activate EZproxy with the context menu, right-click anywhere on a page and choose the option "Reload page via EZproxy."

For Chrome Users

To proxy a link to a new page when using Chrome, right-click on the link, mouse over "LibX for Google Chrome (TM)", then select "Follow link via EZproxy."

Chrome right click.png

Settings

You can customize your LibX options, enable or disable functionality, and specify your display preferences by first clicking on the UBC icon in your browser to activate the drop-down toolbar and then choosing "Preferences" from the left sidebar menu (this will open a new tab in your browser).

Context Menu

Visit the Context Menu tab under Preferences to add even more options to your right-click context menu (in addition to the default options to reload or follow a link via EZproxy). Check off the boxes to include the ability to search keywords, titles, and authors in Summon or the UBC Library Catalogue all by using the context menu.

Privacy

According to LibX Privacy Policy, use of the extension will send the URL of pages you are currently visiting to UBC Library's catalogue server and EZproxy server.

The LibX Project and its developers are also using Google Analytics to learn how LibX is being used across the different academic libraries that provide their patrons with an edition. Type of data collected includes such things as how many times a library catalogue search is performed using the toolbar (according to the LibX Privacy Policy, only the event is logged, not the actual search query).

To disable Google Analytics from tracking your usage, visit the Browser tab under Preferences and uncheck the following options:

  • Send extension usage (e.g edition installed, catalogs used for searches) [Note: LibX uses Google Analytics]
  • Send libapp usage (e.g frequently used libapps) [Note: LibX uses Google Analytics]

Known Problems

While using LibX is a good bet for avoiding the vendor and publisher website difficulties encountered with the EZproxy bookmarklet, the same error page will still occur if you attempt to proxy any non-academic resource websites or any resources that have not been added to the EZproxy config file by UBC Library.

Other Tools Available

The Link Generator, Bookmarklet, and LibX are all tools that provide enhanced support and easier access to e-resources for off-campus users. Other tools may be available, but are not supported by UBC Library. They may also not be as comprehensive in scope and cover all of UBC Library's resources. Some of these options include:

Zotero

Those who use Zotero may be happy to learn that the popular citation management tool also provides some support for EZproxy to users of the Firefox extension. To configure Zotero to work with EZproxy, users must add the proxy address under the Proxies tab in Preferences (for more information, see the relevant Zotero documentation).

Zotero.png

Make sure to check off both the 'Enable proxy redirection' and 'Automatically recognize proxied resources' options. To add EZproxy access for UBC Library, click on the plus sign, check 'Multi-site' then enter the following into the scheme field:

http://%h.ezproxy.library.ubc.ca/%p


Please note that only resources that the user has previously visited while proxied will be recognized by the Zotero proxy tool (resulting in automatic access or a redirection to UBC Library's EZproxy login page). This is because the tool learns from a user's activity - therefore, the more resources you visit while proxied, the more resources Zotero will save and remember for the future.

Mendeley

The Mendeley website also offers some support for EZproxy access for searches in its crowd-sourced research catalog. To configure EZproxy access in Mendeley for UBC Library, log into the site, click on the Papers tab, and then search for a paper or click on any of those listed as popular. On the paper's overview page, click the 'Find this paper at:' button and select 'Edit library access links.'

Mendeley.png

Choose 'Add library manually,' and then enter UBC Library for name and the following for base URL:

http://ezproxy.library.ubc.ca/login?url=http://gw2jh3xr2c.search.serialssolutions.com/


Mendeley2.png

From now on, clicking on 'Find this paper at' will give you the option of searching in UBC Library and should connect you directly to our holdings.

Mendeley3.png

Papers App

Papers, a citation management application that can sync up your collection of references and PDFs across your desktop, laptop, and iPhone, iPad, or iPod touch, can also be configured so that electronic resources are automatically prepended with UBC Library's EZproxy prefix. Please note that Papers is not supported by UBC Library.
To configure EZproxy for iPhones, iPads, or iPods, you must first manually add the following prefix to the Papers application under "Proxy Settings" in the Settings menu:

http://ezproxy.library.ubc.ca/login?url=%@


Make sure to toggle the "Use EZProxy" option to "On."

For desktop or laptop usage, you need only to select the University of British Columbia as your Library Proxy from a drop-down list of universities—how you do this will depend on the OS (Windows or Mac) you are using. For Windows, the option is available under Access -> Options. For Mac, go to Preferences -> Access. Please see below for an example of how to add UBC Library to Papers for Mac:

In the application menu, navigate to Papers and select "Preferences..."

Preferences-Papers.png

Click on the "Access" tab. If you have not yet configured EZproxy, you should see the message "No proxy selected" in the "Use Library Proxy" field.

Access-Papers.png

Click on the drop-down menu and scroll through the options until you find "University of British Columbia."

Library-Papers.png

Select and close the menu. (We recommend leaving the Library website URL field empty)

EZproxy Redirect

EZproxy Redirect is a browser extension (similar to LibX) but available only to Chrome users. To install, click here. Please note that EZproxy Redirect requires that you add UBC as your school (the default for the extension is set to serve Drexel University Libraries). To do this, right-click the extension icon and select "Options." Under "Select School," choose the University of British Columbia and hit Save.

EZproxy Greasemonkey Script

Based on the UCalgary EZproxy Redirector created by David Aikema, this script first requires an installation of the Greasemonkey extension for Firefox. After clicking on this UCalgary EZproxy Redirector link (also found here in #2) and agreeing to install the script, you must then also edit and update the script to add in UBC Library's EZproxy prefix. To do this, click on "Tools" in Firefox, select Greasemonkey and then "Manage User Scripts." In Preferences, click on "Edit this User Script" and replace all references to "ezproxy.lib.ucalgary.ca" with "ezproxy.library.ubc.ca"