Local label generation
The address is decrypted on the label station at the packing desk, only at the moment the label prints.
2 min read
A carrier cannot deliver a parcel without a readable address on the box. That makes the shipping label the one unavoidable point where the address has to exist in plain text. Cirdan keeps it to exactly that point.
The label station
Each packing site runs a label station: the Cirdan print client on a computer connected to a thermal label printer. When you pair it in the dashboard, the station generates its own key pair. The private key is created on the station, stored in the device's secure key storage, and never leaves it. Only the public key is sent to Cirdan, which passes it to your checkout.
Set the station up where only shipping staff can reach it. It is the only device at the site that can read an address.
What changes with Cirdan
- Checkout
- Before:
Address sent to the store in plain text - With Cirdan: Encrypted in the buyer's browser
- Warehouse
- Before:
Pick lists show name and address - With Cirdan: Pick lists show an order token
- Storage
- Before:
Readable customer database - With Cirdan: Encrypted orders only, keys kept offline
- After delivery
- Before:
Address kept indefinitely - With Cirdan: Address deleted, deletion verifiable
- 1
- Device per site that can decrypt an address: the paired label station
- 0
- Plain text copies kept after the label prints
- 0
- Readable addresses left once the carrier confirms delivery
What happens when a label prints
- A packer scans the order token, or selects it in the print client.
- The station fetches the encrypted order and decrypts the address in memory.
- It renders the label and sends it straight to the printer.
- It discards the plain text. Nothing is written to disk, logs or a print spool.
The whole step takes about as long as printing a normal label. The packer sees the label come out of the printer, which is the same thing they see today.
“The label is the one place an address has to be readable. So that is the only place we make it readable, for as long as it takes to print.”
Keys, rotation and lost devices
Rotate a station's key when the hardware is replaced or when staff with access to it leave. The old station re-encrypts its open orders to the new key before it is retired, so nothing needs to be decrypted anywhere else.
If a station is lost or stolen, remove it in the dashboard. Its key is revoked immediately, it can no longer fetch orders, and new orders are encrypted only to the stations you still trust.
After delivery
When the carrier confirms delivery, the encrypted name, address and phone number are deleted for that order, along with the sealed order key that could unlock them. Without that key the ciphertext cannot be recovered by anyone, including us.
The order token, items, dates and shipping country are kept for your reporting. Each deletion is written to a deletion record you can open from the order in the dashboard, so you can show a customer, or an auditor, exactly when their address stopped existing.