Generate and Add SSH Keys Doc Update

[janmartincalulo]

Re: Generate and Add SSH Keys

Priority: High

Issue Description: Hard to follow and usually not working for our customers.

Suggested Resolution

This is for Windows users:

Recommend installing Git Bash into their Local Windows Device: https://git-scm.com/download/win
Once done, follow the commands in Mac/Linux: https://docs.pantheon.io/ssh-keys#macoslinux

Install and run git bash and follow:

MacOS/Linux
Open your terminal and enter the following command to generate a key:

ssh-keygen -t rsa
Please do not edit the default location of ~/.ssh/id_rsa unless you have a reason to change it. If the command says the key already exists, you can overwrite it, or continue to the next step with your existing key.

Set a passphrase for better security.

We recommend using a passphrase, but it can conflict with some tools.

Copy the contents of ~/.ssh/id_rsa.pub to your clipboard after the files are created.

MacOS users can cat the file to the terminal and copy the output:

cat ~/.ssh/id_rsa.pub
Run eval to start the SSH agent. The Agent pid output confirms that the agent started:

Example:

eval `ssh-agent`
Agent pid 86810

Run ssh-keygen -lf ~/.ssh/id_rsa.pub -E md5 to check if the hash you have in your Pantheon User Dashboard's SSH Keys matches.

You are now set.

[github-actions]

👋 @janmartincalulo
Thanks for opening your first issue here! @pantheon-systems/docs-admins is excited to review this!

If you like this project, please ⭐star⭐ our repo.

[rachelwhitton]

thanks for this issue @janmartincalulo! Is it possible to do this with Windows 10 – WSL 2 Ubuntu 20.0 ? The terminus doc lists Git Bash as unsupported so I'd like to avoid pointing folks to that if we can avoid it given incompatibility with Terminus