Upload Patron Parser for Hosted EZproxy
Applies to
- Hosted EZproxy
Answer
1. Your EZproxy must be configured for text file Authentication, 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 the 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
In this example, you would only be using a barcode for username:
user 1333567891234 7894561234561 6899851235123
Usernames can not include an apostrophe.
There are no restrictions on password length, passwords are case sensitive and must be ASCII compliant.
3. 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.
If there are any non-ASCII characters in the file the upload will fail.