How to access NetStorage with FTP

We recommend connecting to NetStorage using a secure protocol.

We recommend using FTP-TLS if you must use FTP to access NetStorage

These FTP-TLS clients are supported for use with NetStorage:

FTP-TLS requirements

You can access NetStorage using the FTP-TLS protocol if the client in use meets the following requirements:

  • Standard FTP - RFC 959
  • Simple File Transfer Protocol - RFC 913
  • FTP-TLS (FTPS) - RFC 4217: FTP encapsulated inside a Transport Layer Security (TLS) session.
  • Cipher 256-bit DHE-RSA or AES-256-SHA: Any client must support either of these ciphers.

Example TLS Setup - CoreFTP

This process assumes that you've obtained and installed the CoreFTP client. You connect using the following settings:

  • Host/IP/URL: <Domain Name>.ftp.upload.akamai.com
  • Username: FTP username
  • Password: FTP password
  • Port: 21
  • Connection: AUTH TLS
  • SSL options: Enable "OpenSSL," and disable the rest of the options.

After clicking Connect, a pop-up window asks you to verify the certificate. Accept it to connect to the storage group via FTP.

Connect with a GUI or CLI terminal

You can connect with FTP by using either a GUI client or CLI-based terminal session. You can use any number of client applications that are available on the web. For example, FileZilla (Linux, Windows) gFTP (Linux) and WinSCP (Windows). To log in with FTP, the upload account name ("Id") and the appropriate FTP password must be provided when you are confronted with the user and password prompts. These values can be obtained by viewing the Upload Account Details in the NetStorage Groups UI.

  • User: This is the upload account name ("Id" in the UI) that has been configured to access the target storage group.
  • Password: This is the unique password you provide when setting up the FTP Access Method for the upload account in the NetStorage Groups UI.
  • Your Upload Domain Name: The Upload Domain Name associated with the target storage group. This is also referred to as the “Host Name.”
Access example
  1. From a Command Line Terminal or Terminal Session window, initiate FTP. For example, in Windows and Linux, this is accomplished by typing “FTP” at the prompt.
  2. At the prompt, type: open
  3. At the “To” prompt, input your complete Upload Domain Name: <Domain Name>.ftp.upload.akamai.com
  4. At the “User (generated information)” prompt: Enter the “Id” assigned to the upload account.
  5. At the “Password:” prompt: Enter the password assigned to the upload account's FTP access method.
If you input everything properly, you should have access to the storage group. You can issue Supported FTP commands as desired.
Note: With various Terminal Sessions, you may not receive a confirmation after successful login. The session may just drop to a new, empty prompt. Try running a basic command such as “ls” to ensure you’re connected.

Are you using a VPN connection with Split VPN tunnel?

If so, the client may not be able to establish connection and it will throw the following error:

SSL/TLS error - 0, SSL error - 1, error:00000001:lib(0):func(0):reason(1)
Winsock error 10060 (A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond. )
SSL Connection not established

If you run into this issue, you need to a non-split VPN connection.