Overview
Emersion hosts an SFTP server to enable data to be securely accessed and transferred between Emersion and their direct customers, indirect customers & vendors.
The SFTP server is configured to utilise a CHROOT jail environment that provides a secure and locked down filesystem environment for the specific user.
Note: This server is SSH File Transfer Protocol, not FTPS (File Transfer Protocol, Secure)
SFTP Server Hostname
Emersion's SFTP can be access via regular a regular SFTP connection to:
Hostname | For Australian customers use sftp.emersion.com.au For International customers use sftp.emersion.com |
|---|---|
Port | 3333 |
You should not use an IP address to connector to Emersion's SFTP as this could change at any time.
SFTP Authentication Method
Emersion's SFTP server only supports "key pair authentication" - ie. authenticating with a username and private key.
A common mistake customers and vendor make is to attempt to connect using the supplied <username> and <passphrase> as a password. This will result in authentication errors.
You must authenticate using private key authentication. Exactly how to do so varies according to the SFTP client used.
Example setup using the Windows FileZilla application:
If you or your vendor requires assistance with this, please email servicedesk@emersion.com or raise a new case via the Engage portal.
SFTP User for Customers
Your Onboarding project manager will arrange to have an initial SFTP username and location setup for your account during your onboarding project.
You will be assigned a username that mirrors your Account ID, along with a generated Private Key file. In addition, the private key will be delivered to you encrypted.
The passphrase for the encrypted private key will be delivered to you in an alternate communication.
This SFTP can be utilised for various functions, including but not limited to;
- Transfer of secure data from customer to Emersion
- Output of generated report data for secure access by customers
- Export of SIR files for Wholesale > Retail account configurations
For example:
Hostname | sftp.emersion.com |
|---|---|
Port | 3333 |
Username |
|
Passphrase | This is a passphrase to “unlock” the encrypted private key, not a password to use with the above username. For security purposes, you will be communicated this passphrase separately to the delivery of the private key file. |
Private Key | The physical private key file. This file will be encrypted and will require the above passphrase to decrypt. |
Starting Directory | Must start in Must start in |
IP Whitelisting | This is not required for sftp.emersion.com |
SFTP User for Vendors/Carriers
If you require an additional SFTP user for a carrier or vendor, Emersion will configure a separate one per vendor for their exclusive use - where they will be limited to only see and access data within the context of only this user.
This SFTP user will typically only ever be setup for the secure transfer of data (eg. usage CDR files) from a single vendor to Emersion.
This maintains a level of security and privacy of your data within the Emersion platform.
You will be assigned a username that mirrors your Account ID and a shortened version of the vendor name, along with a generated Private Key file. In addition, the private key will be delivered to you encrypted.
The passphrase for the encrypted private key will be delivered to you in an alternate communication.
For example:
Hostname | sftp.emersion.com |
|---|---|
Port | 3333 |
Username |
|
Passphrase | This is a passphrase to “unlock” the encrypted private key, not a password to use with the above username. For security purposes, you will be communicated this passphrase separately to the delivery of the private key file. |
Private Key | The physical private key file. This file will be encrypted and will require the above passphrase to decrypt. |
Starting Directory | Must start in |
IP Whitelisting | This is not required for sftp.emersion.com |