OXAudit

From Open-Xchange

Introduction

The Open-Xchange Audit Bundle is an extension of the Open-Xchange Server > 6.12 which will enable your Open-Xchange Server to log actions from users using your Open-Xchange environment. In detail the following actions will be logged to the logfile:

  1. Creation, modification, deletion of an appointment
  2. Creation, modification, deletion of a task
  3. Creation, modification, deletion of a contact
  4. Creation, modification, deletion of an infostore item

Install on OX AppSuite

Debian GNU/Linux 11.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/stable/DebianBullseye/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/stable/updates/DebianBullseye/ /

and run

$ apt-get update
$ apt-get install open-xchange-audit

Debian GNU/Linux 12.0

Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:

deb https://software.open-xchange.com/products/stable/DebianBookworm/ /
# if you have a valid maintenance subscription, please uncomment the 
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/stable/updates/DebianBookworm/ /

and run

$ apt-get update
$ apt-get install open-xchange-audit


Configuration

Per default the audit bundle will use the Open-Xchange groupware logfile to generate log entries. The logfile can be found at:

/var/log/open-xchange/open-xchange.log

If there is a need to use a seperate logfile for those audit log entries, please modify the following configuration file:

$ vim /opt/open-xchange/etc/groupware/file-logging.properties

# possible log levels are ALL INFO DEBUG
.level=WARNING

handlers=java.util.logging.FileHandler,com.openexchange.audit.logging.AuditFileHandler
java.util.logging.FileHandler.pattern=/var/log/open-xchange/open-xchange.log
java.util.logging.FileHandler.level=ALL
java.util.logging.FileHandler.limit=2097152
java.util.logging.FileHandler.count=99
java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
java.util.logging.FileHandler.append=true
com.openexchange.audit.logging.AuditFileHandler.enabled=true
com.openexchange.audit.logging.AuditFileHandler.pattern=/var/log/open-xchange/open-xchange-audit.log
com.openexchange.audit.logging.AuditFileHandler.level=ALL
com.openexchange.audit.logging.AuditFileHandler.limit=2097152
com.openexchange.audit.logging.AuditFileHandler.count=99
com.openexchange.audit.logging.AuditFileHandler.formatter=java.util.logging.SimpleFormatter
com.openexchange.audit.logging.AuditFileHandler.append=true

sun.rmi.level=WARNING
org.apache.level=WARNING
com.sun.level=WARNING
javax.management.level=WARNING 

After you have set the logpath for the audit bundle (/var/log/open-xchange/open-xchange-audit.log in this example) you need to restart the groupware service:

$ /etc/init.d/open-xchange-groupware restart