Skip to content

Sending out anonymized logs

Sometimes a piece of log must go outside the company: to support, when a device is not read as it should be, or to a technician or a tool, an AI too, that analyses it for you. The anonymized download of CSP (Central Syslog) gives the same logs with fake values in place of addresses and names, so whoever receives them does not know whose they are.

The fake values are of the same kind and always the same: the same address always gets the same stand-in. The logs can be read and interpreted as before, and still show who talks to whom. The logs kept by the panel do not change: only the file you download changes.

Downloading the anonymized logs

In the Logs tile, beside Download, the Anonymized: line has the same formats, CSV and syslog text, with the current filters. It needs the same permission as the normal download (CSP · Export logs).

Before sending a log out, open What is hidden, beside it, and read the preview.

What is replaced

  • IP addresses, IPv4 and IPv6, private ones included. An address of a private network stays in a private network; a public one becomes an address that does not exist, with a first number from 256 on (for instance 259.120.222.1), so that nobody takes it for the address of somebody else. The addresses of the same network stay together.
  • MAC addresses: the manufacturer stays, the device changes.
  • Email addresses: the name before the @ always, the domain when it is one of the names to hide.
  • The names to hide, wherever they are written, and the name each device writes in its own logs. They become name-….

Not replaced: the names of users, sites and VPNs that are not in the list, the domains visited, dates and times, and anything written in a way the panel does not recognise.

An address with a first number over 255 is not a valid address: a program that checks the form of addresses may refuse it.

What is hidden

The What is hidden page has:

  • Names to hide: those the panel already hides by itself (the devices as you registered them and as they call themselves, the computers of the agents, your company and the domain of your email) and Other names to hide, those you add: sites, VPNs, users, domains written in your logs. One for each line, at least 3 characters, at most 200 names; upper and lower case do not matter. A short and common word would be replaced everywhere, also where it means something else.
  • Preview: the last logs, as they are and as they are downloaded, with the count of what was replaced. What is still written in clear in the preview is in clear in the file too: add it to the names to hide.
  • Key of the stand-ins: the stand-ins come from a key of the subscription, which stays the same, so what you download today matches what you downloaded last month.

Make the key anew gives every value a different stand-in: what you sent out before can no longer be compared with what you download from now on, nor turned back into the real values. It cannot be undone.

The key and the names you added are part of the configuration backup of the subscription.

The anonymized file is not fully anonymous: with the key the addresses can be found again. Treat it as confidential data all the same.

Turning back into the real values

When an answer comes back, for instance "the address 259.120.222.1 tries to sign in to name-…", you can read it with the real values. In What is hidden, Turn back into the real values:

  1. paste in Anonymized text what came back from outside: the log you sent, or the answer of support, of a technician or of an AI that read it;
  2. press Turn back: With the real values shows the same text with the real addresses and names, and how many were turned back.

  3. The addresses (IPv4, IPv6, MAC) come back with the key of the subscription: only the stand-ins made with the current key.

  4. The names come back when they are still in the list of the names to hide.
  5. The name before the @ of an email address never comes back: it is not kept anywhere. The page lists the stand-ins that cannot be turned back.

The pasted text is not kept; the activity log records only that a text was turned back and how many values. At most 200,000 characters at a time.

Of the system roles, only the Owner can turn back into the real values: the Administrator has all the other capabilities, not this one. The Owner can give the capability CSP · Turn anonymized logs back into the real values to a custom role (see Users and roles).