- Docs
- Services
- S3-Compatible Endpoint
- S3-Compatible Connection Settings and Authentication
S3-Compatible Connection Settings and Authentication
You can connect to Files.com using any S3-compatible client or SDK by supplying the correct endpoint, region, and access credentials. This page lists the required settings and provides examples for common tools.
Endpoint and Region Configuration
Use the dedicated Files.com S3-compatible endpoint when configuring your client. The endpoint uses HTTPS for all requests. Files.com assigns a region identifier that you supply to your client during configuration.
Endpoint URL
The endpoint URLs for S3-compatible connections to your Files.com site are:
https://s3-<your_custom_subdomain>.files.comhttps://s3.files.com
Region
The region setting is ignored and can be set to any value.
Most S3 clients use a default region of us-east-1.
Access Keys
The S3-compatible endpoint uses Access Key IDs and Secret Access Keys. You can create and revoke S3 compatible API Keys in your Files.com site. Files.com supports two types of API keys: Site-wide keys and User keys. User API Keys correspond to a Files.com user and inherits the user’s permissions, folder access, and restrictions.
You can manage API Keys at any time. When replacing keys, update your automation scripts, SDK configurations, or application secrets.
S3 Authentication Support
Files.com supports the AWS Signature Version 4 (SigV4) authentication model. All S3 clients and SDKs that support SigV4 operate normally with the Files.com S3-compatible endpoint.
Buckets, Folders, and Namespaces
Your Files.com site will present a single bucket named default. This bucket represents the top-level folder of your site.
Users only see objects they have permission to access.
Folders inside a bucket appear as object key prefixes. Listing or filtering objects shows only content your user is authorized to access.
AWS CLI Example
You can configure the AWS CLI to connect to Files.com using a custom endpoint:
aws configure
When prompted:
- AWS Access Key ID: Enter your Files.com Access Key ID
- AWS Secret Access Key: Enter your Files.com Secret Access Key
- Region:
us-east-1
Then run:
aws s3 ls default/ --endpoint-url https://s3.files.com
These settings work with any S3-compatible tool or library.
Uploading, Downloading, and Managing Objects
Files.com supports standard S3 object operations for uploading, retrieving, listing, and deleting files. Any S3-compatible tool or SDK can interact with your Files.com storage using these operations.
Upload an Object
aws s3 cp /path/to/myfile.txt s3://default/destinationfolder/myfile.txt --endpoint-url https://s3.files.com
Download an Object
aws s3 cp s3://default/folder/myfile.txt /downloads/myfile.txt --endpoint-url https://s3.files.com
List Objects
aws s3 ls s3://default/ --endpoint-url https://s3.files.com
Delete an Object
aws s3 rm s3://default/folder/myfile.txt --endpoint-url https://s3.files.com