DocumentaciónHelp

Rotate the encryption key

Generate a new encryption key for a company and re-encrypt its secrets and attachments with it, without interrupting its work.

On this page

Each Elion ITSM company has its own encryption key. It protects the company's most sensitive data: its users' two-step verification secrets, the credentials of its integrations and notification channels, the assistant history, attachments and received emails. Rotating the key creates a new one and re-encrypts all of that with it.

When to rotate it

  • When you suspect the key or a copy of the encrypted data may have been exposed.

  • When the customer's security policy or an audit requires it, for example once a year.

  • After a security incident that affected the platform, as a preventive measure.

You do not need to rotate it for routine changes, like a user leaving: for that, deactivating or deleting them is enough.

Before you start

Steps

  1. Open the company's page: Companies → Open.

  2. In the Company details card, click Rotate encryption key.

  3. In Rotate the encryption key? read the message: A new key is created and a background process re-encrypts the company's secrets and attachments.

  4. Click Rotate.

You see Rotation started.

What happens during rotation

  1. The new key is active immediately. Everything encrypted from that moment uses the new key.

  2. The previous key is retired, not deleted. It is still used only to read what has not been re-encrypted yet.

  3. A background process re-encrypts the company's secrets and files with the new key. It runs in the maintenance queue and takes longer the more attachments the company has.

  4. When it finishes without errors, the previous key is considered fully retired.

Throughout the process the company keeps working normally: its users do not notice anything, sessions are not closed and attachments still open.

How to know if it finished

The company page does not show the progress. Check it in Platform status, on the maintenance queue row:

  • while it runs, you see at least 1 in Active;

  • when it finishes, the job adds to Completed (1 h);

  • if the Failed number goes up, the process could not finish.

A one-off error, like a file that could not be re-encrypted, does not appear on this screen: the process continues with the rest and keeps the previous key available. The technical team sees those cases in the service logs.

If the rotation fails, what is already encrypted with the previous key is still readable, so the company does not lose information. Let the Argunis technical team know so they can review the details before trying again.

Rotating the key does not change users' passwords or their two-step verification: they keep signing in as before.

Related

Search Elion ITSM

Type at least 2 characters to search Elion ITSM.

↑↓ to navigate · Enter to open · Esc to close