https://github.com/authress-engineering/aws-s3-explorer

A public open source S3 explorer for public/private buckets that can be deployed anywhere.
https://github.com/authress-engineering/aws-s3-explorer

amazon amazon-s3-browser amazon-s3-bucket aws filebrowser s3 s3-explorer s3-storage

Last synced: 2 days ago
JSON representation

A public open source S3 explorer for public/private buckets that can be deployed anywhere.

• Host: GitHub
• URL: https://github.com/authress-engineering/aws-s3-explorer
• Owner: Authress-Engineering
• License: apache-2.0
• Created: 2021-08-25T19:05:32.000Z (about 3 years ago)
• Default Branch: release/1.1
• Last Pushed: 2024-05-04T09:46:22.000Z (6 months ago)
• Last Synced: 2024-10-14T20:02:59.039Z (about 1 month ago)
• Topics: amazon, amazon-s3-browser, amazon-s3-bucket, aws, filebrowser, s3, s3-explorer, s3-storage
• Language: JavaScript
• Homepage: https://console.rhosys.ch
• Size: 2.82 MB
• Stars: 49
• Watchers: 4
• Forks: 25
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# AWS S3 Explorer

This is an S3 Explorer for AWS. It provides a simple and straightforward way for users to login using SSO and explore available S3 Buckets. Everything is done in the browser and requires only minimal setup using either [AWS Cognito](https://) or [Authress](https://authress.io).

This is an open source project managed by the [Authress Engineering team](https://authress.io).



    

      

    

      

    

      

    

        



Rhosys hosts an explorer to use out of the box for the community. For obvious security reasons, this is a UI only tool, and makes ZERO api calls to anywhere other than AWS. The following is a link to that explorer. However, if for some reason, other than security there is a benefit to hosting a clone of this, feel free to fork the repo and make any necessary changes. Alternatively, please contribute!

### Go to the => [AWS S3 Explorer](https://console.rhosys.ch/)

### Or => [Deploy a white-labeled version to your custom domain](https://eu-west-1.console.aws.amazon.com/lambda/home?region=eu-west-1#/create/app?applicationId=arn:aws:serverlessrepo:eu-west-1:922723803004:applications/S3-Explorer)

## The S3 Explorer:

![Folder selected screen](screenshots/explorer-folder.png)

### Configuration: The only setup step

Jump over to the [AWS S3 explorer configuration](https://console.rhosys.ch) to deploy the Cognito CFN template, and configure your SSO provider. That's it!

* [Custom configuration](./docs/configuration.md)

## Troubleshooting

If you run into any problems just try running through the suggested [Troubleshooting steps](./docs/troubleshooting.md) and if that doesn't help, [file an issue](https://github.com/Rhosys/aws-s3-explorer/issues), we are usually quick to respond.

## Standard use cases:

View all objects in folder:

![Folder selected screen](screenshots/explorer-folder.png)

View all objects in bucket:

![Bucket traversal screen](screenshots/explorer-bucket.png)

Upload objects to a bucket:

![Bucket upload request screen](screenshots/explorer-upload.png)

Upload objects to a bucket succeeded:

![Bucket upload confirmation screen](screenshots/explorer-upload-success.png)

Delete objects from a bucket:

![Bucket object delete request screen](screenshots/explorer-delete.png)

Delete objects from a bucket succeeded:

![Bucket object delete confirmation screen](screenshots/explorer-delete-success.png)

## Contribution

### Development

This project uses Vue 3, and as this is much different from Vue 2, recommend reading is available:

* [General Updates](https://v3.vuejs.org/guide/computed.html)

* [Script Setup tags](https://v3.vuejs.org/api/sfc-script-setup.html)

### Troubleshooting builds

**Error: OpenIDConnect provider's HTTPS certificate doesn't match configured thumbprint** - Update AWS IAM to use the thumbprint details of the issue [are available here](https://github.com/aws-actions/configure-aws-credentials/issues/357).