Zimbra Account History

By: zetalliance

Zimbra Recent Account Activity (beta)

A Zimbra extension that allows the user to monitor their recent login and account activity. This is important to keep the user's account safe.

Designed for Zimbra version 8.8.

Bugs and feedback: https://github.com/Zimbra-Community/account-history/issues

========================================================================

Installing

Use the automated installer:

wget --no-cache https://github.com/Zimbra-Community/account-history/raw/master/account-history-installer.sh -O /tmp/account-history-installer.sh
chmod +rx /tmp/account-history-installer.sh
/tmp/account-history-installer.sh

========================================================================

Screenshot of Client Zimlet

Screenshot of Admin Zimlet and extension

========================================================================

Log external ip

If you only see internal IP's in the account history, you need to configure Zimbra to log the IP from the X-Forwarded-For header. https://wiki.zimbra.com/wiki/LogFiles#LoggingtheOriginatingIP

zmlocalconfig zimbra_http_originating_ip_header
zimbra_http_originating_ip_header = X-Forwarded-For

zmprov mcf +zimbraMailTrustedIP 127.0.0.1
zmprov mcf +zimbraMailTrustedIP 
zmprov mcf +zimbraMailTrustedIP 

Configuring preferences

Support a semi-colon separated list of log files, only the audit.og log4j format is supported.

nano /opt/zimbra/lib/ext/accountHistory/config.properties
audit_logs=/opt/zimbra/log/audit.log;/opt/zimbra/log/sync.log

You can also have the extension read gzipped files (after log rotation), for now, it only reads yesterdays gz log.

nano /opt/zimbra/lib/ext/accountHistory/config.properties
audit_logs=/opt/zimbra/log/audit.log;/opt/zimbra/log/audit.log.yyyy-MM-dd.gz

Helpful Links

• https://github.com/Zimbra-Community/account-history
• https://fundrazr.com/d1D8Ud

Download View on GitHub

Rating	( 8 ratings )
Downloads	3509
Latest Version	0.1.5
Categories	Mail
Compatibility	ZCS 8.8.x
License	GNU GPL v2
Created	on 3/29/17
Updated	on 10/15/21

Reviews

• Is it still "beta"? 

  By: Yannis on on 10/3/23 for version 0.1.5

  Can the "beta" in the title be deleted? Is there still a reason? I haven't seen any issues and I'm trying to get another admin to install it on their own server and it says it's "beta"... :)
  Thanks!

• It worked! 

  By: dmafaldo on on 12/17/20 for version 0.1.5

  8.8.15_GA_3980

• Error accessing accout history 

  By: als315 on on 11/24/20 for version 0.1.5

  I have following error:
  method: [unknown]
  msg: unknown document: accountHistory
  code: service.UNKNOWN_DOCUMENT
  detail: soap:Sender
  trace: qtp1225197672-97453:1606205151422:b4e544b9d7f6faa3
  request:
  name@domain0_dcef5d715f18fce4e9eba069c611d7fb4e6df6b8

  Shoud I make any additional steps after installation?

   

  • restart mailbox, and follow all steps from readme 

    Replied on 2/21/21

• about uninstall 

  By: apapsing on on 7/15/20 for version 0.1.5

  i found it on github...
  thanks...

• How to uninstall? 

  By: apapsing on on 7/15/20 for version 0.1.5

  I can't uninstall it in admin page.
  I want to update zimbra version, but i afraid affect update...

• How Long Time Shows Previous Entries ? 

  By: ibrahimayhans on on 5/12/20 for version 0.1.5

  How Long After Zimlet Is Installed Shows Previous Records?

   

  • It will show whatever it can find in your logs. So it should work directly after being installed. 

    Replied on 7/6/20

• A Very Nice Zimlet 

  By: ibrahimayhans on on 5/12/20 for version 0.1.5

  Thank You To Everyone Who Supported,
  I had to read the log one by one when there was a problem before
  But Now I Can See Entries With A Single Query
  Thank Yok :)

• After install web mail and admin page unresponsive, can not login 

  By: NothingCtrl on on 3/14/18 for version 0.1.0

  - ZC version 8.7.7
  Install step (as root):
  - wget --no-cache https://github.com/Zimbra-Community/account-history/raw/master/account-history-installer.sh -O /tmp/account-history-installer.sh
  - chmod +rx /tmp/account-history-installer.sh
  - /tmp/account-history-installer.sh
  - su - zimbra -c "zmmailboxdctl restart"

  Note: a warning when installing
  "java.io.FileNotFoundException: /tmp/accountHistory.fhoFQQuT/upgrade/config.properties (No such file or directory)"

   

  • That error is not a problem, please re-try with the latest version. 

    Replied on 2/7/20