From e554f7b4eeaa5759f6fd653f356d955b889f71b0 Mon Sep 17 00:00:00 2001 From: Edith Parzefall Date: Wed, 30 Nov 2022 15:39:54 +0100 Subject: [PATCH] Apply suggestions from code review Co-authored-by: Martin --- services/audit/README.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/services/audit/README.md b/services/audit/README.md index efdf1885e0..1639ac86c2 100644 --- a/services/audit/README.md +++ b/services/audit/README.md @@ -1,11 +1,13 @@ # Audit service -The audit service logs all events of the system into an audit log. To be able to prove compliance with corporate guidelines as well as to enable reporting and auditing of operations, the Auditing extension takes note of actions conducted by users and administrators. Per default it will be logged to standard out but can also be configured to a file output. Supported log formats are json or a simple key value ("key1=value1 key2=value2"). +The audit service logs all events of the system as an audit log. Per default, it will be logged to standard out, but can also be configured to a file output. Supported log formats are json or a simple key-value pair ("key1=value1 key2=value2"). -The service is not started automatically when running `ocis server` (single binary setup), it has to be started explicitly. +With audit logs you are able to prove compliance with corporate guidelines as well as to enable reporting and auditing of operations. The audit service takes note of actions conducted by users and administrators. -Specifically, the application logs +The service is not started automatically when running as single binary started via `ocis server` or when running as docker container and must be started and stopped manually on demand. -- file system operations (create/delete/move; including actions on the trash bin and versioning) -- user management operations (creation/deletion of users) -- sharing operations (user/group sharing, sharing via link, changing permissions, calls to sharing API from clients) +Specifically, the audit service logs: + +- File system operations (create/delete/move; including actions on the trash bin and versioning) +- User management operations (creation/deletion of users) +- Sharing operations (user/group sharing, sharing via link, changing permissions, calls to sharing API from clients)