Autenticación IP por EZproxy
Autenticación IP por EZproxy
En este artículo te mostraremos cómo integrar a tus clientes institucionales a través de autenticación por IP usando EZproxy.
¿Qué es una IP? Una dirección IP es un número que identifica a un dispositivo (computadora, tablet, portátil, smartphone) o a un conjunto de dispositivos; por ejemplo, todas las computadoras de la red de una universidad.
¿Qué tipos de IP puedes asignar a tus usuarios? Nuestro sistema permite agregar los siguientes formatos:
- IP simple:
201.234.241.72 - Rango de IP: desde
201.234.241.72hasta201.234.241.79— también puedes ingresarlo en notación CIDR (201.234.241.72/29)
El caso más común es cuando se vende acceso a una institución para que todos sus alumnos ingresen por la red del EZproxy: en ese caso, todos los usuarios son identificados por la misma IP, la del proxy.
Esta configuración es más sencilla de lo que parece. Deberás realizar un intercambio de información con tu cliente:
ELLOS: deberán indicarte la o las IP y configurar desde su lado los datos que tu les envíes.
TU: deberás configurar las IP desde la biblioteca e indicarles a ellos la URL y el código Stanza.
Primero selecciona la modalidad de integración y luego sigue los pasos indicados.
OPCIÓN A — ACCESO POR USUARIO REFERIDO
1. El primer paso es conocer la o las IP que vamos a asignar (desde la que accederán los usuarios).
2. Identificar al cliente con un usuario en la plataforma.
Deberás crear un usuario en la Biblioteca: desde Panel de Control -> Usuarios -> Crear (en el caso que ya se encuentre creado ve al paso siguiente)
3. Asignar el plan específico al cliente.
En el usuario haz clic en Editar y asigna el plan correspondiente.
4. Asignar la IP o las IP's del cliente.
Posiciónate en el usuario y haz clic en el menú desplegable (botón con una flecha hacia abajo al lado de Editar) y selecciona "Asignar rango de IP"
Agregar la IP recibida y dar clic en Asignar.
Si el cliente solo te indicó una IP deberás completar únicamente el campo "desde". En el caso que te haya indicado un rango de IP's deberás completar los campos "desde" (inicio del rango) y "hasta" (fin del rango). Esto deberás repetirlo para todas las IP o rangos de IP distintos.
Continúa en la sección URL y código Stanza más abajo.
OPCIÓN B — ACCESO POR USUARIOS INDIVIDUALIZADOS
En esta modalidad, cada persona que accede desde la IP configurada obtiene su propio usuario en la plataforma, lo que permite un seguimiento individual del uso.
1. Obtener la IP o rango de IPs desde donde accederán los usuarios.
2. Configurar la IP en la plataforma.
Ve a Panel de control → Ajustes → Integraciones → Configuración de IP y haz clic en Crear.
En la ventana que aparece, ingresa la IP o rango de IPs en los campos Desde y Hasta:
- Una sola IP: completa únicamente el campo Desde.
- Rango de IPs: completa Desde (inicio) y Hasta (fin del rango).
Haz clic en Asignar para agregar el rango. Repite para cada IP o rango diferente.
Luego configura las opciones de acceso para los usuarios que ingresen por esta IP:
- Aceptar automáticamente las Políticas de Privacidad y Términos y Condiciones: los usuarios aceptarán los términos de forma automática al ingresar por primera vez.
- Permitir total acceso a todas las publicaciones: habilita el acceso a todo tu catálogo sin restricción ni necesidad de un plan específico.
- Asignar automáticamente un plan a los usuarios: asigna el plan elegido a cada usuario que ingrese por esta IP.
Haz clic en Guardar para confirmar.
Continúa en la sección URL y código Stanza más abajo.
URL Y CÓDIGO STANZA
Los siguientes pasos son iguales para ambas opciones.
Indicar al cliente la URL que usará para redirigir a sus usuarios. Esta es la URL que el cliente colocará en el botón o enlace desde donde sus usuarios accederán a la biblioteca.
Autenticación automática (recomendada)
https://{dominio-de-tu-biblioteca}/libraryEjemplo: https://alephdigital.publica.la/library
Autenticación por demanda (solo si ya la tenías configurada)
https://{dominio-de-tu-biblioteca}/auth/ip/auth/ip si ya estaba configurado, pero te recomendamos migrar a la autenticación automática con /library.Enviar el código Stanza al cliente.
Title <TÍTULO>
HTTPHeader -request -process X-XSRF-TOKEN
HTTPHeader -request -process X-CSRF-TOKEN
HTTPMethod PUT
HTTPMethod PATCH
HTTPMethod DELETE
HTTPMethod OPTIONS
HTTPMethod TRACE
HTTPMethod CONNECT
URL https://<DOMINIO>/auth/ip
HJ <DOMINIO>
DJ <DOMINIO>
Ejemplo con datos reales:
Title Exempligratia
HTTPHeader -request -process X-XSRF-TOKEN
HTTPHeader -request -process X-CSRF-TOKEN
HTTPMethod PUT
HTTPMethod PATCH
HTTPMethod DELETE
HTTPMethod OPTIONS
HTTPMethod TRACE
HTTPMethod CONNECT
URL https://exempligratia.publica.la/auth/ip
HJ exempligratia.publica.la
DJ exempligratia.publica.la
Una vez configurado de ambos lados, la integración está lista. Pide a tu cliente que realice una prueba de acceso para confirmar que todo funciona correctamente.
ERRORES COMUNES
La falla más frecuente ocurre cuando el usuario intenta acceder y el sistema le solicita usuario y contraseña — esto no debería ocurrir con autenticación por IP.
Verifica los siguientes puntos:
- La URL en el botón o enlace no incluye la terminación
/libraryo/auth/ip - La URL no incluye
https://al inicio - El código Stanza está incompleto
- Las IPs ingresadas no coinciden con las IPs desde donde acceden los usuarios
- (Opción A) El usuario referido tiene un límite de sesiones simultáneas menor a la cantidad de personas que deben acceder
- (Opción B) Las opciones de acceso en Ajustes → Integraciones → Configuración de IP no están configuradas correctamente
👉 Herramienta para solucionar problemas de asignación por IP o URL
Esperamos que este tutorial te haya resultado sencillo. Si tienes consultas escríbenos a support@publica.la.
Actualizado el: 10/07/2026
¡Gracias!