Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gkarthiks/s3-presigned-url
https://gkarthiks.github.io/s3-presigned-url/ Creating a PreSigned URL for the Amazon S3 via plain HTTP
https://github.com/gkarthiks/s3-presigned-url
amazon-s3 amazon-s3-bucket amazon-s3-storage bucket-region hashmap map-s3presignedurl pre-signed region s3-bucket tls
Last synced: 26 days ago
JSON representation
https://gkarthiks.github.io/s3-presigned-url/ Creating a PreSigned URL for the Amazon S3 via plain HTTP
- Host: GitHub
- URL: https://github.com/gkarthiks/s3-presigned-url
- Owner: gkarthiks
- License: mit
- Created: 2017-10-25T23:39:07.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-06-04T01:01:54.000Z (over 3 years ago)
- Last Synced: 2024-05-01T14:45:00.677Z (8 months ago)
- Topics: amazon-s3, amazon-s3-bucket, amazon-s3-storage, bucket-region, hashmap, map-s3presignedurl, pre-signed, region, s3-bucket, tls
- Language: Java
- Homepage:
- Size: 1.1 MB
- Stars: 5
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: License.md
Awesome Lists containing this project
README
# s3-presigned-url
[](https://travis-ci.org/gkarthiks/s3-presigned-url)
Creating a PreSigned URL for the Amazon S3 to download the data via plain HTTP.
## Why s3-presigned-url
* To get a file from the Amazon S3 bucket, we need to login to Amazon S3 via cli or a programatically by implementing the Amazon Libraries.
* s3-presigned-url allows the developer to write only two or three lines of code to get the data out of S3 bucket.
* The existing project code for aquiring the files via ftp, http, wget or curl needs not to be changed. The Pre-Signed URL from the s3-presigned-url.jar provides the ability of directly using this to download the file.
* The URL generated can also be used in browser to download the file from browser.
* Not only to download the file, but also to get the xml file which has the details about the list of files hosted in the bucket. All that need to be done is provide the path of the folder.
* Following parameters are required.
* Endpoint URL
* Credential Map
* HTTP Method
* Bucket Region
* TTL
* Proxy Host and Port
* *Endpoint URL* is the URL of your bucket along with the path of file / folder.
* Eg:- http://s3-us-west-1.amazonaws.com///
* Every region has its own format of ENd Point URL. The End point URL should be constructed perfectly to access the data.
* Example End Point URL Construction:
Region | End Point URL
-------|--------------
us-west-2 | http://s3-us-west-2.amazonaws.com//\/\
ap-northeast-2 | http://s3.ap-northeast-2.amazonaws.com//\
* For region specific URLs, please refer to the Amazon site [Amazon Region Specific End Point URLs and Protocols](http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region).
* *Credential Map :* s3-presigned-url takes the credentials in HashMap.
* Map S3PresignedURL.AWS_ACCESS_ID as the key and the Access ID as the value string.
* Map S3PresignedURL.AWS_SECRET_KEY as the key and secret key / password as the value string.
* Passing the encrypted password is coming soon.
* *HTTP Method* is used to specify the method of interaction over the HTTP protocol. Please pass "GET" tothis parameter.
* *Bucket Region* is where the S3 bucket is physically hosted. Pass the region data found under this [table](http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) for the bucket the Pre-Signed Url needs to be generated.
* *TTL* is the *Time To Live* for the generated Pre-Signed URL. It should be provided in seconds. If provided as 0, it is set to expire in 1Hr.
* *Proxy Host and Port* is needed to download the list of files and folders in the virtually hosted S3 bucket.
## Usage
*s3-presigned-url* is available as a dependency jar in Maven central repository.
### Maven/Gradle
```xml
com.github.gkarthiks
s3-presigned-url
0.1.1
```
### Apache Buildr
```'com.github.gkarthiks:s3-presigned-url:jar:0.1.1'```
### Apache Ivy
``` ```
### Groovy Grape
```
@Grapes(
@Grab(group='com.github.gkarthiks', module='s3-presigned-url', version='0.1.1')
)
```
### Gradle/Grails
```compile 'com.github.gkarthiks:s3-presigned-url:0.1.1'```
### Scala SBT
```libraryDependencies += "com.github.gkarthiks" % "s3-presigned-url" % "0.1.1"```
### Leiningen
```[com.github.gkarthiks/s3-presigned-url "0.1.1"]```
## Implementation
#### Using method arguments
* Create a Map for the credentials.
* Construct the End Point URL based on this [Amazon Reference table](http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region).
* Pass "GET" as httpMethod.
* Pass the bucket region where it is hosted.
* Provide the desired expiry time in seconds for TTL.
* Provide the Proxy port and host to retrieve the listof file / folders hosted.
Java
To get the Pre-Signed URL,
```
Map s3Creds = new HashMap<>();
s3Creds.put(S3PresignedURL.AWS_ACCESS_ID, );
s3Creds.put(S3PresignedURL.AWS_SECRET_KEY, );
String preSignedURL = S3PresignedURL.getS3PresignedURL(, s3Creds, "GET", , 3600);
```
To get the list of files,
```
Map s3Creds = new HashMap<>();
s3Creds.put(S3PresignedURL.AWS_ACCESS_ID, );
s3Creds.put(S3PresignedURL.AWS_SECRET_KEY, );
List lstS3Files = helper.getListFiles(, s3Creds, "GET", , 3600, , );
```
#### Using Properties File
* Create a .properties file in the `resource` folder.
* Have the following key with case sensitivity and corresponding values assigned to it.
```
s3.endpoint.url=
s3.http.method= GET
s3.bucket.region=
s3.ttl=
s3.access.id=
s3.secret.key=
s3.proxy.host=
s3.proxy.port=
```
Java
To get the Pre-Signed URL,
```
String preSignedURL = S3PresignedURL.getS3PresignedURL(".properties");
```
To get the list of files,
```
List lstS3Files = S3PresignedURL.getFilesList(".properties");
```