HTTP/2 302 server: nginx date: Wed, 30 Jul 2025 23:30:47 GMT content-type: text/plain; charset=utf-8 content-length: 0 x-archive-redirect-reason: found capture at 20081218070050 location: https://web.archive.org/web/20081218070050/https://github.com/guides/providing-your-ssh-key.atom server-timing: captures_list;dur=0.513285, exclusion.robots;dur=0.018444, exclusion.robots.policy;dur=0.008386, esindex;dur=0.011681, cdx.remote;dur=12.052167, LoadShardBlock;dur=201.404039, PetaboxLoader3.datanode;dur=49.458802, PetaboxLoader3.resolve;dur=119.536556 x-app-server: wwwb-app220 x-ts: 302 x-tr: 240 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 set-cookie: SERVER=wwwb-app220; path=/ x-location: All x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() HTTP/2 200 server: nginx date: Wed, 30 Jul 2025 23:30:48 GMT content-type: application/atom+xml; charset=utf-8 content-length: 437716 x-archive-orig-server: nginx/0.6.31 x-archive-orig-date: Thu, 18 Dec 2008 07:00:45 GMT x-archive-orig-connection: close x-archive-orig-status: 200 OK x-archive-orig-x-runtime: 2254ms x-archive-orig-etag: "a43e48d5e76408bbd3771879731650f1" x-archive-orig-cache-control: private, max-age=0, must-revalidate x-archive-orig-content-length: 437716 cache-control: max-age=1800 x-archive-guessed-content-type: text/xml x-archive-guessed-charset: utf-8 memento-datetime: Thu, 18 Dec 2008 07:00:50 GMT link: ; rel="original", ; rel="timemap"; type="application/link-format", ; rel="timegate", ; rel="first memento"; datetime="Thu, 18 Sep 2008 23:33:28 GMT", ; rel="prev memento"; datetime="Sun, 16 Nov 2008 13:04:11 GMT", ; rel="memento"; datetime="Thu, 18 Dec 2008 07:00:50 GMT", ; rel="next memento"; datetime="Tue, 17 Feb 2009 10:32:34 GMT", ; rel="last memento"; datetime="Sun, 19 Apr 2009 05:53:22 GMT" content-security-policy: default-src 'self' 'unsafe-eval' 'unsafe-inline' data: blob: archive.org web.archive.org web-static.archive.org wayback-api.archive.org athena.archive.org analytics.archive.org pragma.archivelab.org wwwb-events.archive.org x-archive-src: 52_7_20081218050422_crawl107-c/52_7_20081218065931_crawl103.arc.gz server-timing: captures_list;dur=0.493806, exclusion.robots;dur=0.019148, exclusion.robots.policy;dur=0.009054, esindex;dur=0.011511, cdx.remote;dur=18.824916, LoadShardBlock;dur=288.574124, PetaboxLoader3.datanode;dur=238.469042, PetaboxLoader3.resolve;dur=227.342919, load_resource;dur=227.289759 x-app-server: wwwb-app220 x-ts: 200 x-tr: 584 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 x-location: All x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() accept-ranges: bytes tag:github.com,2008:/guides/providing-your-ssh-key 2008-12-15T19:51:07-08:00 tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-12-15T19:51:07-08:00 Mon Dec 15 19:51:07 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry (ssh-add ~/.ssh/id_rsa).</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser. If you have xclip installed then:</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | xclip</span></code></pre> <p>The <code>xclip</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key! If you don&#8217;t have xclip then either install it using your OS&#8217;s package manager or print out the publick key to a terminal so that you can manually copy the key data.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</code></pre> Then enter a passphrase if you wish (it is generally recommended that you do not use a passphrase) and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> tekkub tekkub@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-12-04T12:47:20-08:00 Thu Dec 04 12:47:20 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry (ssh-add ~/.ssh/id_rsa).</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser. If you have xclip installed then:</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | xclip</span></code></pre> <p>The <code>xclip</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key! If you don&#8217;t have xclip then either install it using your OS&#8217;s package manager or print out the publick key to a terminal so that you can manually copy the key data.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</code></pre> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-11-27T16:12:54-08:00 Thu Nov 27 16:12:54 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry (ssh-add ~/.ssh/id_rsa).</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser. If you have xclip installed then:</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | xclip</span></code></pre> <p>The <code>xclip</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key! If you don&#8217;t have xclip then either install it using your OS&#8217;s package manager or print out the publick key to a terminal so that you can manually copy the key data.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> gravious gravious@jollyrotten.org tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-11-27T16:09:22-08:00 Thu Nov 27 16:09:22 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry (ssh-add ~/.ssh/id_rsa).</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser. If you have xclip installed then</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | xclip</span></code></pre> <p>The <code>xclip</code> command copies whatever is sent to it via <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key! If you don&#8217;t have xclip, either install it using your OS&#8217;s package manager or dump it to a terminal so that you can manually copy the key data.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> gravious gravious@jollyrotten.org tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-11-25T04:46:11-08:00 Tue Nov 25 04:46:11 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry (ssh-add ~/.ssh/id_rsa).</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> nicholasng camelng@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-11-19T14:33:07-08:00 Wed Nov 19 14:33:07 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry (ssh-add ~/.ssh/id_rsa).</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> JimW jim@videopassage.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-10-30T19:25:18-07:00 Thu Oct 30 19:25:18 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a <code>config</code> file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> idearise roberto.rabe@idearise.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-10-30T19:24:38-07:00 Thu Oct 30 19:24:38 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <p>I needed to create a config file in the .ssh directory containing the following to point to the relevant IdentityFile:</p> <pre class="console"><code> Host github.com User git Port 22 Hostname github.com IdentityFile ~/.ssh/id_rsa TCPKeepAlive yes IdentitiesOnly yes </code></pre> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> idearise roberto.rabe@idearise.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-09-13T21:41:50-07:00 Sat Sep 13 21:41:50 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. (REALLY?) Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> gregc gjc3@calvin.edu tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-09-03T16:40:12-07:00 Wed Sep 03 16:40:12 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere, usually in your user folder <code>c:\Documents and Settings\Username\.ssh</code> on XP or <code>c:\Users\Username\.ssh</code> on Vista. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you should add to your account on github. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit..</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> tekkub tekkub@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-08-16T09:46:21-07:00 Sat Aug 16 09:46:21 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_rsa git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> eagereyes robert@eagereyes.org tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-08-16T09:45:33-07:00 Sat Aug 16 09:45:33 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_dsa git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> eagereyes robert@eagereyes.org tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-07-15T18:52:19-07:00 Tue Jul 15 18:52:19 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 <key_name>.pub&#8217; after creation.</li> <li>`ssh-add <key_name>&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_dsa.pub git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> reednj reednj@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-07-02T04:25:28-07:00 Wed Jul 02 04:25:28 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h3>Problems?</h3> <p>The steps above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 id_dsa.pub&#8217; after creation.</li> <li>`ssh-add&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_dsa.pub git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> msp info@radialsolutions.co.uk tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-07-02T04:24:18-07:00 Wed Jul 02 04:24:18 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <p><b>Problems?</b> &#8211; The above didn&#8217;t work for me. I found that this <a href="https://www.cs.indiana.edu/csg/FAQ/Security/openssh.html">openssh guide</a> helped me out. The missing parts (i think) were:</p> <ol> <li>`chmod 600 id_dsa.pub&#8217; after creation.</li> <li>`ssh-add&#8217; in my shell.</li> </ol> <p>I debugged the connection by just trying a pure ssh connection to github:</p> <p>`ssh -vi ~/.ssh/id_dsa.pub git@github.com&#8217;</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> msp info@radialsolutions.co.uk tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-05-23T15:49:02-07:00 Fri May 23 15:49:02 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Microsoft Windows using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-05-22T16:39:20-07:00 Thu May 22 16:39:20 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> cleitonfco cleitonfco@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-05-22T16:29:52-07:00 Thu May 22 16:29:52 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.chiark.greenend.org.uk/_{sgtatham/putty/download.html&#8221;&gt;PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.chiark.greenend.org.uk/}sgtatham/putty/download.html&#8221;&gt;Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> cleitonfco cleitonfco@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-17T22:21:44-07:00 Thu Apr 17 22:21:44 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit. <span class="caps">NOTE</span>: Git <span class="caps">GUI</span> can not yet upload to Github unless you set up ssh to upload key for you. Best to use the Git command line.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T23:39:38-07:00 Tue Apr 15 23:39:38 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <h3>Step 1</h3> <p>Get the Git version of mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">Git-(version).exe</a> It’s a small download and installs just by double clicking the download. msysGit is a full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T23:37:25-07:00 Tue Apr 15 23:37:25 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <h3>Step 1</h3> <p>Get mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">https://code.google.com/p/msysgit/downloads/list</a> It’s a small download and installs just by double clicking the download. It&#8217;s full featured environment for working with Git under windows.</p> <h3>Step 2</h3> <p>Run Git Bash program</p> <h3>Step 3</h3> Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4</h3> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T23:35:17-07:00 Tue Apr 15 23:35:17 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <h3>Step 1 Get mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">https://code.google.com/p/msysgit/downloads/list</a> It’s a small download and installs just by double clicking the download. It&#8217;s full featured environment for working with Git under windows.</h3> <h3>Step 2 Run Git Bash program</h3> h3. Step 3 Then create a ssh key by typing: <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> Then enter password twice and when prompted for the name of file for the key leave blank and press enter <h3>Step 4 Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Use windows search if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</h3> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T23:12:54-07:00 Tue Apr 15 23:12:54 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <p>Get mysGit at: <a href="https://code.google.com/p/msysgit/downloads/list">https://code.google.com/p/msysgit/downloads/list</a> It’s a small download and installs just by double clicking the download. It&#8217;s great for working with Git under windows.</p> <p>Run Git Bash program</p> <p>Then create a ssh key by typing:</p> <pre class="console"><code>ssh-keygen -C “username@email.com” -t rsa</pre></code> <p>Then enter password twice and when prompted for the name of file for the key leave blank and press enter</p> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Search for it if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T23:08:28-07:00 Tue Apr 15 23:08:28 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> <li><a href="#windowsxp">Windows using PuTTYgen</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <p>Get mysGit at: https://code.google.com/p/msysgit/downloads/list It’s a small download and installs just by double clicking the download. It&#8217;s great for working with Git under windows.</p> <p>Run Git Bash program</p> <p>Then create a ssh key by typing:</p> <p>ssh-keygen -C “username@email.com” -t rsa</p> <p>Then enter password twice and when prompted for the name of file for the key leave blank and press enter</p> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Search for it if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</p> <h2 id="windowsxp">Microsoft Windows using PuTTYgen</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T22:58:46-07:00 Tue Apr 15 22:58:46 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> <li><a href="#msysGit">Windows using msysGit</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <p>Get mysGit at: https://code.google.com/p/msysgit/downloads/list It’s a small download and installs just by double clicking the download. It&#8217;s great for working with Git under windows.</p> <p>Run Git Bash program</p> <p>Then create a ssh key by typing:</p> <p>ssh-keygen -C “username@email.com” -t rsa</p> <p>Then enter password twice and when prompted for the name of file for the key leave blank and press enter</p> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Search for it if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T22:58:13-07:00 Tue Apr 15 22:58:13 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a> *<a href="#msysGit">Windows using msysGit</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="msysGit">Create key using msysGit</h2> <p>Get mysGit at: https://code.google.com/p/msysgit/downloads/list It’s a small download and installs just by double clicking the download. It&#8217;s great for working with Git under windows.</p> <p>Run Git Bash program</p> <p>Then create a ssh key by typing:</p> <p>ssh-keygen -C “username@email.com” -t rsa</p> <p>Then enter password twice and when prompted for the name of file for the key leave blank and press enter</p> <p>Look at the output and it will hint at where the key is stored. It’s stored in a .ssh folder somewhere. The file with the public key is “id_rsa.pub”. Search for it if you can’t find it. Then open it with notepad and copy the text. That is the public key you give to others and hosting sites. Leave the files where they are. Running ssh-keygen sets up the keys for both Git Bash and Git <span class="caps">GUI</span> that all come part of msysGit.</p> sarpulhu sarpulhu@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T15:54:31-07:00 Tue Apr 15 15:54:31 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> josephholsten joseph@josephholsten.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-04-15T15:52:42-07:00 Tue Apr 15 15:52:42 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. You copy from the command line using pbcopy.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> josephholsten joseph@josephholsten.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-13T10:41:51-07:00 Thu Mar 13 10:41:51 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> adakkak adakkak@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-09T15:17:26-07:00 Sun Mar 09 15:17:26 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre class="console"><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-09T15:15:22-07:00 Sun Mar 09 15:15:22 -0700 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre class="console"><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-06T15:22:52-08:00 Thu Mar 06 15:22:52 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool, provided by the <a href="https://www.putty.org/">PuTTY project</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatever you like, just remember where it&#8217;s at, because you&#8217;ll have to set it up in <a href="https://www.putty.org/">Pageant</a> later.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> vertiginous gthiesfeld@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-06T15:18:23-08:00 Thu Mar 06 15:18:23 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1 \ If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool. You can download it from the <a href="https://www.chiark.greenend.org.uk/_{sgtatham/putty/download.html&#8221;&gt;PuTTy download page</a>. There is also an installer available that includes all of the PuTTY tools. \ h3. Step 2</h3> Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window. \\ Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatevr you like, just remember where it&#8217;s at, because you&#8217;ll have to tell git about it later. The passphrase that you enter will be requested from you every time you push or pull from a private repo. You can get pageant.exe from the <a href="https://www.chiark.greenend.org.uk/}sgtatham/putty/download.html&#8221;&gt;PuTTy download page</a> to automate password entry. \\ <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key! You can also save the public key if you&#8217;d like to use it elsewhere.</p> vertiginous gthiesfeld@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-06T15:11:23-08:00 Thu Mar 06 15:11:23 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a> (to be added)</li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool. You can download it from the <a href="https://www.chiark.greenend.org.uk/sgtatham/putty/download.html">PuTTy download page</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatevr you like, just remember where it&#8217;s at, because you&#8217;ll have to tell git about it later. The passphrase that you enter will be requested from you every time you push or pull from a private repo. You can get pageant.exe from the <a href="https://www.chiark.greenend.org.uk/sgtatham/putty/download.html">PuTTy download page</a> to automate password entry.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key! You can also save the public key if you&#8217;d like to use it elsewhere.</p> vertiginous gthiesfeld@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-06T15:10:04-08:00 Thu Mar 06 15:10:04 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a> (to be added)</li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool. You can download it from the <a href="https://www.chiark.greenend.org.uk/_{sgtatham/putty/download.html&#8221;&gt;PuTTy download page</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatevr you like, just remember where it&#8217;s at, because you&#8217;ll have to tell git about it later. The passphrase that you enter will be requested from you every time you push or pull from a private repo. You can get pageant.exe from the <a href="https://www.chiark.greenend.org.uk/}sgtatham/putty/download.html&#8221;&gt;PuTTy download page</a> to automate password entry.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key! You can also save the public key if you&#8217;d like to use it elsewhere.</p> vertiginous gthiesfeld@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-03-06T15:06:05-08:00 Thu Mar 06 15:06:05 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a> (to be added)</li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <h3>Step 1</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the PuTTYgen tool. You can download it from the <a href="https://www.chiark.greenend.org.uk/_{sgtatham/putty/download.html&#8221;&gt;PuTTy download page</a>. There is also an installer available that includes all of the PuTTY tools.</p> <h3>Step 2</h3> <p>Start PuTTYgen, and press the &#8220;Generate&#8221; button. PuTTYgen will prompt you to &#8220;generate some randomness by moving the mouse over the blank area&#8221;. Once this is done, a new public key will be displayed at the top of the window.</p> <p>Enter in a key passphrase and confirm it in the appropriate boxes, then save your private key to a file. You can call the file whatevr you like, just remember where it&#8217;s at, because you&#8217;ll have to tell git about it later. The passphrase that you enter will be requested from you every time you push or pull from a private repo. You can get pageant.exe from the <a href="https://www.chiark.greenend.org.uk/}sgtatham/putty/download.html&#8221;&gt;PuTTy download page</a> to automate password entry.</p> <h3>Step 3</h3> <p>Highlight the public key at the top of the page, and copy it to the clipboard . Now you can simply select the appropriate text entry box in GitHub and paste in your public key! You can also save the public key if you&#8217;d like to use it elsewhere.</p> vertiginous gthiesfeld@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-02-24T00:41:33-08:00 Sun Feb 24 00:41:33 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowsxp">Windows XP</a> (to be added)</li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <p>to be added.</p> xuejm heidan@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-02-24T00:40:49-08:00 Sun Feb 24 00:40:49 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowxp">Windows XP</a> (to be added)</li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="windowsxp">Microsoft Windows XP</h2> <p>to be added.</p> xuejm heidan@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-02-24T00:39:37-08:00 Sun Feb 24 00:39:37 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windowxp">Windows XP</a> (to be added)</li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> xuejm heidan@gmail.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-02-18T12:01:29-08:00 Mon Feb 18 12:01:29 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH"><span class="caps">SSH</span></a> to authenticate you during git&#8217;s push and pull commands. In order for GitHub to identify you, you must provide us with your <span class="caps">SSH</span> public key. The rest of this page contains instructions on how to locate or create a set of <span class="caps">SSH</span> keys.</p> <ul> <li><a href="#macosx">Mac <span class="caps">OS X</span></a></li> <li><a href="#linux">Linux</a></li> </ul> <h2 id="macosx">Mac <span class="caps">OS X</span></h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></code></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><code><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</code></pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</code></pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><code><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</code></pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-01-28T09:33:09-08:00 Mon Jan 28 09:33:09 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH">SSH</a> to authenticate you during git's push and pull commands. In order for GitHub to identify you, you must provide us with your SSH public key. The rest of this page contains instructions on how to locate or create a set of SSH keys.</p> <ul> <li><a href="#macosx">Mac OS X</a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windows">Windows</a></li> </ul> <h2 id="macosx">Mac OS X</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. The <code>something</code> file is your private key and must be kept secret. The <code>something.pub</code> file is your public key, and this is what you&#8217;ll be giving us. If you already have a key pair (in the above listing I have an <code>id_rsa</code> key pair) and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-01-27T17:04:03-08:00 Sun Jan 27 17:04:03 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH">SSH</a> to authenticate you during git's push and pull commands. In order for GitHub to identify you, you must provide us with your SSH public key. The rest of this page contains instructions on how to locate or create a set of SSH keys.</p> <ul> <li><a href="#macosx">Mac OS X</a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windows">Windows</a></li> </ul> <h2 id="macosx">Mac OS X</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. Never ever send the <code>something</code> key to anybody. That is your private key and must be kept secret. You can send the <code>something.pub</code> key as far and wide as you like. If you already have a key pair and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. Never ever send the <code>something</code> key to anybody. That is your private key and must be kept secret. You can send the <code>something.pub</code> key as far and wide as you like. If you already have a key pair and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com tag:github.com,2008:Guide/1 2008-01-27T16:08:37-08:00 2008-01-27T17:03:12-08:00 Sun Jan 27 17:03:12 -0800 2008 <h2>Overview</h2> <p>GitHub uses <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public-key cryptography</a> and <a href="https://en.wikipedia.org/wiki/SSH">SSH</a> to authenticate you during git's push and pull commands. In order for GitHub to identify you, you must provide us with your SSH public key. The rest of this page contains instructions on how to locate or create a set of SSH keys.</p> <ul> <li><a href="#macosx">Mac OS X</a></li> <li><a href="#linux">Linux</a></li> <li><a href="#windows">Windows</a></li> </ul> <h2 id="macosx">Mac OS X</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. Never ever send the <code>something</code> key to anybody. That is your private key and must be kept secret. You can send the <code>something.pub</code> key as far and wide as you like. If you already have a key pair and you want to use it for GitHub, then skip to <a href="#macosx-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><span>[~/.ssh]</span>$ <span class="command">ssh-keygen</span> Generating public/private rsa key pair. Enter file in which to save the key (/Users/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /Users/tom/.ssh/id_rsa. Your public key has been saved in /Users/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="macosx-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub | pbcopy</span></pre> <p>The <code>pbcopy</code> command copies whatever is sent to it on <span class="caps">STDIN</span> to the clipboard, ensuring that you won&#8217;t have any extraneous newlines or other problems. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> <h2 id="linux">Linux</h2> <h3>Step 1</h3> <p>Check to see if you already have a public/private key pair for your user. If you do, it will be in your <code>~/.ssh</code> directory.</p> <pre><span>[~]</span>$ <span class="command">cd .ssh</span> <span>[~/.ssh]</span>$ <span class="command">ls</span> config id_rsa.pub id_rsa known_hosts</pre> <p>Key pairs are always named like <code>something</code> and <code>something.pub</code>. Never ever send the <code>something</code> key to anybody. That is your private key and must be kept secret. You can send the <code>something.pub</code> key as far and wide as you like. If you already have a key pair and you want to use it for GitHub, then skip to <a href="#linux-3">Step 3</a>.</p> <h3>Step 2</h3> <p>If you don&#8217;t have any keys yet, then you&#8217;ll need to generate them. This can be done with the <code>ssh-keygen</code> program.</p> <pre><span>[~/.ssh]</span>$ <span class="command">ssh-keygen -t rsa</span> Generating public/private rsa key pair. Enter file in which to save the key (/home/tom/.ssh/id_rsa): <span class="command">&lt;enter&gt;</span> Enter passphrase (empty for no passphrase): <span class="command">&lt;enter password&gt;</span> Enter same passphrase again: <span class="command">&lt;enter password again&gt;</span> Your identification has been saved in /home/tom/.ssh/id_rsa. Your public key has been saved in /home/tom/.ssh/id_rsa.pub. The key fingerprint is: 50:43:77:c6:97:af:61:82:dc:ea:9b:6b:67:d4:1b:61 tom@volcano</pre> <p>You are free to name your key pair whatever you like. Just make sure you copy the correct public key in the next step. The password that you enter will be requested from you every time you push or pull from a private repo. You can use <code>ssh-agent</code> or the built-in keychain support in Leopard to automate password entry.</p> <h3 id="linux-3">Step 3</h3> <p>Copy your public key to the clipboard so you can easily paste it into your web browser.</p> <pre><span>[~/.ssh]</span>$ <span class="command">cat id_rsa.pub</span> ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1FlHRbbxXIv/hLDTeJczlEqGNt0oFcoPEEENHThzP5ku PDsitSSUH2MATP014G/3BzaI9pdnhf02MSEcmtmIKXrm05/dzxEmp9yOY32YHyk6/rLUGGTJuWOpGt3J 6H5LWxq9yeRUuFG/pCRH3+KxOyzasSHXfXJaC5v7wPxUdAeg9k0jwsUjnqUcYvzo5+GwCXV9dIwY3Sr/ OrL2l8SCdSWyd3PLufJXKQHlouHB0NI/+G/QjWmkB8c1PJh/VuIe36mqv82V9XXKvYNaVWwz5Sg6aY9u p2lgDEme+AFdPPjOnkdF6OHCr7ymKg6c/B2YCbOW7QN/L4uAdVOhTNnJMQ== tom@volcano</pre> <p>Copy the entirety of the public key to the clipboard. It is important that there are no newlines in the key (copying from the <code>cat</code> output in your console should work properly. Now you can simply select the appropriate text entry box in GitHub and paste in your public key!</p> mojombo tom@mojombo.com