This integration allows you to automatically authenticate users coming from an specific IP or IP ranges.
For both direct and proxy methods the system requires the IP or IP ranges from where the users are expected to connect. In case you're using a proxy, you'll need to configure the IP of the proxy.
In the store:
- Go to
Control Panel > Users
- Create a new user or select an existing one
- Set the IP or IP ranges using the option
Assing IP rangesin the dropdown menu.
To add a unique IP you should add it in "From" and then press the "Assign" button, leaving "To" empty. In case you need to add an IP range, for example all IPs between 10.0.0.1 to 10.200.200.255, you will setup From: 10.0.0.1 - To: 10.200.200.255 and any user coming from IPs in that range will be automatically logged in.
- Create a button or Hyperlink.
- Set a route
https://your-store.com/libraryto log in the user. You can also use a publication page url or a specific filter.
As long as you are connecting from the configured IP Range, directly or using a proxy, you will be automatically authenticated when accessing the library section (
/library), a publication page or even the reader.
You can always log out from that account. You will be redirected to the log in page and you will be able to sign in with a different account, like another user or an administrator account. You can automatically log in by IP again just by going back to
On demand authentication, in the third party end:
This is a legacy method.
We will keep supporting this if you are already using it, but we encourage you to use the Automatic authentication
- Create a button or Hyperlink
- Set a route
https://your-store.com/auth/iplike link in the button
- In case you need to redirect users to a specific URL inside store such as the publication page or a specific filter you may add the
intended_urlparameter to your URL.
For proxies, first you need to configure the
HTTPMethod value is needed for a secure connection between proxy and our server and make sure that all works fine. This is because in some cases we need to use
PUT request or other kind or request for get or set information.
then you need configure all steps for direct configuration. The difference here is the proxy only.
If your integration is not working properly it could be due to the following reasons:
- Incorrect IP or IP range configured in the system
- Users connecting from another IP or IP range other than the one configured in the system
In both cases users will be directed to the login form instead of bing automatically logged in.
You can add to url query
?debug=true to know IP where come from these user.
When you use this URL you should see the follow screen show with date to know if the user are configured with correct IPs.