|
Features :
This add-on allows to upload files and folders to Amazon Simple Storage Service (Amazon S3) bucket. It works on the top of jClientUpload applet. It includes the following features:
- Amazon S3 REST support.
- Upload files and folders to a bucket.
- MD5 digest support.
- ACL parameter for uploaded object.
- Large upload support.
Screenshots :
 |
 |
 |
| Windows Vista |
MacOSX |
Linux |
Online demonstration :
You can try S3Upload add-on here. You have to setup your S3 setting (AWSAccessKeyID, AWSSecretKey and target bucket name) through S3->Settings menu before uploading. Front-end uses Java look and feel.
Installation :
S3Upload is a jClientUpload add-on so you do need jClientUpload installed before installing it. Here are instructions :
1 - Copy dist/lib/s3upload.jar under lib/ folder (where others jClientUpload JAR files
are stored).
2 - Copy i18n_bar_s3.properties, i18n_pane_s3.properties and all .html + .js files
under the same folder as jClientUpload HTML/JavaScript files.
3 - Modify dist/applet_s3.js or dist/applet_s3.js
to setup basic parameters and open the HTML file in your browser to try it.
4 - Optional : Modify .properties files to customize front-end.
Parameters :
Sample provided in S3Upload is ready-to-use. You just have to fill in S3 settings through S3 menu before uploading.
FAQ : |
|
[Installation][S3 Settings][Front-end customization] [Others] |
- S3Upload fails to load (gray box with red cross) ?
You must install jClientUpload first. Then you have to follow installation instructions above (copy s3upload.jar under lib/ folder ...).
- S3Upload is installation is fine but it still fails to load ?
Are you using a Microsoft IIS web server ? If so, you need to allow .properties file serving by enabling ".properties" extension to "text/plain" mime-type. This issue is already explained in jClientUpload FAQ.
- Can I use S3Upload Enterprise with jClientUpload Pro ?
No, S3Upload Pro works with jClientUpload Pro only. S3Upload Enterprise requires jClientUpload Enterprise.
- How can I trust in the applet because it asks me my AWSSecretKey ?
The AWSSecretKey is required to sign HTTP upload requests. It DOES NOT go outside the applet that runs on your computer. If you want to check it yourself then you can purchase the S3Upload Enterprise that includes full source code.
- Where do I setup my S3 bucket name where files will be uploaded ?
Follow S3 -> S3 Settings menu:
- How to setup ACL for uploaded objects ?
Same as question above.
- Can I upload files and folders recursively to my S3 bucket ?
Yes, it's the same parameters as in jClientUpload. Enable "folderdepth" parameter and "relativefilename" extra parameters as shown below:
<PARAM NAME="folderdepth" VALUE="-1">
<PARAM NAME="param4" VALUE="relativefilename">
<PARAM NAME="value4" VALUE="true">
Uploaded object key will be: folder1/subfolder2/yourfilename.ext
- Is it possible to compress file before upload to the bucket ?
Yes, it's the same parameter as in jClientUpload. You can either ZIP or GZIP each file to upload:
<PARAM NAME="ziponfly" VALUE="zip">
- I get RequestTimeTooSkewed error, what's wrong ?
Amazon server checks for date and time for the incoming request. Your computer is not at the correct date/time. Update it.
- Amazon S3 allows MD5 digest checking, how to enable it ?
Add the following parameter in applet_s3.js JavaScript file:
<PARAM NAME="checksum" VALUE="md5">
- How to internationalize S3Upload resources (messages, colors ...) ?
In the same way as you can internationalize jClientUpload resources through i18n_bar_s3.properties and i18n_pane_s3.properties. See FAQ.
- How to remove S3 item from menu ?
Comment menu.s3 and menu.s3.settings in i18n_pane_s3.properties.
- Can I pass S3 settings in applet parameters ?
Yes, but it is NOT RECOMMENDED because you will expose your S3 settings to anyone loading the applet. So make sure to understand it before proceeding:
<PARAM NAME="param3" VALUE="s3bucket">
<PARAM NAME="value3" VALUE="yourbucketname">
<PARAM NAME="param4" VALUE="awsaccesskeyid">
<PARAM NAME="value4" VALUE="youraccesskeyid">
<PARAM NAME="param5" VALUE="s3acl">
<PARAM NAME="value5" VALUE="private">
Values for s3acl could be: "public-read", "public-read-write", "private" and "authenticated-read". Default ACL is private.
- Is it possible to pass secret key in applet parameters too ?
Yes, but once again it is NOT RECOMMENDED because you will expose your S3 settings to anyone loading the applet. So make sure to understand it before proceeding:
<PARAM NAME="param6" VALUE="awssecretkey">
<PARAM NAME="value6" VALUE="yoursecretkey">
Note that you can Base64 encode any parameter by enclosing it with [] chars. Base64 is not enryption (it could be reversed) but it's more secure than plain text.
We provide a base64 encoder/decoder service here. For instance, if your secret key is ABC123QWERTY then you will setup:
<PARAM NAME="param6" VALUE="awssecretkey">
<PARAM NAME="value6" VALUE="[QUJDMTIzUVdFUlRZ]">
- Can I run S3Upload as standalone Java application instead of applet ?
Yes, run standalone_s3.bat script for Windows after updating JAVA_HOME variable.
|
|
