Our standard CDN storage solution allows the storage of content on our storage servers (i.e., CDN origin servers). Content stored on our CDN storage solution can then be made available to clients either through:
You should not store personally identifiable informationExamples of PII are: name, Social Security number, passport number, and IP address. (PII) within our CDN storage solution.
A list of CDN and edge CNAME URLs that may be used to access content in our CDN storage solution may be viewed from the URLs for CDN Origin section of the home page of the platform through which data will be delivered.
Key information:
Update and manage content on CDN storage using any of the following solutions:
Access content uploaded to CDN storage through the following CDN URL:
Storing too many assetA file is the most commonly known example of an asset. Refers to any collection of data that is typically stored as a single unit on a storage unit (e.g., disk drive). An example of an asset that is not physically stored on a disk drive occurs when dynamically generated content is not cached.s within a single directory may impact performance. Avoid performance issues by spreading assets across multiple directories.
Details:
The following table describes three protocols that facilitate the transfer of files to CDN storage.
| Protocol |
rsync Feature Requirement |
Description |
|---|---|---|
|
Yes |
An SFTP client can be used to transfer data securely to our storage servers using the SFTP protocol (SSH FTP).
|
|
|
Yes |
The rsync tool, which was designed for use in a Linux/Unix environment, can synchronize data between two machines in a variety of ways. For example, you may use this tool to transfer data between your local machine and our storage servers. |
|
|
FTP Discontinued |
Not Applicable |
FTP access to CDN storage was discontinued on May 26, 2020 due to its insecure nature. Use SFTP or rsync instead. Due to the insecure nature of the FTP protocol, user account credentials may be exposed during the FTP authentication process. In turn, this may compromise the integrity of your CDN configuration. |
Please contact your CDN account manager to activate the rsync feature.
This section provides instructions on how transfer files to CDN storage over the SFTP protocol using either a client or the command-line.
Each user account that will transfer content using either SFTP or rsync must be initialized by our system. This initialization process occurs the first time that a new user provides valid credentials when authenticating to the system. As a result, a new user will be denied access on their first authentication attempt. After which, the user will be able to authenticate normally.
The SFTP protocol may only be used if the rsync feature has been enabled on your account. For more information, please contact your CDN account manager.
Transfer data to CDN storage using an SFTP client by configuring it as indicated below.
User names and passwords are case-sensitive.
Transferring data using an SFTP command-line tool requires syntax that identifies the following items:
Syntax:
The rsync hostname assigned to your account is provided on the RSYNC page.
After passing the above command, authenticate the session using the password corresponding to the specified TCC user account. Upon successful authentication, use interactive commands to transfer files.
If a connection cannot be established, try using a backslash to escape the @ symbol specified as a part of the specified user name (e.g., joe\@cdn.com).
An alternative to providing a user name and password when authenticating a session is to use SSH keys.
Rsync is a command-line utility that was designed for use in a Linux/Unix environment. Among its many uses, this utility allows you to quickly and easily synchronize the content on a local machine to one of our storage servers via a shell-like interface.
Please contact your CDN account manager to activate rsync on your account.
Each user account that will transfer content using rsync must be initialized by our system. This initialization process occurs the first time that a new user provides valid credentials when authenticating to the system. As a result, a new user will be denied access on their first authentication attempt. After which, the user will be able to authenticate normally.
The recommended syntax for transferring your content to our storage servers is defined below.
View your rsync hostname from the RSYNC page.
The following terms must be defined in the above command:
| Term | Description |
|---|---|
|
Local Path |
Replace this term with the relative path to the folder or the file that will be transferred to our storage servers. Typically, this path is specified relative to the current folder. This can be accomplished by first specifying a period, a forward slash, and then the relative path from the current folder to the desired folder (e.g., ./Folder1/SourceFolder). The specified folder will be copied recursively to our storage servers. This means that the contents of the specified folder and all of its subfolders will be copied to your CDN storage account. |
|
User Name |
Replace this term with the case-sensitive user name (i.e., email address) for the user account through which content will be transferred. If you have trouble establishing a connection, then you may need to use a backslash to escape the @ symbol specified as a part of your user name (e.g., joe\@cdn.com). |
|
POP |
Replace this term with the three-letter abbreviation for the CDN storage location assigned to your account. View your rsync hostname from the RSYNC page. |
|
AN |
Replace this term with your customer account number (e.g., 0001). This account number is displayed in the upper-right hand corner of the TCC. |
|
Destination Path |
Replace this term with the relative path from the root folder on your CDN storage account to the folder where your content will be transferred. The root folder should be indicated through the use of a forward slash. Example: The following destination folder copies your content to a subfolder of the root folder called DestinationFolder: /DestinationFolder
|
Establishing a connection to CDN storage requires session authentication. Authenticate your session by providing your TCC password or through the use of an SSH key.
The following sample command copies a folder from your local machine to your CDN storage account.
The source and destination folders for the file transfer are described below.
Identifies a relative path from the current directory of the machine (e.g., local machine) running this command.
Identifies a relative path from the root folder of your CDN storage account.
An alternative to providing TCC credentials whenever you need to transfer content to one of our storage servers is to use SSH keys. An SSH key, which uses public-key cryptography, authenticates your local machine when it connects via rsync or SFTP to one of our storage servers. The use of an SSH key is more secure than user account authentication and it prevents TCC credentials from being exposed during the connection to one of our storage servers.
Typically, a passphrase is used to ensure that only authorized users can use your key to connect to our storage servers.
Before you can take advantage of an SSH key, you will need to perform the following:
Once the authorized_keys file has been copied to one of our storage servers, you will be able to rsync or SFTP from any machine on which the corresponding SSH key has been installed. If you specified a passphrase when the SSH keys were generated, then you will need to specify it before the connection will be established.
Edgecast CDN