This integration platform requires from every developer a unique SSH key to be uploaded before allowing any code deployment into the system. This is a standardised, industry accepted security feature which is widely used in similar services like GitHub.
In this article
Creating your SSH Key
GitHub has a very informative page on SSH Key generation and what you see here is practically taken from the page Generating SSH keys. Before moving forward it would be prudent to check for existing SSH Keys on your computer and if it's necessary to create a new one.
Check for Existing SSH Keys
To see all existing SSH keys open a terminal and type:
$ ls -al ~/.ssh # Lists the files in your .ssh directory, if they exist ... drwx------ 7 username staff 238 Aug 3 14:08 . drwxr-xr-x+ 33 username staff 1122 Jul 24 09:06 .. -rw------- 1 username staff 1766 Jun 25 12:29 github_rsa -rw-r--r-- 1 username staff 403 Jun 25 12:29 github_rsa.pub -rw-r--r-- 1 username staff 2005 Aug 3 14:11 known_hosts
This shows that this user called
username has already GitHub created SSH key which is possible to use. However, it is recommended creating a new one for a simplicity and proper record keeping.
Creating a new SSH Key
To create an SSH Key open a terminal and type:
$ ssh-keygen -t rsa -b 4096 ... Generating public/private rsa key pair. Enter file in which to save the key (/Users/username/.ssh/id_rsa): [Press enter] Enter passphrase (empty for no passphrase): [Type a passphrase] Enter same passphrase again: [Type a passphrase] Your identification has been saved in /Users/username/.ssh/id_rsa. Your public key has been saved in /Users/username/.ssh/id_rsa.pub. The key fingerprint is: 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db firstname.lastname@example.org
Please note: if you want your SSH key to be connected with your e-mail address then use
$ ssh-keygen -t rsa -b 4096 -C email@example.com line instead. The example above ties your SSH key with your computer.
After generating the SSH Key if we check our SSH directory we will get two more entries:
$ ls -al ~/.ssh total 40 drwx------ 7 username staff 238 Aug 3 14:08 . drwxr-xr-x+ 33 username staff 1122 Jul 24 09:06 .. -rw------- 1 username staff 1766 Jun 25 12:29 github_rsa -rw-r--r-- 1 username staff 403 Jun 25 12:29 github_rsa.pub -rw------- 1 username staff 3243 Aug 3 14:08 id_rsa -rw-r--r-- 1 username staff 755 Aug 3 14:08 id_rsa.pub -rw-r--r-- 1 username staff 1595 Jul 28 16:14 known_hosts
Use the newly
id_rsa.pub generated key to work with the platform. For the simplicity type:
$ less ~/.ssh/id_rsa.pub | pbcopy
This command copies the newly created SSH Key into your clipboard, ready to be pasted somewhere else.
Uploading your SSH Key
The newly generated SSH Keys can be added in the Settings > SSH Key section:
The final result would look like this:
You can add more SSH keys or delete the current one on this interface.