Auditorías en Alfresco Share 3.4

Auditorías … Auditorías everywhere

Muy buenas a todos.

Me gustaría hablaros en esta ocasión de auditar contenido en un Alfresco 3.4, que como sabéis por defecto el contenido que auditéis se os muestra en los logs como texto plano (poco intuitivo y algo difícil de leer). En este mini tutorial os quiero enseñar lo que yo he puesto en algunos clientes, que aunque sea básico, creo que es bastante útil :-)

Os quiero hablar del módulo de auditorias ASUR, creado por la empresa Francesa StarXpert para Alfresco 3.4 y que creo que más de un cliente o usuario final agradecerá tenerlo.
La idea es sencilla: Obtener una gráfica con las transacciones que se tienen según un filtrado (hora, mes, día, etc..) y una información mínima ¿Lo bueno de usarlo? Que tiene incluso ejemplos sencillos de auditorias ya pre configuradas y que además podréis añadirles auditorías propias. Además de éste módulo os enseñaré cómo complementarlo instalando un dashlet para auditoria bastante útil para los administradores.

¿Qué debéis saber para comenzar este tutorial?

  • Obligatorio:
    Saber manejar el módulo de alfresco alfresco-mnt-tool para instalar los amps.
  • Opcional:
    Tener vuestro propio archivo para auditar.

Manos a la obra…

Por lo pronto deberemos tener nuestro archivo de auditoría con lo que queramos mostrar. En este tutorial no voy a entrar en detalles sobre cómo realizar un archivo para auditar contenido (más abajo os dejo links con alguna referencia) pero usaremos un ejemplo que os facilitaré para que hagáis la toma de contacto sin mucha dificultad.

Objetivos: Entender como instalar la consola ASUR, el dashlet de auditoria, configurarlo y así poder usar la auditoría en share de una forma mas intuitiva.

Descarga: aquí os dejo todo lo que necesitáis: Amps, jar y archivo de ejemplo

 

PASOS A SEGUIR

1. Abrid el alfresco-global.properties (shared/classes/alfresco) y añadid estas lineas al final del todo

## Audit
audit.enabled=true

Colocamos el archivo con el mapeo de nuestra auditoría – (alfresco-audit-example-login.xml)

2. Copiamos el archivo a /tomcat/shared/classes/alfresco/extension/audit  (creamos esta carpeta si no la tenemos aun creada)

Habilitando el log para mostrar trazas del contenido que vamos a auditar.

3. Creamos un archivo con un editor de notas que llamaremos custom-audit-log4j.properties  y dentro pegamos estas lineas:

## Log para modulo de auditoria
log4j.logger.org.alfresco.repo.audit.AuditComponentImpl=info
log4j.logger.org.alfresco.repo.audit.inbound=info

Instalamos la consola en nuestro alfresco y share.
Alfresco ubicación del amp (ASUR-Alfresco-1.0.2.amp)

4. Cogemos el jar de Alfrescoy lo pegamos a alfresco_home/amps/
Share ubicación del amp (ASUR-Share-1.0.2.amp)

5. Cogemos el jar de Share y lo pegamos en alfresco_home/amps_share/

Para instalar los amps, por favor seguid estas indicaciones.

Consejo! Una vez estén compilados, desde cmd (consola de comandos) para estar seguros de que los tenemos desplegados ejecutad desde la carpeta bin: java -jar alfresco-mmt.jar list alfresco_ruta/tomcat/webapps/alfresco.war y  java -jar alfresco-mmt.jar list alfresco_ruta/tomcat/webapps/share.war  Si os sale un listado con los amps de ASUR, estamos preparados para seguir con el tutorial.

Dashlet con la consola (audit-dashlet-0.43.jar)

6. Pegar el jar  /shared/lib/

Y bien ya lo tenemos todo para echar a andar nuestro alfresco y empezar a trastear.

Arrancamos nuestro alfresco y accedemos a Share como admin. Lo primero que haremos será configurar nuestro dashlet de auditoría.

Accedemos arriba a la derecha a “Personalizar el panel de inicio”

Presionamos Añadir dashlet y arrastramos el “audit aplication” abajo y presionamos Aceptar.

En el dashboard del administrador sí que podremos ver por fin el dashlet pero tendremos que configurarlo de la siguiente forma para visualizar los datos que estamos auditando:

Presionamos en Configurar (o configure) y obtendremos esta pantalla:

Como veis, automáticamente  os coge el archivo de auditar que le hemos metido en la carpeta de  extension (en mi caso tengo alguno más). Lo seleccionamos y presionamos aceptar.

Nota: En el caso de que no os salga, bastará con introducir la palabra login y ya os aparecerá disponible la lista.

Y aquí tenéis la lista con los datos auditados

El null que aparece ha sido un intento fallido de login (con el usuario que no existía)

Ahora vamos a ver como se visualiza en la consola de audición del Share. Para ello pinchamos arriba en la derecha a + y al botón de la consola de audición:

Y nos encontraremos con la siguiente pantalla:

 

A la izquierda tenéis las auditorías disponibles, si bien lo único que debéis hacer es seleccionar una de ellas, ponerle un filtro (vista en horas,días, etc..), presionar submit y obtendréis una gráfica algo básica pero útil.

Y esto es todo para este tutorial… Aunque quería recomendar que le echaseis un vistazo al dashlet para auditar contenido que tenéis disponible en la página de Share add-ons y manejarlo todo desde nuestro dashboard (como administrador, por ejemplo).

Sin más, espero que os haya servido de ayuda :-)

¡Ah! Os dejo algunos links de interés:

 

¡Un saludo a todos!

2 pensamientos en “Auditorías en Alfresco Share 3.4

Deja un comentario