s3client

S3 Client Utility

A command-line tool for interacting with S3-compatible servers with AWS Signature V4 authentication support.

Features

• Supports GET, PUT, HEAD, and DELETE operations
• AWS Signature V4 authentication
• TLS support with option to skip certificate validation (for development)
• Customizable endpoint, region, and bucket
• Can read request body from file or command line
• Can write response to file

Usage

# List buckets (authenticated)
./s3client -endpoint="https://localhost:443" -access-key="TESTACCESSKEY" -secret-key="TESTSECRETKEY" -method="GET"

# Get an object from a bucket (authenticated)
./s3client -endpoint="https://localhost:443" -bucket="test-bucket01" -path="test.txt" -method="GET" \
  -access-key="TESTACCESSKEY" -secret-key="TESTSECRETKEY" -output="downloaded.txt"

# Upload a file to a bucket (authenticated)
./s3client -endpoint="https://localhost:443" -bucket="test-bucket01" -path="upload.txt" -method="PUT" \
  -body-file="local_file.txt" -access-key="TESTACCESSKEY" -secret-key="TESTSECRETKEY"

# Check if an object exists (HEAD request)
./s3client -endpoint="https://localhost:443" -bucket="test-bucket01" -path="test.txt" -method="HEAD" \
  -access-key="TESTACCESSKEY" -secret-key="TESTSECRETKEY"

Options

AWS Signature V4 Authentication

This client implements the AWS Signature Version 4 signing process as specified in the AWS documentation.

The signing process includes:

1. Creating a canonical request
2. Creating a string to sign
3. Calculating the signature
4. Adding the signature to the HTTP request

When both -access-key and -secret-key are provided, the client will automatically generate and include the necessary authorization headers.