Differences

This shows you the differences between two versions of the page.

--- auth_gitlab [2019/12/03 14:23] – [GitLab] apano
+++ auth_gitlab [2019/12/03 14:43] – [Identify or create the SSH key] apano
@@ Line 23: / Line 23: @@
 ===== Identify or create the SSH key =====
-If you need support on how to generate the SSH key follow our guide on [[auth:howto:sshkeygitlab|How to create an SSH Key for GITLAB]].
+You need an SSH key that resides on your workstation/notebook.
+==== Check for an existing SSH key ====
+If you already have an SSH key you will probably find it here:
+Linux/macOS :      ~/.ssh/id_rsa.pub
+Windows :          %userprofile%\.ssh\id_rsa.pub
+Open the file with a text editor and check if it has contents. Typically it starts with ssh-rsa or ssh-ed25519. If it has contents [[auth:gitlab#add_an_ssh_key|add it to Gitlab]] if it does not exist or is empty [[auth:gitlab#generate_an_ssh_key|generate an SSH key]] .
+==== Generate an SSH key ====
+Open a terminal on Linux or macOS, or Git Bash on Windows and run the command:
+<code>ssh-keygen -t rsa -C "your@email" -b 4096</code>
+or
+<code>ssh-keygen -t ed25519 -C "your@email"</code>
+You can check your e-mail on your Gitlab Profile -> Main Settings -> Email
+When you are asked for a location and file name you can either keep the default location or choose a new one. If this is your only key we advice you accept the defaults and maintain the file name id_rsa. Should you have several keys you can name them according to your own choice. [[https://docs.gitlab.com/ee/ssh/README.html|GitLab Official Documentation]]
+You can also use a key generator such as [[http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html|PuTTYgen]] instead of using the terminal. Please refer to the guidelines of the product on how to create the RSA key and the location of the file.
 ===== Add an SSH key =====