Creating the account

Refer to the documentation of GitLab Server to learn how to create an account for the team member (the user) in the team server. If you are unsure, contact the team server administrator.

Creating the valid SSH-key

1. Make sure that the HOME folder is set for the operating system user and that it is not read-only.
   Example: Start a command prompt and enter the command set home. The displayed lines must specify a folder for which the team member has write privileges.

   Example for the displayed lines

   C:\>set home

   HOMEDRIVE=C:

   HOMEPATH=\Users\TheoTest

   Here, the HOME folder is: C:\Users\TheoTest

2. In this HOME folder, create a subfolder .ssh for which the team member has write privileges.

3. Create the SSH key of type RSA 1024 bit as follows:

   1. In logi.CAD 3: Open the preferences and go to group General – Network Connections – SSH2.

   2. In General tab: Make sure that the .ssh subfolder of the HOME folder is entered under SSH2 home. Example: C:\Users\TheoTest\.ssh

   3. Go to Key Management tab and click Generate RSA Key...
      Result: A key is generated and displayed in the field below.

   4. Also in Key Management tab: Enter the email address of the team member in the Comment field and leave the Passphrase field empty. Then click Save Privaten Key..., answer the prompt to save the key without passphrase protection by clicking OK, select the .ssh folder in the dialog to save the key and enter a unique file name, e.g. id_rsa_IDE_TeamServer
      The dialog suggests the file name id_rsa. Use this file name only if no other file id_rsa exists in the .ssh folder yet. In this case, there are already SSH keys for other purposes that you would overwrite.
      

   5. Confirm the information that the key has been saved by clicking OK.
      Result: The new files have been created in the .ssh folder. The new key is automatically entered in the Private keys field of the General tab.

   6. Back in Key Management tab: Copy the public key that is displayed in the field under Generate RSA Key... to the clipboard.
      

   7. Click Apply and Close.

4. Register the SSH public key with the team server:

   1. Connect to the team server, i.e. the GitLab server, in a web browser and log in there as the respective team member.
      

   2. Open the preferences for the user (= Preferences command provided for the user icon in the upper right corner).
      

   3. Select SSH Keys (in the left list under User Settings).

   4. Paste the copied public key from the clipboard into the Key field and click Add key.
      If the contents of the clipboard have been overwritten in the meantime, you will find the public key in the new file with the extension .pub that has been created in the .ssh folder. Example: id_rsa_IDE_TeamServer.pub

Creating the access token

1. Connect to the team server, i.e. the GitLab server, in a web browser and log in there as the respective team member.

2. Open the preferences for the user (= Preferences command provided for the user icon in the upper right corner).

3. Select Access Tokens (in the left list under User Settings).

4. Enter any (not yet used) name under Token name, delete the entered date under Expiration date, check api under Select scopes and click Create personal access token.
   Result: The Your new personal access token field displays the access token.
   

5. Copy this access key to the clipboard to enter it later in logi.CAD 3.
   Also, keep the access token in a safe place, as the access token will not be visible on the team server at a later time. However, if the access token is lost, you can generate a new access token as described above.