Invite and approve
Make an invite, send it to the person, then approve the reply code their device sends back, once its fingerprint matches.
Invite and approve, step by step
Here Sam, who looks after Northwind Clinic, invites Dana and approves her laptop. Use Next, or click what's highlighted.
Invite someone
Open the network. On an administrator's computer, its page has Administer Northwind Clinic. Choose Invite or approve.
Who, and for how long
Under Who is it for?, choose the person, or Anyone to have them type their name when they join. Choose how long it works: 1, 8 or 24 hours, and under Where are they?, whether they're On the same Wi-Fi or office network as this computer or Somewhere else. Then choose Make the invite and copy it….
For someone at home or in another office, choose Somewhere else. Inviting someone somewhere else
Add someone under People first to invite them by name: their device then joins as them. For a server, gateway, relay or kiosk, choose its service here. Set up a server as a service
Windows asks
Windows asks for permission. Choose Yes.
Send the invite
The invite is copied as a link,
https://multitunnel.co.uk/join#mt2:…. Paste it into an email or a message to the person, and send it. Opening it fills in MultiTunnel's Join screen on their device, or, if they don't have MultiTunnel yet, shows them how to get it. MultiTunnel clears it from the clipboard after 10 minutes.For a phone in the same room, choose Show the QR code instead, and let the phone's camera scan it. Inviting a phone with a QR code
An invite is a secret until it's used: send it only to the person it's for.
Paste their reply code
Their device shows a reply code, which they send you. Paste it under Approve a device. The device's name and fingerprint appear.
Check the fingerprint
Ask the person to read out the fingerprint on their screen. Go on only if it matches. Then choose Approve….
If your invite didn't name them, type their name first, and tick They're new if they aren't under People yet. A device that joins for a service says so here: unless the invite was for the service, type the service's name.
Go ahead?
Windows asks for permission. Then MultiTunnel shows the device and its fingerprint again. Check them, and choose Yes.
Your PIN
Windows asks for your admin PIN, in its own window, so the PIN goes only to Windows.
Approved
The device joins within a minute, by itself. The person's window says You're in.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
Make an invite for a person, working for 8 hours, as when you leave out -hours (24 is the most). Leave out -for for anyone, and add -at elsewhere for someone somewhere else.
& $mt invite $st northwind -for dana -hours 8sudo multitunnel invite /var/lib/multitunnel northwind -for dana -hours 8Approve from the reply code. Add their username if the invite didn't name them, and -new-user for someone not yet in the network.
& $mt approve $st northwind "<paste the reply code here>"sudo multitunnel approve /var/lib/multitunnel northwind "<paste the reply code here>"Or approve by the device's name and fingerprint:
& $mt approve $st northwind dana-laptop 4c1e-9b27-a03fsudo multitunnel approve /var/lib/multitunnel northwind dana-laptop 4c1e-9b27-a03fEither way, approve shows the device's fingerprint before it asks anything or asks for your PIN: check it matches the one on the device's screen, as in the app.
For a service, invite with -for "service:File server"; a device that joined for a service without such an invite is approved with -service "File server". Set up a server as a service
Inviting a phone with a QR code
An invite is a link, and the phone's camera can read it from your screen. Nothing needs copying onto the phone.
- Make the invite as above. Under the steps, choose Show the QR code.
- The person points their phone's camera at the code, and opens the link it finds. With MultiTunnel on the phone, it opens at Join a network with the invite filled in. Without it, the link's page says how to get MultiTunnel first.
- Choose Hide the QR code once their phone has scanned it. Anyone who can see the code can use the invite, so don't leave it on screen, and don't share a picture of it. When the invite ends, the code goes by itself.
- They join on the phone as usual, and send you the reply code it shows. Approve it under Approve a device. Join on an Android phone
- Opening the link only fills in the invite. The person still reads what joining means and asks to join, and you still approve their phone.
- The phone says the invite came from a link, and names the network it says it's for, so they ask to join only if they were expecting it from you.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
At a terminal, invite prints the link and, under it, a QR code of the link for a phone's camera. If the window is too small for the code, it says how large to make it: make the window larger and run it again, or use Show the QR code in the app. Piped into another program or a file, it prints the invite alone.
& $mt invite $st northwind -for dana -hours 1sudo multitunnel invite /var/lib/multitunnel northwind -for dana -hours 1Inviting someone somewhere else
A new device first contacts the computer that made the invite. Someone on the same Wi-Fi or office network reaches it there. For someone at home, or in another office, choose Somewhere else under Where are they? when you make the invite.
If this computer can be reached from anywhere
If it has a public internet address of its own, such as a server, the invite uses that address.
Otherwise, your router lets them in for a while
MultiTunnel asks this computer's router to let their device in, on two ports for this network only, and only while the invite lasts. About a minute after the invite ends, it closes them again. At the command line, it says which ports it opened and until when.
Who can reach those ports
While they're open, anyone on the internet can reach those two ports, but MultiTunnel answers only devices it knows, and stays silent to everything else. If MultiTunnel stops without closing them, such as in a power cut, the router closes them by itself within 2 hours.
When the router won't let them in
Then no invite is made, because their device could never get through. MultiTunnel says why, in plain words:
- the router didn't answer (it may not offer this, or has it turned off);
- the router refused;
- the router opened only one of the two ports it needs;
- this computer is behind a second router, often the internet provider's own, which can't be asked.
It also says what would work instead. Do one of these:
- Make the invite on a device people can reach from anywhere, such as one of the network's servers with a public address, at its command line, then approve the reply code on your computer as usual. If the network has a relay, MultiTunnel names it.
- Forward the two ports. Ask whoever looks after this computer's router to forward the two UDP ports MultiTunnel names to this computer. Then make the invite at the command line, with
-atand your public address.
If it says the router is still being asked, try again in a moment. Someone on the same Wi-Fi or office network as this computer can always join with an ordinary invite.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
An invite for someone somewhere else:
& $mt invite $st northwind -for dana -at elsewheresudo multitunnel invite /var/lib/multitunnel northwind -for dana -at elsewhereIf your router already forwards the two ports, give your public address. If it's their computer that can be reached instead, give their public address and an even port from 40000 to 59998 with -to.
& $mt invite $st northwind -for dana -at 203.0.113.10sudo multitunnel invite /var/lib/multitunnel northwind -for dana -at 203.0.113.10& $mt invite $st northwind -for dana -to 198.51.100.24:40000sudo multitunnel invite /var/lib/multitunnel northwind -for dana -to 198.51.100.24:40000The addresses here are examples: use your own.
A device coming back
When a device that was a member before joins again, its old access went with its old keys, so it gets only what the rules give its person. To give it what it had, tick Give it the same access as before when you approve it. The window then lists what it gets back before you type your PIN.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
& $mt approve $st northwind "<paste the reply code here>" -same-accesssudo multitunnel approve /var/lib/multitunnel northwind "<paste the reply code here>" -same-accessLetting people add their own devices
- Open Administer, then Settings, and find Adding devices.
- Choose People can add some of their own devices, and how many each person can add.
- Choose Save….
From a device you approved, a person can then add a new phone or laptop of their own, without asking you. Each added device ends when the one that added it does. You can still approve more for anyone. Choose Only administrators approve devices to turn it off.
The person adds a device from the command line: they make an invite on their approved device, join with the new one, and approve its reply code on the first.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
For you, as administrator:
& $mt self-enrol $st northwind on 3sudo multitunnel self-enrol /var/lib/multitunnel northwind on 3& $mt self-enrol $st northwind offsudo multitunnel self-enrol /var/lib/multitunnel northwind offFor the person: on their approved device, make an invite (on Windows, in their own Terminal, not as administrator):
& $mt invite $st northwindsudo multitunnel invite /var/lib/multitunnel northwindOn the new device, join with it, as themselves (on Linux, without sudo):
& $mt join $st auto dana-phone "<paste the invite here>"multitunnel join /var/lib/multitunnel auto dana-phone "<paste the invite here>"Back on the first device, approve the reply code. On Windows this needs Terminal (Admin), as MultiTunnel's state folder is open only to administrators:
& $mt approve $st northwind "<paste the reply code here>"sudo multitunnel approve /var/lib/multitunnel northwind "<paste the reply code here>"Letting a device approve for a day
A delegation lets a trusted device approve devices for the people you name, for up to 24 hours, such as during a setup day. It is a paid feature, and is done from the command line.
Command line
On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start
Let reception-pc approve up to 10 devices for two people, for 8 hours:
& $mt delegate $st northwind reception-pc 8 10 dana,leesudo multitunnel delegate /var/lib/multitunnel northwind reception-pc 8 10 dana,leeEnd it early:
& $mt undelegate $st northwind reception-pcsudo multitunnel undelegate /var/lib/multitunnel northwind reception-pcEnd it, and remove the delegate and every device it added (it shows the list first):
& $mt revoke-delegate $st northwind reception-pcsudo multitunnel revoke-delegate /var/lib/multitunnel northwind reception-pcStill stuck?
Email us and a person will reply. For a security problem, write to security@multitunnel.co.uk instead.