Skip to main content
OCLC Support

Upload Patron Parser for Hosted EZproxy

Applies to
  • All versions hosted
Answer

1. Your EZproxy must be configured for Expert Service, this is sometimes referred to as Self-Service or SFTP access.  If you are unsure if this access is configured or need the credentials, contact OCLC Support.

2. Create a plain text file with patron data (using notepad or something similar). It must use UTF-8 encoding.  The file must be a .txt file and cannot be a .csv or other file type.  The first line in the patron data file should be a header of:

user:password 

Note: This line will be removed by the upload process.


The patron data starts from the second row. In this example below the username would be the patron barcode.

user:password
2222222:pw22
1212122:pw12
343434:pw34
252525:pw25

In this example, email addresses are being used as the username:

user:password
jenny@oclc.org:libraries
donna@manor.edu:ezproxyrocks
bill@manor.edu:mypasswordistricky

Usernames can not include an apostrophe.

There are no restrictions on password length, passwords are case sensitive and must be ASCII compliant.

3. Then drag your file with usernames and passwords over onto the OCLC server.  Do not put it inside any folder.  Just drop it off in the top level directory.  Every 15 minutes, the file will be picked up and immediately placed on your EZproxy server.  The usernames and passwords in the uploaded patron file will be active at that time.  The designated contact will receive an email when this happens.

PLEASE NOTE: Each new upload will completely replace the previous file of users and passwords and will NOT append to the already existing file, so please upload the full list of users and passwords every time.

Page ID
15917
Internal notes

This is a user authentication type that will require periodic updates. We have an FTP server that can accept updated text files for each Hosted EZproxy server. A member may ask us to update files as frequently as they would like. You can find the information for accessing the FTP for that particular institution by searching for them in sharepoint.

https://insideoclc.sharepoint.com/si...-924c2ebcdc20=

​​​​​​The member will need the PDA user and PDA password to complete the upload.  The Self-Service field will be "yes" if the site has access.