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
@@ -49,3 +49,4 @@ flycheck_*.el
 /network-security.data


+*.html
@@ -1,36 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
-	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
-
-<head>
-<title>gitea-ssh-setup.html</title>
-<meta http-equiv="Content-Type" content="text/html;charset=utf-8"/>
-
-</head>
-
-<body>
-
-<h1>Gitea ssh setup</h1>
-<p>This guide assumes you have registered and verified your account with an @RU.IS email address.  If you have not setup your account yet, you must do that first.
-The gitea server at RU is on port 2222.  <em>It does not respond on the usual port 22</em></p>
-<ul>
-<li><a href="https://docs.gitea.com/">Gitea Documentation</a></li>
-</ul>
-<h1>Installing ssh keys into Gitea</h1>
-<ol>
-<li>If you don't have an ssh key, generate one now following the guide on the (main ssh page)[index.md]</li>
-<li>Login to gitea.cs.ru.is</li>
-<li>Click on your user Icon on the top right and choose "Settings" in the dropdown</li>
-<li>On the Left, click on "SSH / GPG Keys"
-   <img alt="menu of SSH / GPG Keys" src="Graphics/gitea-ssh-nokeys.png" /></li>
-<li>copy the contents of <code>~/.ssh/id_ed25519.pub</code> into the text box and click "Add Key".  <em>On windows you can view it in Notepad to cut and paste it</em>.
-   <img alt="SSH key pasted into the text field" src="Graphics/gitea-ssh-pubkey-paste.png" /></li>
-<li>It will then want you to verify the key by <strong>TODO</strong></li>
-</ol>
-<h1>Testing</h1>
-<p>If you have ssh setup properly with gitea, you should be able to test it this way:
-<img alt="ssh test result using git user: success" src="Graphics/gitea-cmdline-test-success.png" /></p>
-</body>
-</html>
@@ -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: