https://github.com/yegor256/s3auth

Amazon S3 HTTP Basic Auth Gateway: put your files into S3 bucket and make them accessible with a login/password through a browser
https://github.com/yegor256/s3auth

amazon-s3-bucket amazon-web-services aws aws-s3 gateway http-auth http-authentication java

Last synced: 5 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/yegor256/s3auth
• Owner: yegor256
• License: other
• Created: 2012-08-22T13:05:16.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-04-30T23:00:54.000Z (6 months ago)
• Last Synced: 2024-05-01T23:12:24.061Z (6 months ago)
• Topics: amazon-s3-bucket, amazon-web-services, aws, aws-s3, gateway, http-auth, http-authentication, java
• Language: Java
• Homepage: https://www.s3auth.com
• Size: 2.76 MB
• Stars: 253
• Watchers: 12
• Forks: 54
• Open Issues: 42
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        


[![EO principles respected here](https://www.elegantobjects.org/badge.svg)](https://www.elegantobjects.org)

[![DevOps By Rultor.com](https://www.rultor.com/b/yegor256/s3auth)](https://www.rultor.com/p/yegor256/s3auth)

[![We recommend IntelliJ IDEA](https://www.elegantobjects.org/intellij-idea.svg)](https://www.jetbrains.com/idea/)

[![mvn](https://github.com/yegor256/s3auth/actions/workflows/mvn.yml/badge.svg)](https://github.com/yegor256/s3auth/actions/workflows/mvn.yml)

[![Availability at SixNines](https://www.sixnines.io/b/9dcb)](https://www.sixnines.io/h/9dcb)

[![PDD status](https://www.0pdd.com/svg?name=yegor256/s3auth)](https://www.0pdd.com/p?name=yegor256/s3auth)

[![codecov](https://codecov.io/gh/yegor256/s3auth/branch/master/graph/badge.svg)](https://codecov.io/gh/yegor256/s3auth)

[![Hits-of-Code](https://hitsofcode.com/github/yegor256/s3auth)](https://hitsofcode.com/view/github/yegor256/s3auth)

![Lines of code](https://img.shields.io/tokei/lines/github/yegor256/s3auth)

[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/s3auth/blob/master/LICENSE.txt)

[s3auth.com](https://www.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](http://www.yegor256.com/2014/04/21/s3-http-basic-auth.html).

Point your `test.example.com` CNAME to `relay.s3auth.com`,

and register the domain in [s3auth.com](https://www.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/](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`