SFTP Connection Guide

SFTP is a secure protocol to transfer files, and you can use it to set up get/upload files to Quicklizard.

First, we need to create the key pair:

1. Generate an SSH-2 key using PuTTYgen Key Generator or any other Key generator by pressing 'Generate'.

Link to download PuTTYgen key generator: https://www.puttygen.com/download-putty

2. Make sure you check the option: RSA under the "Type of key to generate:"
Also, make sure the ppk file version is version 2 and not 3 as some systems don't support version 3, got to key -> parameters for saving key files, and then in the screen opens make sure the version marked is 2.

3. Copy the key that was generated under "Public key for pasting into OpenSSH authorized_keys file" save it in a text editor on your local machine and send it to the QL support team. 
Copy the key from the top until the phrase rsa-key (not including it).

4. Click on "Save private key" to save the private key on your local machine (private_key.ppk). *Do not click on "Save public key"*

After you send it to the support team, they will send you the credentials to login to the SFTP. Password is not needed unless specified otherwise.

5. Create a new site and fill in all the information with your credentials and add the private key to your settings:

File protocol: SFTP

Host name: sftp02.quicklizard.com/sftp03.quicklizard.com (will be provided by QL support)

Port number: 22

User name: your username (will be provided by QL support)

password: leave empty unless specified otherwise.

How to do step 5 using Winscp:
On the new site page Click on "Advanced" → SSH → Authentication→ and then Insert the path of your private key under "Private key file:" then click "Ok".

Step 5 on FileZilla: 
Click on new site, In the opened screen fill out the credentials that were given to you by ql support, make sure the protocol is SFTP and not FTP. 
On the logon type make sure it's set to Key file, there you can fill in the user name that was provided and add the path to the public key you saved on your server.

6. Now click "Login" to connect to the SFTP folder.

To access QL SFTP server via Linux terminal, first we need to create an SSH key pair.

1. The key pair should be saved in a hidden folder called .ssh. 
Open your terminal, and run the command: ssh-keygen -t rsa -b 4096

then it will ask you to give the file a name, and it will generate it by default in your home folder. you can alternatively to your .ssh folder (where it should be saved) using
ssh-keygen -t rsa -b 4096 -f ~/.ssh/{key_name}

After it will ask to create a passphrase please leave it empty (just click enter), and the passphrase again leave empty.

2. Make sure that the SSH-2 public key starts with ssh-rsa and is followed by a long key. for example ssh-rsa <Key>

3. Please make sure the file containing your public key and private key is in a hidden folder called: .ssh

4. Send QL the file containing the public key that you have generated and only the public one.

Now after the SSH key pair was created and sent to QL support, we can connect to our SFTP:

5. Reach out to Quicklizard Support to get the credentials in the following format:
File protocol: SFTP

Host name: sftp02.quicklizard.com/sftp03.quicklizard.com (will be provided by QL support)

Port number: 22

User name: your username 

Connect to the SFTP server using the sftp command in the terminal:

sftp [username]@[hostname]

8. If your SSH key pair is not located on the .ssh folder please use this format:

sftp -o "IdentityFile=[path]" -P [port] [username]@[hostname]

explanation:

[path]= the full path leading to the SSH key private file that is located on your local machine.

[port]= the port used, port 22 for SFTP connection unless specified otherwise.