Lexer manages an SFTP server for the upload and download of secure client and partner data. All files containing sensitive information must be transferred via this method. In this article we'll discuss how Lexer uses SFTP, how to manage your access credentials, and how to access your Lexer SFTP on either Windows or Mac OS.
Our team will provide you with details about your Lexer SFTP directory - usually via email. This will contain information such as your Username, Host, URL, and relevant paths for reading and writing files. You'll need this information to complete step 5.
Let's use Terminal to generate a matching key pair for secure authentication.
- Open the Terminal program.
- Type ssh-keygen -t rsa and hit return to launch the public/private key generation functionality.
- Hit return to save the public and private keys to the default file location.
- Enter a passphrase to secure your SSH key (optional but recommended), and hit return.
- Enter your passphrase again (if used), and hit return once more to generate. This has now created two files, named by default, and stored in Users/yourusername/.ssh/.
- Now switch to a Finder window to navigate to the specified directory. To show your hidden files press shift + command + .
- A public key - id_rsa.pub - you will be uploading this to your Lexer Hub in step 3.
- A private key - id_rsa - you will be uploading this to your SFTP Application in step 6.
Let's use WinSCP to generate a matching key pair for secure authentication.
- Download WinSCP and follow the prompts to install it.
- Open WinSCP and select Tools on the bottom left hand side and select PuTTYgen.
- Leave all options as standard and select Generate. You will be prompted to move your mouse around the grey box to generate a randomized encryption key.
- Click Save Public Key and name it lexer-public. You will need this in step 3.
Click Save Private Key and name it lexer-private. You will need this in step 5.
You can also generate your SSH keys using other tools such as OpenSSH Client
Lexer secures client SFTP servers using a combination of public/private key cryptography as well as IP address whitelisting. In order to access your SFTP you will need to whitelist your IP address and SSH key.
Your public key should be in the following format:
Navigate to Lexer > Manage > Integrations > SFTP and add this public key by clicking 'Add SSH Public Key'.
It may take up to 30 minutes for SSH key whitelisting changes to become active.
If you're getting an "Invalid Key Format" error when entering your public key into the SFTP tile in Lexer, please run the following command in your terminal to convert your key into the required format:
ssh-keygen -i -f [your_key_filename.pub]
Any system or device accessing your Lexer SFTP will need to have its IP address whitelisted. If you are configuring a system to access your Lexer SFTP, then you will need to ensure it is configured using a static IP address. If you are accessing your Lexer SFTP via your local device (e.g. your work computer), then you will need to whitelist your home or office IP address.
To find your current IP address, head to whatismyipaddress.com on the network you will access the SFTP from (e.g. your office) and copy the results shown on the website. Navigate to Lexer > Manage > Integrations > SFTP and add this IP address by clicking 'Add IP Address'.
It may take up to 30 minutes for IP address whitelisting changes to become active.
- Download WinSCP and follow the prompts to install it.
- Open WinSCP and select 'New Site' on the top left hand side.
- Fill in the host, port, and username as per the documentation. Do not add a password as you will be using your keys to authenticate. To do this click advanced, then advanced again.
- Click Advanced, then Advanced again.
- Click Authentication under the SSH tree and select your private key file. Hit Ok.
- Select Save and choose the name "Lexer SFTP". You're now able to send us your customer data files as well as receive files exported from the Hub via Activate.
- Download FileZilla and follow the prompts to install it.
- Once downloaded, go to File > Site Manager.
- Fill in the following fields as provided in your SFTP Access documentation.
- Host: as detailed in your SFTP access documentation.
- Port: as detailed in your SFTP access documentation.
- Protocol: SFTP - SSH File Transfer Protocol.
- Logon Type: Key file.
- User: as detailed in your SFTP access documentation.
- Key file: select your private ssh key as generated in previous steps.
- Click Connect. You're now able to send us your customer data files as well as receive files exported from the Hub via Activate.
Having trouble connecting to your Lexer SFTP? We've outlined a number of common scenarios and the likely diagnosis in the table below. Get in touch with Lexer Support if you need assistance.
|Outcome (using sftp -i path_to_private_key [email protected])||Host is correct?||Port is correct?||Private key is valid format?||IP is whitelisted?||User is correct?||Public key is whitelisted?|
|ssh: Could not resolve hostname azzz.lexer.transfer.io: nodename nor servname provided, or not known Connection closed||No||-||-||-||-||-|
|ssh: connect to host au.transfer.io port 30: Operation timed out Connection closed||Yes||No||-||-||-||-|
|Load key "path_to_private_key": invalid format [email protected]: Permission denied (publickey)||Yes||Yes||No||-||-||-|
|ssh: connect to host au.transfer.io port 22: Operation timed out Connection closed||Yes||Yes||Yes||No||-||-|
|[email protected]: Permission denied (publickey)||Yes||Yes||Yes||Yes||No||-|
|[email protected]: Permission denied (publickey)||Yes||Yes||Yes||Yes||-||No|
Updated 5 months ago