Documentation - S3-Compatible Connection Settings and Authentication — Files.com
Skip to main content

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:

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

Get The File Orchestration Platform Today

4,000+ organizations trust Files.com for mission-critical file operations. Start your free trial now and build your first flow in 60 seconds.

No credit card required • 7-day free trial • Setup in minutes