Overview
Tunnlr uses the SSH protocol to establish a secure, encrypted connection between your personal machine and our server. In place of a password that must be typed each time, SSH can use public-key cryptography to ensure that only you may connect to Tunnlr.
Instructions
-
Have a key already? Look in your ~/.ssh directory:
ls ~/.ssh
If you have a key, it will be in two files named identity and identity.pub (the actual name may differ slightly). The identity file is your private key. Never give this one out. The identity.pub file is your public key. This is the key we need. If you already have a key pair, skip to Step 3.
-
Create one if necessary with the command:
ssh-keygen -t dsa
You will be prompted for a key name (id_dsa by default) and an optional passphrase. If you enter a passphrase, SSH will ask you for it each time you use the key. Mac OS X Leopard will add the passphrase to your keychain for you. If you aren't running Leopard, you can use the ssh-agent command-line tool or a variety of third-party tools to keep from having to enter a passphrase.
-
Copy your public key to the clipboard.
Mac users: cat <my_key>.pub | pbcopy
Linux users: just type cat <my_key>.pub, highlight and copy the resulting text by hand.
Paste it into the "Authorized keys" box on your Tunnlr account page, and click Set Password.
Download PuTTYgen from the PuTTY project home page.
Generate a key. Launch PuTTYgen and press the Generate button. Follow the instructions. A new public key will be displayed at the top of the window. Enter a passphrase and confirm it, then save your key to a file.
Copy your public key to the clipboard. Highlight the public key at the top of the page, and copy. Paste it into the "Authorized keys" box on your Tunnlr account page, and click Set Password.