Diff for "YourAccount/CreatingAnSSHKeyPair"

Not logged in - Log In / Register

Differences between revisions 10 and 11
Revision 10 as of 2008-06-17 14:21:19
Size: 3149
Editor: localhost
Comment: converted to 1.6 markup
Revision 11 as of 2008-06-26 14:35:53
Size: 0
Editor: 201-250-153-169
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
~- [[FrontPage|Launchpad Help]] > [[YourAccount|Your account]] > [[YourAccount/CreatingAnSSHKeyPair|Importing your SSH key]] -~


||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||

= Why you need an SSH key =

The trust that other people put in your Launchpad identity is no more important than when they use code that you've uploaded to Launchpad.

An SSH key secures the connection between your computer and Launchpad while you're pushing Bazaar branches up to Launchpad.

To push code branches to Launchpad you first need to generate your SSH key. The key is made up of two parts: a private key that stays on your computer and a public key that you register with Launchpad. As you might expect, you shouldn't share the private key with anyone.

= Creating the key =

How you create your SSH key pair depends on which operating system you use.

If the instructions for your operating system are not here, [[Feedback|get in touch to request them]] or, if you know what to do, add them to this page.

== Linux/Cygwin ==

'''Step 1:''' Install OpenSSH. On Ubuntu, you can install OpenSSH by opening your terminal and typing:

```sudo apt-get install openssh-client```

'''Step 2:''' Once OpenSSH is installed, stay in the terminal and type:

```ssh-keygen -t rsa```

'''Step 3:''' When prompted, press ```Enter``` to accept the default file name for your key.

'''Step 4:''' Next, enter then confirm a password to protect your SSH key. Your key pair is stored in ~/.ssh/ as id_rsa.pub (public key) and id_rsa (private key)

Now you need to upload the public portion of your SSH key to Launchpad.

== Windows (PuTTY) ==

'''Step 1:''' Download the PuTTY Key Generator from here: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

'''Step 2:''' Run puttygen.exe and click the generate button. PuTTYGen will ask you to move your mouse around in the blank area to generate entropy.

'''Step 3:''' Set a key passphrase and confirm it.

'''Step 4:''' Click "Save public key" and choose a location to save it. Click "Save private key" and choose a secure location to save it. '''You must keep this secret key safe!'''

<<Anchor(register)>>
= Registering the key with Launchpad =

'''Step 1:''' Open your public key in a text editor and copy its contents to your clipboard. The public key file has the extension ```.pub```. For example: ```id_rsa.pub```

'''Step 2:''' Visit [[https://launchpad.net/people/+me/+editsshkeys|your SSH keys page]].

'''Step 3:''' Paste your public key into the text box and then click the ```Import public key``` button to continue.

= Next step =

We're almost done setting up your Launchpad account! Before we explore more of Launchpad, let's look at one of the ways it helps other people to see your involvement in free software: [[YourAccount/Karma|karma]]!

||<tablestyle="border: 0; width: 100%;"> ~-[[YourAccount/ImportingYourPGPKey|< Importing your PGP key]] -~ ||<style="text-align: right;"> ~- [[YourAccount/Karma|Understanding karma >]] -~ ||

YourAccount/CreatingAnSSHKeyPair (last edited 2018-10-05 20:12:12 by cjwatson)