Differences

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

--- auth_gitlab [2019/06/21 14:32] – created apano
+++ auth_gitlab [2019/12/03 14:44] – [Check for an existing SSH key] apano
@@ Line 3: / Line 3: @@
 Since July 2016 we use [[https://gitlab.inf.unibz.it/|GitLab]] to collaborate.
-UNIBZ users have to login to [[https://gitlab.inf.unibz.it/|GitLab]] and their account will be automatically enabled.
+UNIBZ users have to login to [[https://gitlab.inf.unibz.it/|GitLab]] and their account will be automatically enabled a few minutes after they try their first login.
-External users can sign up with their Google, Twitter, or Facebook account.
+External users can sign up with their Google, Github, Twitter, Facebook, Bitbucket or Microsoft account.
 Here are some instructions on GitLab to ease its use.
@@ 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 add 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 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 =====