Introduction

Starting from In Spring 2019, a new page has been introduced in order to manage IAS Auditing.
This page is accessible only by Users with Complete User Management  role,  by clicking on Administration → Audit Trail. 

Enable IAS Audit

Auditing is disabled by default, unless where this was enabled in Call Recording.  It can be enabled accessing the above mentioned page and flagging the related checobox, then saving.

Once Auditing has been enabled, is it not possible to disable it, for security reasons. 

Retention

Data retention (audit events and related accessory data deletion from DB) is performed by an automatic periodic job every 24 hours (not configurable) at 01:30 am (not configurable).
retention period, (maximum time allowed for audit data to be remain stored into the DB) can be configured by web through il Delete data older than (days) parameter in Configuration  section into  Administration → Audit Trail page.

Download

In case audit is enabled, a new “Download audit logs” section appears in its configuration page, as per below.

from this page it is possible to download a CSV file containing all recorded audit events, that can be filtered by:

• time
• tenant (only in case of multi-tenant installations)
• applications

CSV file format as follows:

• Application Id: IAS application ID for the event
• Timestamp (Server Time Zone): time when the event occurred
• Username: Username of the ebent user 
• First name: Name of the event user 
• Last name: Surname of the event user 
• Tenant: Tenant of the event user 
• Action: Type of action (Ex: Play recording)
• Client IP: machine IP where the action causing the audit event was made
• IAS Node: node where the action causing the audit event was made
• Details: Details of the particular event.  "Details" column format changes according to the specific event (i.e. for an "Unpreserve recording" event the format is as follows:

Recording Id {c333d58a-7ba6-4d69-91e4-175816aa5d0b}, Recording PBX Call Id {28787197}, Recording duration {00:00:01.9674372}, Recording Ref. Number {2019000000003}, Recording start time (Server Time Zone) {2019-01-07T11:18:16.1670000+01:00}, Recording owner username {u205}, Recording owner first name {Utente}, Recording owner last name {Duecentocinque}, Recording group {Group1}

Please note that in case of scheduled reports audit is generated only in case IAS mail is enabled and an email is sent.