/s3auth

Amazon S3 HTTP Basic Auth Gateway: put your files into S3 bucket and make them accessible with a login/password through a browser

Primary LanguageJavaOtherNOASSERTION

EO principles respected here DevOps By Rultor.com We recommend IntelliJ IDEA

mvn Availability at SixNines PDD status codecov Hits-of-Code Lines of code License

s3auth.com is a Basic HTTP Auth gateway in front of your private Amazon S3 bucket. Read this blog post for a more detailed explanation: Basic HTTP Auth for S3 Buckets.

Point your test.example.com CNAME to relay.s3auth.com, and register the domain in s3auth.com web panel. You will be able to access bucket's content in a browser with an HTTP basic auth. Your bucket will be accessible using your Amazon IAM credentials and with custom user/password pairs in your .htpasswd file (similar to Apache HTTP Server).

For example, try http://maven.s3auth.com/ (with username s3auth and password s3auth). You will access content of Amazon S3 bucket maven.s3auth.com, which is not readable anonymously otherwise.

How to contribute

Fork repository, make changes, send us a pull request. We will review your changes and apply them to the master branch shortly, provided they don't violate our quality standards. To avoid frustration, before sending us your pull request please run full Maven build:

$ mvn clean install -Pqulice

To avoid build errors use JDK 11+ and Maven 3.3+.

To run it locally:

$ mvn clean install -Phit-refresh -Dport=8080

You will be able to open it at http://localhost:8080