Linux and Mac OS X both come with support for SSH and SSH keys out of the box. Launchpad uses SSH keys to authenticate your computer with your Launchpad account. This guide shows you how to get that done.
The first thing you need to do is generate your SSH keypair. A keypair, as the name implies, consists of 2 parts: the public key and the private key.
Your public key is placed on remote servers so that they can check back with you to see that you are who you say you are.
Your private key should NEVER leave your computer! This is the main file that authenticates you. It contains the special unique data that identifies you.
Generating a Keypair
Generating a keypair is very easy.
Open a terminal
Enter in the following in the terminal:
$ ssh-keygen -t rsa -b 4096
Accept the defaults, to save your public and private keys to ~/.ssh
Open your public key (~/.ssh/id_rsa.pub) in a text editor (GEdit or Kate on Linux, TextEdit on Mac OS X)
Launchpad & SSH
When you use Launchpad and Bazaar, it likes to use the SSH keys to authenticate you. We need to add our public key to Launchpad.
Adding Your Public Key to GitLab
Open your browser to GitLab and log in
Go to your home page and click on the ''Profile / Settings'' link
Click on the ''SSH Keys'' tab (Note: not the OpenPGP keys!)
Paste that public key into the text box at the bottom of the page
Click the ''Add Key'' button at the bottom of the page
And you're done!
More In Depth Example
This is specific to Mac OS X 10.6, but should be similar on any Mac or Linux system.
Change to hidden SSH folder $ cd ~/.ssh/
Generate a key ssh-keygen -t rsa -b 4096 Prompts for above are as follows, just hit enter for the file name, and then enter the password twice and you are done.
Enter file in which to save the key (/Users/username/.ssh/id_rsa): [Just Hit Enter]
Enter passphrase (empty for no passphrase): [Enter a unique password]
Enter same passphrase again: [Renter a unique password]
Make sure you remember your password you enter
Now you should have 2 new files in your folder, named id_rsa and id_rsa.pub which are your private and public keys respectively.
Set permissions on the keys you just created to be as restrictive as possible. chmod 400 id_rsa*
Modify the SSH config file to automatically use your just created key every time you connect to launchpad
Use your choice of text editor to edit ~/.ssh/config
sudo vi config
Hit i to enter insert mode
Add the following text to the bottom, where it says yourlaunchpdusername replace with your gitlab user name. ( to get yourgitlabname visit https://gitlab.com/~ and it will redirect to add your username to the url after the ~ )Host bazaar.launchpad.net IdentityFile ~/.ssh/id_rsa User yourgitlabusername
Copy the contents of your public key file on the Maccat ~/.ssh/id_rsa.pub | pbcopy Linux users or Mac users can alternatively open ~/.ssh/id_rsa.pub with your favourite text editor or omit pbcopy and just copy it after running the command cat ~/.ssh/id_rsa.pub.
Finally Edit your SSH keys on launchpad as described in Adding Your Public Key to GitLab above. ( you can click on This Link which will take you directly to the page to update your SSH keys on gitlab ). Make sure you are on SSH keys and not PGP keys here.