← Blog

Guide

The audit log for administration changes

Administration › Audit log shows who changed users, roles, settings and account security, and when. Filter it by action and period.

This is part of Qorekit 0.3, out now as a beta: download 0.3.0-beta.1. As with any beta, keep a backup of anything you cannot afford to lose.

Qorekit 0.3 keeps an audit log of the administration. When a role suddenly allows more than it should, or a user was deactivated and nobody remembers why, you can look up who did it and when.

This post covers what the log records, what it leaves out on purpose, and how to find an entry.

Where to find it

Open Administration › Audit log. The newest entries come first, so the latest change is at the top.

Each entry says who made the change and what it was. When the person is shown as Qorekit, Qorekit did it by itself. That covers the installer, the command line and scheduled work.

What it records

The log keeps changes made in the administration:

  • users: added, changed, invited or deactivated;
  • roles and their permissions;
  • settings;
  • translations;
  • plugins and code hooks;
  • the security of accounts: passwords reset, two-step verification turned on or off, sessions ended.

It also keeps each time an administrator views Qorekit as a role.

What it leaves out

Some things never reach the log.

Passwords are never written to it, not even when a password is reset. The log says that it was reset, never what to.

The values of records are never written to it either. Customer details, deal amounts and ticket descriptions stay out.

Changes to records are not in this log at all. The log covers the administration only. When a colleague edits a deal, the deal’s followers hear of it through notifications, and the record shows who last changed it.

So the log is safe to show to the people who need it, without exposing your data.

Finding an entry

A busy installation fills the log quickly. Two filters narrow it down:

  • Action shows one kind of change only.
  • From and To limit the log to a period.

You can use both at once. To find who changed the Sales role last month, filter by the action for roles and set From and To to that month.

Show older loads the next entries, further back in time.

Some questions it answers

  • Who gave this person the Administrator role, and when?
  • When was two-step verification turned off for an account, and by whom?
  • Who installed or removed a plugin?
  • Did someone sign this user out of their sessions?
  • Which roles did an administrator preview before a change went live?

When something looks wrong, the log is the first place to look. It tells you who to ask.

Who can read it

Administrators read the audit log. So does anyone whose role has the administration permission Read the audit log.

That permission lets you give someone oversight without giving them the rest of the administration. A security officer or an outside auditor can read what changed, without being able to change roles or settings themselves.

Read more

The audit log page of the documentation lists what is recorded. The audit log arrives with Qorekit 0.3.0.