MultiTunnel Contact us

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.

  1. Open the network, then Administer, then Settings, and find Admin key.
  2. Choose Replace admin key…. Windows asks for permission, then MultiTunnel says what will happen.
  3. 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

Windows
& $mt rotate-admin-key $st northwind
Linux
sudo multitunnel rotate-admin-key /var/lib/multitunnel northwind

The 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

Windows
& $mt rotate-admin-key $st northwind
Linux
sudo multitunnel rotate-admin-key /var/lib/multitunnel northwind

You 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.

Windows
& $mt recover $st northwind "<recovery key file>"
Linux
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.

Windows
& $mt new-recovery $st northwind
Linux
sudo multitunnel new-recovery /var/lib/multitunnel northwind

You 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:

Windows
& $mt export-recovery $st northwind -recovery-out E:\northwind-recovery.key
Linux
sudo multitunnel export-recovery /var/lib/multitunnel northwind -recovery-out /media/usb/northwind-recovery.key

Still stuck?

Email us and a person will reply. For a security problem, write to security@multitunnel.co.uk instead.

enquiries@multitunnel.co.uk