Aantar

Aantar POS

The store file, the PC, its key and the recovery file

The store's data is one encrypted file; its key is kept by Windows on the PC, the recovery file opens it anywhere else, and the backups are encrypted the same way.

Everything a store records (items, prices, sales, customers, house accounts, shifts and the books) is kept in one file, the store file, with the extension .sbo. The file is encrypted, so a copy of it is of no use to anyone who does not hold its key. This page explains where the key is, what the recovery file is for, and what happens when a PC is lost, stolen or reset.

The store file

  • A store made with Set up your store is one encrypted .sbo file on the till's PC. A store on a store server is a file on that server.
  • The encryption is ChaCha20-Poly1305, applied to the whole database by the app's own database engine. Without the key the file cannot be read or opened by another program.
  • The app's own folder holds no store data. Uninstalling the app never deletes the store. See Where the app keeps its data.

The key

A store made with Set up your store is locked with a key that nobody types or sees. The key is kept in the Windows protected store (Windows Credential Manager) of the Windows user who made the store, on that PC. So:

  • the store opens by itself on that PC, for that Windows user, and the cashier only keys a PIN;
  • the same file copied to another PC, or opened under another Windows user, does not open without the recovery file;
  • after Windows is reset, the key is gone and only the recovery file opens the store.

A store made by an earlier version of Aantar POS is locked with a password someone chose. That password opens it, and that store has no recovery file.

The recovery file

The recovery file holds the store's recovery key, a line that starts with SBO-. It opens the store when the PC's key is gone, and it lets the owner choose a new till PIN. The store keeps only a check value of the recovery key, never the key itself.

  1. Save the recovery file at the end of Set up your store, or later from More ▸ Back office, where Save a recovery file shows until the file is saved. See Your recovery file.
  2. Keep one copy away from the store, for example on a USB stick at home, and a second copy in your e-mail or on paper with the store's papers.
  3. Each time the store is opened with its recovery file, it gets a new key and a new recovery file. Save the new one and throw the old one away.

Warning: Anyone who has the recovery file and a copy of the store file can open the store. Keep the recovery file as you would keep a key to the shop, and never on the till PC alone.

Important: If both the PC's key and the recovery file are lost, the store and its backups cannot be opened by anyone, Aantar support included.

Backups

The automatic backups are copies of the encrypted store file. A backup on a USB drive, a network share or a synced folder cannot be read without the store's key, the owner's password of an older store, or the recovery key. See Automatic backups and Keep a copy in a second place.

On a store server

A company on a store server can have a company file password. With one, the company is encrypted on the server and stays Locked after every restart of the server until someone unlocks it on the set-up page with its password or recovery key. A store moved onto the server from a till set up with Set up your store is encrypted this way. See Move a store onto the store server and The set-up page.

If a PC is lost or stolen

The store file on that PC opens for anyone who can sign in to its Windows user. A Windows password on every store PC is the first protection.

  1. If the PC was a lane of a store server, press Revoke on its line under Paired computers on the store server's set-up page. See Pairing codes.
  2. Change the owner's Aantar password.
  3. Change the till PINs of the staff who used the lost PC.
  4. On a single-lane store, set up a new PC from a backup and the recovery file. See Move a store to a new PC. The store on the new PC gets a new key and a new recovery file.
  5. Free the lost PC's lane in the portal. See Your PCs and tills in the portal.

Note: A lane paired with a store server keeps the store's books on the server, not on the lane. The lane PC holds a working copy of what it needs to sell and its queue of sales not yet sent. See When the network drops.

Related articles

Something unclear or out of date? Write to support@aantar.com and name this page.