Security keys and recovery
Your admin key signs every change to your network. The recovery key can replace it. Keep both safe, and know what to do if one is lost.
Your admin key and PIN
It signs every change
Approving, removing, renaming, a rule: each is signed with your admin key, and every device in the network checks the signature.
It stays on your computer
On Windows it sits in the computer's security chip (the TPM), behind your PIN; the chip locks out after repeated wrong guesses. On Linux there is no PIN: the key is sealed to the computer's TPM, or to the computer's own key on an encrypted disk. Either way, a copy of the computer's files is no use elsewhere.
Each administrator has their own
Your admin key is on your computer alone. A second administrator gets a key of their own, made on their own computer: a key is never copied from one computer to another. Keep your computer safe, and keep the recovery key apart from it. Several administrators
Replace your admin key
Do this if you think your key or its PIN may be known to someone else. The steps here are Windows'; on Linux, use the command.
- Open the network, then Administer, then Settings, and find Admin key.
- Choose Replace admin key…. Windows asks for permission, then MultiTunnel says what will happen.
- Type your current PIN. Windows then asks you to choose the new one.
Every device in the network learns of the new key, and the old one signs nothing more.
If the button says Use Windows' PIN prompt… instead, your key is one MultiTunnel itself asks the PIN for. Choosing it moves you to a new key behind Windows' own PIN prompt, so the PIN goes only to Windows.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
& $mt rotate-admin-key $st northwindsudo multitunnel rotate-admin-key /var/lib/multitunnel northwindThe recovery key
The recovery key can replace the network's administrators. It's shown once, when you create the network, and kept on no device.
Keep it safe and offline: printed and locked away, or on a USB stick in a safe. Anyone with it can take over the network.
We hold no keys to your network, so we can't recover it for you. Everything about recovery is done from the command line.
If something is lost
Pick what happened.
Your admin key or PIN may be known
Replace the admin key now, from the computer that holds it. Replace your admin key
& $mt rotate-admin-key $st northwindsudo multitunnel rotate-admin-key /var/lib/multitunnel northwindYou lost your admin computer
If the network has another administrator, they remove your lost computer from the network, from their own computer: its admin key goes with it. No recovery key is needed. A lost or stolen administrator's computer
If it was the only one, use the recovery key on another device that's already a member. That device becomes the only administrator, with a new admin key, and you get a new recovery key to keep. Any other administrators lose their role; they ask again if they are to stay administrators.
& $mt recover $st northwind "<recovery key file>"sudo multitunnel recover /var/lib/multitunnel northwind "<recovery key file>"You lost the recovery key
Make a new one now, on your admin computer, or any administrator's. The old one stops working: a network has one recovery key, whoever holds it. Put the new one somewhere safe and offline.
& $mt new-recovery $st northwindsudo multitunnel new-recovery /var/lib/multitunnel northwindYou lost both
If the network has another administrator, they can still look after it: they remove your lost computer, and make a new recovery key. If it hasn't, nobody can change the network again, and we can't help: we hold no keys. Its devices keep working until their memberships end, but nobody can be added, removed or approved. Create a new network, and invite everyone again. Create a network
The recovery key is on your admin computer
Some older networks keep it there. Move it off, onto a USB stick or paper you lock away:
& $mt export-recovery $st northwind -recovery-out E:\northwind-recovery.keysudo multitunnel export-recovery /var/lib/multitunnel northwind -recovery-out /media/usb/northwind-recovery.keyStill stuck?
Email us and a person will reply. For a security problem, write to security@multitunnel.co.uk instead.