First draft of gitea and ssh guide complete

2026-06-22 15:30:40 +00:00
parent ceeabdd068
commit 728ac16c0d
7 changed files with 11 additions and 38 deletions
@@ -12,8 +12,16 @@ The gitea server at RU is on port 2222.  *It does not respond on the usual port
   ![menu of SSH / GPG Keys](Graphics/gitea-ssh-nokeys.png)
 1. copy the contents of `~/.ssh/id_ed25519.pub` into the text box and click "Add Key".  *On windows you can view it in Notepad to cut and paste it*.
   ![SSH key pasted into the text field](Graphics/gitea-ssh-pubkey-paste.png)
-1. It will then want you to verify the key by **TODO**
-
+1. It will then want you to verify the key by running a `ssh-keygen`.  You will need to tell it where your public key is, typically `~/.ssh/id_ed25519.pub.  **This process must be done quickly as the tokens expire!!!**
+    1. First look at the validation information given.  This guide assumes you are on linux of some sort, but there are directions for Windows also listed
+   ![verification prompt, empty](Graphics/gitea-ssh-signingtoken.png)
+    2. Open a command shell (if you weren't already) and run the ssh-keygen command to sign the token with your key
+   ![shell prompt running sshkeygen](Graphics/gitea-ssh-sshkeygen-sign.png)
+    2. Paste the results into the "Armored SSH signature" area
+   ![verification prompt, full](Graphics/gitea-ssh-signingtoken-filled.png)
+    2. Click "Verify"
+1. If validation is done quickly and with the right key, you will see confirmation
+   ![Successful validation box](Graphics/gitea-ssh-verified.png)

 # Testing
 If you have ssh setup properly with gitea, you should be able to test it this way: