Uploading-an-SSH-Key.md

+You can log onto the CLAIX systems using your login name and password (unix password), or the Secure Shell Protocol (SSH) by authenticating yourself via a private key file on your local machine. In the latter case, the corresponding public key file which the server uses to validate your identity has been saved on the HPC file system in the folder `.ssh` in your user directory up until now. This public key file is now moving to FeLS.
+
+To learn more about SSH, you can check out [wikipedia](https://en.wikipedia.org/wiki/Secure_Shell) or look up how-tos for other services, such as [github](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
+
+# Generating your SSH Key
+
+Use your SSH key generation tool of choice, such as `ssh-keygen` [manual](https://www.man7.org/linux/man-pages/man1/ssh-keygen.1.html) or [puttyGen](https://www.puttygen.com/). Make sure to generate a key of sufficient length to make it secure. **To ensure your key cannot be abused, set an appropriately strong password for the private key file.** Without such a password, your credentials are very vulnerable.
+
+Once you have generated the pair of files, save the private key file in the folder `.ssh` on your user directory (`~/.ssh` on Linux, `/c/users/[username]/.ssh` on Windows). You can save the public key file in the same location, or move it elsewhere.
+
+# Uploading the Public Key
+
+![Screenshot of the FeLS main dashboard, showing the main navigation ribbon after expanding it from the 'Index' menu point. The new ribbon has three links: Personal Data, My SSH Pubkeys, and My Tokens.](uploads/aff5310ac84f85793ff1ca5fdd5e56d7/Index_Ribbon.png)
+
+To upload your public key, hover your mouse over the menu point _Index_ in the navigation ribbon on top. This will expand the menu. Click on _My SSH Pubkeys_. This will take you to the SSH key overview.
+
+![Screenshot of the overview over the SSH keys. It displays the already added keys along with their name, expiration date, key type, SHA256 Fingerprint, and associated services. The option to revoke each key and add new ones is also given.](uploads/69356424db8756edf5049082c44957b2/List_of_SSH_keys.png)
+
+In the overview, your added keys are listed with their relevant information and the option to revoke each key. Note that you can only ever add a certain key **once**, even after revoking the key or letting it expire. You **cannot reuse your keys** and will need to generate a **new key** in these situation.
+
+To add a new public key, use the button **Add SSH Key**. This brings up the dialogue to upload your public key.
+
+![Dialogue pop-up to add a new SSH public key.](uploads/accff871fed2f3515b8661ae8c0e756f/Add_SSH_Key.png)
+
+Open your saved **public key** (the file ending in `.pub`) and copy the key sequence, or copy it directly from the application used to generate it. Paste it into the text box `SSH Key`. **Do NOT upload your private key!**. Give your public key a name, e.g. to differentiate keys associated with different machines.
+