All Collections
B2B Sales
IP by EZproxy Integration
IP by EZproxy Integration

When we integrate through the IP of an Ezproxy, we are able to have the users access the library automatically.

Lara Macarena Sastre avatar
Written by Lara Macarena Sastre
Updated over a week ago

The most common cases are when an access to an institution is sold so that all students enter through a single network provided by the EZproxy, in other words, users are identified by the same IP, the proxy.

📌 BEFORE YOU BEGIN:

What is an IP?

An IP address is a number that identifies a device (computer, tablet, laptop, smartphone) or set of devices (for example: computers in a university library).

What types of IP's can you assign to your users?

Our system allows you to add the following IP formats to your users:

  • Simple IP: 201.234.241.72

  • IP range: from 201.234.241.72 to 201.234.241.79. These ranges can also be added as CIDR notation 201.234.241.72/29

⚠️IMPORTANT: Our servers are compatible with versions 1.2 y 1.3 of the TLS protocol. The EZproxy server must be configured to use one of these 2 protocols.

SETTING:

This setup is simpler than it sounds. You must carry out an information exchange with your client:

THEM: they must indicate the IP (s) and configure the data that you send them from their side.

YOU: you will have to set up the IPs from the library and tell them the URL and the Stanza code.

Step by step:

1) The first step is to know the IP (s) that we are going to assign (from which the users will access).

2) Identify the customer with a user on the platform.

You must create a user in the Library: from Control Panel -> Users -> Create (if it is already created, go to the next step)

3) Assign the specific plan to the client.

In user click on Edit and assign the corresponding plan.

Screen Shot 2020-12-29 at 12.17.12 PM

4) To assign the IP or IP's of the client.

Position yourself on the user and click on the drop-down menu (next to Edit) and select "Assign IP range"

Screen Shot 2020-12-29 at 12.22.58 PM

Add the received IP and click Assign.

Screen Shot 2020-12-29 at 12.23.49 PM

If the client only indicated an IP address, you must only complete the "from" field. In the case that you have indicated a range of IP's, you must complete the fields "from" (beginning of the range) and "to" (end of the range). This must be repeated for all IPs or different IP ranges.

5) Tell the client the URL to use to redirect users from the site where they will redirect to the library. This URL must be placed by your client in the Button or Link where users click to read.

Automatic authentication:
The URL should be as shown below:

Url of your library /library

On demand authentication

We will keep supporting this if you are already using it, but we encourage you to use the Automatic authentication

Url of your library / auth / ip

⚠️ The URL with the ending "/ auth / ip" is very important as it identifies that the user comes from an authorized IP and allows access to the library. This is one of the most common mistakes that integration can fail.

6) Send the stanza code to the client:

Screen Shot 2020-12-29 at 5.06.15 PM

Example:

Screen Shot 2020-12-29 at 5.08.18 PM

The stanza code must contain all the fields indicated in the example for the integration to work correctly.

DONE! Once configured on both sides, the integration is done.

COMMON MISTAKES

The most common mistakes can be:

- URL not including the / auth / ip ending

- Incomplete Stanza code.

- Incorrect IP's.

- Identified user (the one we created in step 2) with a simultaneous session limit lower than the number of users who must enter.

The integration failure is seen at the moment in which the user enters to read and is asked to log in with a username and password (this should not happen).

📌 Here is a tool that will help you to solve or detect where the error may be.

NOTE: Remember that you can limit the number of simultaneous sessions for your users to adapt to what you have agreed with the institution you serve.

Keep in mind that all users who enter are identified with the one you configured in step 2.

We hope we made this tutorial easy for you and if you have more questions write us at [email protected]

Did this answer your question?