Guide Git Repository Account - Add a New SSH Key to your account

[- Alex Thunderhunter - 32]

GGU Git Repository Account - Add a New SSH Key to your account
This post is continuously being updated as methods/information changes, this can happen without any warning. Last update 1/22/25. Last Bot Update 1/22/25.

This guide is to help you add a newly generated SSH key to your GGU Git Repository Account. If you need help generating a new SSH key and adding it to the ssh-agent, please visit the GGU Git Repository Account - Generate a New SSH Key Guide, if you have any questions, please go through our discord under #helpdesk. 

Adding a new SSH key to your account

You can add an SSH key and use it for authentication, or commit signing, or both.

1. Copy the SSH public key (.pub extension) to your clipboard 
   
   If your SSH public key file has a different name than the example code, modify the filename to match your current setup. When copying your key, don't add any newlines or whitespace.

   Go to c/Users/YOU/.ssh/ or c/Users/YOU/ and locate the newly generated SSH key (ssh_keyname.pub) and copy the contents (Ctrl + C) - Make sure to open with notepad

2. In the upper right-hand corner of the GGU Git Repository, click on your profile picture and go to Settings.
3. Navigate using the left-hand menu to SSH / GPG Keys
4. When on that page you'll see 2 options - Manage SSH keys and Manage GPG Keys. Select "Add Key" next to Manage SSH Keys.
5. From there you'll need to enter a "Key Name", This can be anything that is easily identifiable in case you use multiple keys.
6. Paste the information you copied from ssh_keyname.pub and paste under "Content" and click "Add Key". 

Verifying a newly added SSH key

Now we have to verify the SSH key that you just added before we can start using it. 

1. Click "Verify"
2. Follow the instructions given by the Git Repository for Linux or use the command below for Windows using Git Bash - Enter your passphrase when prompted. Replace token with the token provided by the Git Repository. 

   echo -n 'token' | ssh-keygen -Y sign -n gitea -f "C:\Users\YOU\.ssh\ssh_keyname" or "C:\Users\YOU\ssh_keyname"

3. You should now see:

   -----BEGIN SSH SIGNATURE-----
   LOTS OF TEXT
   -----END SSH SIGNATURE-----

4. Copy the SSH Signature and paste it into the Git Repository. 
5. If the process was completed correctly, you should see "SSH key "SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" has been verified." and should show "Verified Key" above the key name you provided.