Embed Size (px)
DESCRIPTION
Plugin de monitorización outlook de acceso de web. El objetivo de este plugin es la monitorización del funcionamiento del acceso de web de outlook. Para más información visite la siguiente pagina web: http://pandorafms.com/index.php?
Citation preview
Pandora FMSManual AdministradorPlugin Outlook Web Access
Manual Administrador Plugin Outlook Web Access
© Artica Soluciones Tecnológicas 2005-2012
Índice de contenido1Histórico de cambios..........................................................................................................................32Introducción........................................................................................................................................4
2.1.Funcionamiento del plugin........................................................................................................43Matriz de compatibilidad ...................................................................................................................54Documentación a entregar por el Área que requiere la monitorización.............................................65Módulos del plugin ............................................................................................................................76Requisitos...........................................................................................................................................87Instalación...........................................................................................................................................98Configuración de la monitorización.................................................................................................10
8.1.Parámetros del plugin..............................................................................................................108.2.Formato del archivo users.txt...................................................................................................108.3.Creación de un módulo plugin.................................................................................................11
1 HISTÓRICO DE CAMBIOS
Fecha Autor Cambio Versión
15/02/12 Dario Primera versión del plugin v1r1
25/09/12 Dario Corregido error en el código v1r2
2 INTRODUCCIÓN
Page 3
Este documento tiene como objetivo la descripción del plugin de monitorización de Outlook Web
Access. El propósito del plugin es monitorizar el correcto funcionamiento de la aplicación Outlook
Web Access.
2.1. Funcionamiento del plugin
El plugin comprueba que la aplicación OWA está disponible para el usuario y que es posible
acceder usando las credenciales del usuario.
El plugin realiza las mismas acciones que ejecutaría un usuario por medio de un navegador web a
la hora de acceder al servicio, simula una navegación web por la aplicación pidiendo la página
principal y completando y enviando el formulario de login.
Además de esta comprobación permite comprobar la existencia de errores específicos surgidos
durante el uso de la aplicación.
Para cualquiera de los chequeos el plugin devolverá 1 ó 0 dependiendo del resultado de la
comprobación, por ejemplo si no se puede loguear el plugin devolverá 0. Otro ejemplo podría ser si
al realizar la comprobación encuentra la cadena de error especificada devolverá 1 y si no encuentra
la cadena devolverá 0.
3 MATRIZ DE COMPATIBILIDAD
La matriz de compatibilidad para el plugin se muestra a continuación:
Page 4
Sistemas donde se ha probado• SUSE Linux Enterprise Server 11
(x86_64)• Outlook Web Access 14.355.2
Sistemas donde deberíafuncionar
• SUSE Linux Enterprise Server 11 (x86_64) o superior
• Outlook Web Access 14.355.2 o superior
Es posible que en futuras versiones sea necesario realizar cambios en el plugin para que funcione
correctamente.
4 DOCUMENTACIÓN A ENTREGAR POR EL ÁREA QUE REQUIERE LA MONITORIZACIÓN.
Page 5
La información que debe entregar el área que requiere la monitorización es la siguiente:
• Dominio por el cual se accede al servicio Outlook Web Access.
• Datos de 5 usuario para realizar la monitorización y son los siguientes:
◦ Dominio del usuario
◦ Nombre de usuarios
◦ Contraseñas de los usuarios
• Si se quiere usar la detección de errores se debe proveer una lista con los errores que se
desean comprobar.
5 MÓDULOS DEL PLUGIN El plugin es capaz de realizar tres tipos de chequeos prueba de login e index y comprobación de
errores.
Page 6
• La prueba de index comprueba que el servicio está accesible, es decir que es posible llegar la
la página de Outlook Web Access.
• La prueba de login comprueba si es posible o no entrar a la aplicación
• Las pruebas de errores se puede realizar con cualquiera de las dos anteriores y comprueba
si durante la prueba de conexión se ha devuelto el código de error buscado.
6 REQUISITOS
Para el correcto funcionamiento del plugin se debe estár instalado el siguiente software:
Page 7
• Servidor de Pandora FMS 3.2.1 o superior
• Librerías perl:
◦ libio-socket-ssl-perl
◦ libnet-ssleay-perl
Page 8
7 INSTALACIÓN
Para instalar el plugin sólo es necesario copiarlo en una carpeta del servidor y luego darlo de alta
como plugin en la sección de gestión de plugins de la consola de Pandora FMS.
La configuración de registro del plugin quedaría como se pueder ver en la siguiente imagen.
Page 9
8 CONFIGURACIÓN DE LA MONITORIZACIÓN
8.1. Parámetros del plugin
Los parámetros de configuración del plugin son los siguientes:
• check_owa.sh --domain <domain> --check <check_type> --users_file <users_file> [--
error_str <error_string>]
• domain: dominio donde está instalado el servidor OWA.
• check: tipo de chequeo, que puede ser:
◦ index: comprueba que se puede acceder al formulario de bienvenida de OWA.
◦ login: comprueba del login usando múltiples usuarios.
• user_file: archivo que contiene las credenciales de los usuarios para probar el login
• error_str: (opcional) comprueba si aparece una deteminada cadena de error durante la
navegación. Se pueden usar expresiones regulares
Un ejemplo de que comprueba el login es:
./check_owa.pl --domain "my.exchange.com" --check login --users_file users.txt
Para comprobar un string de error pondríamos:
./check_owa.pl --domain "my.exchange.com" --check login --users_file users.txt --error_str 403
8.2. Formato del archivo users.txt
Este archivo contiene las credenciales de los multiples usuarios habilitados para probar que el
formulario de login funciona correctamente.
El formato del archivo es el siguiente:
DOMINIO\usuario1;contraseña1
DOMINIO\usuario2;contraseña2
DOMINIO\usuario3;contraseña3
DOMINIO\usuario4;contraseña4
Lo ideal es usar 5 usuarios ya que más ralentiza la ejecución del plugin. La razón de
usar 5 usuarios es evitar falsos positivos si las cuentas se bloquean. Por ello siempre
se realizarán las comprobaciones en base al número de usuarios del fichero.
8.3. Creación de un módulo plugin
Este plugin tiene que estar dado de alta en Pandora como plugin de servidor.
Page 10
A la hora de crear un módulo que use este plugin será necesario poner todos los parámetros en el
campo Plug-in parameters, por ejemplo:
P l u g - i n p a r a m e t e r s : - - d o m a i n m y d o m a i n . c o m – c h e c k l o g i n – u s e r s _ f i l e
/var/www/html/pandora_console/plugin/users2.txt –error_str 500
Page 11
