Rotating SSH Keys
February 15, 2016
Rotating your SSH keys every once in a while is good digital hygiene.
Today, I rotated my SSH keys and configured GitHub to use these new keys. There were a few hangups along the way, but I think it was worth the trouble. Here’s the process:
Make a backup
Copy your existing SSH folder to temporary folder for safekeeping.
cp -a ~/.ssh ~/ssh-backup
Create a strong passphrase
Generate a strong passphrase for your new SSH key. I use 1Password to generate a nice, long passphrase with at least 2 digits and 2 symbols.
Create a new key pair
Create your new SSH key pair. If you already have a key named “id_rsa”, this will overwrite it.
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -C "comment describing key"
When prompted, enter the passphrase you generated earlier.
This was hangup #1. By default, my machine gives this new key permissions of 644 (User read+write, Group read, Other read). I want to change that to 600 (User read+write only) to avoid issues down the road. To change both id_rsa files to 600:
chmod 600 ~/.ssh/id_rsa*
Add new key to SSH agent and OS X Keychain
To make sure the SSH agent is running, first run:
eval "$(ssh-agent -s)"
To add the new SSH key pair to the SSH agent and to the Mac OS X Keychain, run:
ssh-add -K ~/.ssh/id_rsa
This was hangup #2. When I ran this, I was greeted with “ssh-add: illegal option – K”. It looks like my default “ssh-add” isn’t using the same version bundled with OS X. To get around this, I needed to specify the path to the correct version of “ssh-add”:
/usr/bin/ssh-add -K ~/.ssh/id_rsa
Add new key to GitHub
Add the public key to your GitHub account by following their Adding a new SSH key to your GitHub account instructions. Essentially, you’ll copy your key to your clipboard using:
pbcopy < ~/.ssh/id_rsa.pub
In the event that
pbcopy isn’t available, print the public key to the console for copy/pasting with:
Then you’ll be able to paste the key into your GitHub SSH Key page to enable your new key.
While you’re there, it’s a good opportunity to review any other SSH keys you have in GitHub and rotate/remove as needed.
Test new key’s access to GitHub
Verify you can login to Github with the new SSH key.
ssh -T email@example.com -i ~/.ssh/id_rsa
If the key works, you’ll be greeted with: “Hi <username>! You’ve successfully authenticated, but GitHub does not provide shell access.”
The backup folder you created at the start of this process holds your old SSH keys. Until you’ve confirmed that all of the services you connect to over SSH are working with your new key, hang onto the back up keys to be safe.←