Log files overview

Añada la directiva de auditoría

Si añade la directiva Audit al archivo config.txt, ordenará a EZproxy que cree registros de auditoría cuando se produzcan los eventos especificados y guarde estos archivos en el directorio de instalación de EZproxy. Los archivos individuales serán nombrados con el año, mes y día en que ocurrió el evento (por ejemplo, 20140512.txt). El uso más común de la directiva Audit para ordenar a EZproxy que cree registros de auditoría es el siguiente:

Audit Most

Esta declaración directiva creará un registro cuando se produzca cualquiera de los siguientes eventos:

• Se deniega el acceso de EZproxy a un usuario
• Un usuario se conecta con éxito a EZproxy
• Un usuario tiene un intento fallido de iniciar sesión en EZproxy
• Se produce un intento de intrusión basado en la directiva IntruderIPAttempts o IntruderUserAttempts
• Las actividades generales del sistema, como el arranque del sistema, se producen
• Un usuario no autorizado intenta acceder a las funciones administrativas de EZproxy
• Se produce un evento resultante de la directiva UsageLimit

Esta es la configuración por defecto en el archivo config.txt que se descarga con EZproxy. Para obtener más detalles sobre la personalización de los registros de auditoría, consulte Audit.

Se puede acceder a los registros de auditoría desde la página de administración de EZproxy en cualquier momento. Los registros que han sido purgados como resultado de la directiva AuditPurge no serán accesibles.

Configuración sugerida

Manteniendo la declaración de la directiva Audit Most por defecto en su archivo config.txt, tendrá los eventos de seguridad más comúnmente evaluados registrados en sus registros de auditoría. Para limitar la cantidad de espacio de almacenamiento que ocupan sus registros de auditoría, la directiva AuditPurge también está configurada por defecto a 7 después de la declaración Audit para que EZproxy elimine los archivos después de un período de tiempo especificado. Esto mantendrá sólo los registros de auditoría para el día actual más la semana anterior y eliminará cualquier archivo que tenga más de 7 días. OCLC sugiere aumentar el período de tiempo de AuditPurge a 180, de modo que su archivo config.txt tenga el siguiente aspecto

Audit Most
AuditPurge 180

Este cambio en la directiva AuditPurge hará que EZproxy conserve el archivo de auditoría del día actual más los archivos de auditoría de los 180 días anteriores, y borre cualquier archivo de más de 180 días. Conservar los archivos de auditoría durante periodos de tiempo más largos le proporcionará una mayor cantidad de información para su revisión en caso de que necesite acceder a ella. Puede aumentar o disminuir el número de purgas según lo considere oportuno para ahorrar espacio en el disco o asegurarse de que tiene los datos que necesita en caso de que las solicitudes de informes o una violación de la seguridad le obliguen a consultarlos. A la hora de determinar el tiempo de purga de su AuditPurge, consulte con su departamento de TI para asegurarse de que su programa de retención cumple con las políticas institucionales a efectos de seguridad y presentación de informes.

Ezproxy.log

EZproxy generará automáticamente los registros de EZproxy y los guardará en un archivo llamado ezproxy.log en el directorio donde esté instalado EZproxy. El comando por defecto utilizado para formatear los datos recogidos en el registro de EZproxy es el siguiente:

LogFormat %h %l %u %t “%r” %s %b

Esto generará los siguientes datos en su registro de EZproxy:

132.174.1.1 - - [14 /Mar/2014:09:39:18 -0700] “GET http://www.somedb.com:80/index.html HTTP/1.0” 200 1234

El siguiente cuadro desglosa esta línea de datos:

 Nota: Si EZproxy no puede recoger los datos indicados en un campo concreto, insertará un guión para la información que falta.

Para más detalles sobre estos y otros campos que pueden utilizarse para personalizar aún más esta directiva, consulte LogFormat.

Configuración sugerida

La configuración por defecto del archivo config.txt del EZproxy autónomo le proporcionará archivos de registro mensuales que contienen datos sobre todas las transferencias de datos y solicitudes enviadas a través de su instancia de EZproxy. Dependiendo de los niveles de uso, es posible que desee configurar EZproxy para mantener archivos de registro diarios en lugar de mensuales para que pueda identificar más rápidamente la ubicación de la información que pueda necesitar por fecha. Esta configuración sugerida no contiene ningún LogFilter, pero también puede considerar si la inclusión de filtros para limitar el volumen de datos recopilados haría que sus registros de EZproxy fueran más manejables y proporcionaran información más enfocada. Consulte LogFilter para obtener más detalles sobre esta opción. La siguiente configuración cambiará sus registros de EZproxy a archivos diarios en lugar de mensuales:

LogFormat %h %l %u %t "%r" %s %b
LogFile -strftime ezp%Y%m%d.log

messages.txt

EZproxy generará automáticamente registros messages.txt y los guardará en archivos del mismo nombre en el directorio de instalación de EZproxy. Aunque hay menos directivas dedicadas a personalizar la información registrada en messages.txt, muchas directivas utilizadas para establecer límites máximos registrarán información en messages.txt cuando se alcancen estos límites. Una lista de las directivas que registran este tipo de información se puede encontrar en la pestaña de Directivas Relacionadas, y al hacer clic en el enlace se obtendrá información adicional.

Los datos contenidos en el archivo messages.txt, tendrán un aspecto similar al siguiente cuando inicie o reinicie su instancia de EZproxy, si no tiene errores:

2018-01-12 12:41:07 EZproxy 5.7.42 GA [SOURCE:5.7.41_SOURCE] [Windows] [2017-06-26T19:46:13Z]
2018-01-12 12:41:07 For further information or updates, visit http://www.oclc.org/ezproxy/ or contact ezproxy@oclc.org.
2018-01-12 12:41:07 MaxVirtualHost (MV) changed from 200 to 1000
2018-01-12 12:41:07 Server name localhost
2018-01-12 12:41:07 The use of a server name with no periods will cause some databases to fail.
2018-01-12 12:41:07 Server http URL http://localhost:2048
2018-01-12 12:41:07 Proxy by port
2018-01-12 12:41:07 SSL is not configured so https proxying will not be available
2018-01-12 12:41:07 To configure EZproxy as a service that runs in the background and
2018-01-12 12:41:07 starts when this system is booted, press CTRL/C and issue the commands:
2018-01-12 12:41:07      C:\ezproxy\ezproxy.exe -si
2018-01-12 12:41:07      net start EZproxy
2018-01-12 12:41:07 You may not see any additional messages, but EZproxy is running.
2018-01-12 12:41:07 If you press CTRL/C or close this window, EZproxy will stop running.
2018-01-12 12:41:07 Thank you for your purchase of this licensed copy of EZproxy.
2018-01-12 12:41:07 EZproxy was last able to validate the license on 2018-01-12 12:41:07.
2018-01-12 12:45:53 Guardian starting EZproxy

Muchos de los datos en messages.txt están escritos en un formato de mensaje para transmitirle detalles o problemas con su config.txt o user.txt que pueden impedir que su EZproxy funcione. Si has hecho cambios en las configuraciones en cualquiera de estos archivos, pero EZproxy no se está comportando como se esperaba, messages.txt es un buen lugar para comprobar si alguno de esos cambios fue introducido incorrectamente y causó el error.

Configuración sugerida

Al igual que con las otras configuraciones de archivos de registro, OCLC sugiere que cambie el nombre de los archivos messages.txt para que roten diariamente, de modo que la información se conserve en los registros nombrados con la fecha. Esto facilitará la identificación de la ubicación de la información que pueda necesitar por fecha. Introduzca la siguiente línea como primera línea de su archivo messages.txt para crear registros de mensajes nombrados con el año, el mes y el día en que se crean:

MessagesFile -strftime messages-%Y-%m-%d.txt

Spu.log

Añadir la directiva LogSPU a su archivo config.txt le proporcionará datos para determinar a qué URL de punto de partida han accedido los usuarios remotos. Añadir campos de configuración adicionales, los mismos que se utilizan en LogFormat, le permite refinar la información registrada junto con cada URL de punto de partida e incluir datos como la fecha y hora de acceso y el grupo de usuarios.

No hay ningún valor predeterminado para LogSPU en el archivo config.txt que se descarga con EZproxy, por lo que debe determinar qué información le gustaría recoger en este registro antes de añadirlo a su archivo config.txt. Puede personalizar su spu.log utilizando los mismos campos aceptados por la directiva LogFormat .

Configuración sugerida

OCLC sugiere, e implementa para los sitios EZproxy alojados, la siguiente configuración de LogSPU:

LogSPU -strftime spu%Y%m%d.log %{%Y/%m/%d:%H:%M:%S}t %h %u %{ezproxy-spuaccess}i %v %U

Esta configuración le proporcionará la siguiente información:

Esto le proporcionará información para ayudarle a determinar a qué recursos se accede con más frecuencia y por quién. Si bien esta información puede ser útil para tomar decisiones de recopilación, le sugerimos que también configure su ezproxy.log para registrar datos adicionales que podrían ser valiosos para evaluar el uso de los recursos proxy por parte de sus usuarios remotos, ya que el spu.log sólo contendrá información sobre el primer acceso del usuario a un recurso, no sobre la información adicional a la que accede mientras está en esa URL.