diff --git a/.gitignore b/.gitignore index c0df46a..873d1b1 100644 --- a/.gitignore +++ b/.gitignore @@ -49,3 +49,4 @@ flycheck_*.el /network-security.data +*.html diff --git a/ssh/Graphics/gitea-ssh-signingtoken-filled.png b/ssh/Graphics/gitea-ssh-signingtoken-filled.png new file mode 100644 index 0000000..30221ab Binary files /dev/null and b/ssh/Graphics/gitea-ssh-signingtoken-filled.png differ diff --git a/ssh/Graphics/gitea-ssh-signingtoken.png b/ssh/Graphics/gitea-ssh-signingtoken.png new file mode 100644 index 0000000..8363822 Binary files /dev/null and b/ssh/Graphics/gitea-ssh-signingtoken.png differ diff --git a/ssh/Graphics/gitea-ssh-sshkeygen-sign.png b/ssh/Graphics/gitea-ssh-sshkeygen-sign.png new file mode 100644 index 0000000..4cb5846 Binary files /dev/null and b/ssh/Graphics/gitea-ssh-sshkeygen-sign.png differ diff --git a/ssh/Graphics/gitea-ssh-verified.png b/ssh/Graphics/gitea-ssh-verified.png new file mode 100644 index 0000000..b81259f Binary files /dev/null and b/ssh/Graphics/gitea-ssh-verified.png differ diff --git a/ssh/gitea-ssh-setup.html b/ssh/gitea-ssh-setup.html deleted file mode 100644 index 3499e2c..0000000 --- a/ssh/gitea-ssh-setup.html +++ /dev/null @@ -1,36 +0,0 @@ - - - - - - -gitea-ssh-setup.html - - - - - - -

Gitea ssh setup

-

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. It does not respond on the usual port 22

- -

Installing ssh keys into Gitea

-
    -
  1. If you don't have an ssh key, generate one now following the guide on the (main ssh page)[index.md]
    2. -
  2. Login to gitea.cs.ru.is
    3. -
  3. Click on your user Icon on the top right and choose "Settings" in the dropdown
    4. -
  4. On the Left, click on "SSH / GPG Keys" - menu of SSH / GPG Keys
    5. -
  5. 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
    6. -
  6. It will then want you to verify the key by TODO
    7. -
-

Testing

-

If you have ssh setup properly with gitea, you should be able to test it this way: -ssh test result using git user: success

- - diff --git a/ssh/gitea-ssh-setup.md b/ssh/gitea-ssh-setup.md index cee9cff..66d89e4 100644 --- a/ssh/gitea-ssh-setup.md +++ b/ssh/gitea-ssh-setup.md @@ -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: