September 12, 2015 . Coding . Comments
Tags: SSHGit
Deleting a Repo from SourceTree. Since this was just a test repo, I'll delete it from my machine. Right click on the bookmark; Select 'Delete' (When you do that, you'll be asked whether you'd just like to remove the bookmark from SourceTree and leave the repo on your machine, or also move the repo to the Trash. The goal of this article is to guide users to generate and load SSH keys into SourceTree using PuTTY. To generate an SSH Key, select Tools Create or Import SSH Keys. This window should pop up: 2. Click Generate, and move the mouse randomly until a key is generated: 3. A public key and a private key should appear. Sourcetree refers to copying a repository as 'cloning' it. When you clone a repository, you create a connection between the Bitbucket server and your local system. How to Setup SSH with SourceTree and Bitbucket on Windows.When you set up SSH, you create a key pair that contains a private key (saved to your local comput. An SSH key is an access credential for the SSH (secure shell) network protocol. This authenticated and encrypted secure network protocol is used for remote communication between machines on an unsecured open network.SSH is used for remote file transfer, network management, and remote operating system access.
We use Git and Sourcetree, primarily on the Windows operating system and love it 99% of the time. Sometimes we work from our personal computers and being developers, we have our own projects outside of work that are associated with different credentials. To avoid SSH key issues we just use simple HTTPS to clone our repos down instead of hassling with multiple SSH keys.
This week we have officially adopted two-factor authentication for our revision control so guess what?!
As the documentation clearly states, this breaks HTTPS login for Git!
All things considered this is a small issue but getting multi-key SSH configured was surprisingly difficult. What I found most interesting was that every document explaining how to do this omitted one or two critical details. I have recorded the steps I took to guarantee a sure-fire process to achieve functional Windows Sourcetree with Git working on multiple SSH keys.
Obviously this is Windows and Git specific. We'll be implementing the scenario where you have 1 work and 1 personal Github/Bitbucket/Gitlab account
- Configure Sourcetree to use OpenSSH. We don't use HG so no issues for us!
- Existing Keys: If you previously used Putty, load your ppk into PuttyGen and convert it to Open SSH format using the conversion option. Append .rsa to the file name so you can differentiate from your ppk format private key.
- Fresh Start: If you want to start from scratch, generate two new keys in PuttyGen. 1 for work and 1 for home. Save the private and public keys for later use.
- Check that both of your personal and work account have the correct public keys added for access.
- Create a .bashrc file at %userprofile%.bashrc and save the following: #! /bin/bash
eval `ssh-agent -s`
# Note you make change the .rsa to match whatever suffix you choose for your OpenSSH private keys.
ssh-add ~/.ssh/*.rsa - <a' name='step4'></a>Create a %userprofile%.sshconfig Host work
HostName host.org
# The ~/ means your profile directory. work.rsa should be changed to match
# the OpenSSH private key name for your work account.
IdentityFile ~/.ssh/work.rsa
# Tell SSH to only use identities used in this file
IdentitiesOnly yes
Host home
HostName host.org
# home.rsa should be changed to match
# the OpenSSH private key name for your home account.
IdentityFile ~/.ssh/home.rsa
IdentitiesOnly yesSee the SSH Docs for more information about these options - Close Sourcetree
- Close all open terminals/shells/cmd prompts
- Relaunch Sourcetree
- Launch Terminal via Sourcetree</p> and verify that you see similar output:Agent pid 11740
Identity added: /c/Users/yourname/.ssh/home.rsa (/c/Users/yourname/.ssh/home.rsa)
Identity added: /c/Users/yourname/.ssh/work.rsa (/c/Users/yourname/.ssh/work.rsa) - If you do not see that output, your .bashrc file is incorrect or in the wrong directory. Redo Step 3. If that still doesn't work, start over because you probably have the wrong format keys.
- Running ssh-add -l should list the thumbprints for your two SSH keys.</p>
- You are now ready to clone/pull/push some code!
- Repos belonging to the non-default account will need to have their git origins modified by replacing the hostname portion of the url with the alias id from your .sshconfig file.</p> In my case I would replace my origin [email protected]:myname/repo.git with git@work:myname/repo.git.
- Once you have updated your git origin for the secondary account to use the config file's alias from step 4, you should be able to push/pul without issue.
- If you do have an issue, use Sourcetree menu Tools -> Add SSH Key.. dialog to try re-adding the key.
- If that doesn't work, close Sourcetree, any open console, and try again!
- If that doesn't work then you probably missed a step or detail. Try again!
- Jiffy lube coupon $20. One final tip before you go. Be sure to clear out any saved username/passwords from the Sourcetree authentication tab that are related to your work/home accounts. If you don't remove these, Sourcetree will keep alerting you to that fact the HTTPS login cannot be performed via OpenSSH. Not a big deal but the modal dialogue gets lost and is super annoying to find. </li>
From here, depending on what order you loaded your keys either your home or work will be treated as default. For me, my home registers as default because either key name or thumbprint is alphabetically first. No matter though; we can fix this!
</li></p> Good luck and happy coding!
Comments Section
Sourcetree Key Passphrase
Feel free to comment on the post but keep it clean and on topic.
Please enable JavaScript to view the comments powered by Disqus.blog comments powered by