This is a demo app showing one way you can use Virgil Crypto Library in javascript to create a secure file sharing app. After you complete the steps in Setup section you will be able to download, decrypt and view encrypted media files from a browser.
$ git clone https://github.com/VirgilSecurity/virgil-secure-sharing.git
$ cd ./secure-sharing
$ npm install
In order to decrypt files the app needs a private part of the key used to encrypt the files, private key password and recipient id used during encryption. Set these as environment variables before starting the server. For example, execute:
PRIVATE_KEY=<base64_encoded_private_key> PRIVATE_KEY_PASSWORD=<private_key_password> RECIPIENT_ID=<recipient_id> npm run start
to set variables and start a server on Unix platform.
To encrypt the files you can use Virgil CLI tool. Instructions on how to encrypt data without using Virgil Services can be found here.
Upload the files to some publicly available storage (e.g. Dropbox) so that they can be downloaded by the app.
In order for decrypted media files to be opened accordingly to their type you must provide MIME type of the file along with it's download url. You do that by creating a JSON object with two properties "type" and "url":
{
"type": "video/mp4",
"url": "https://example.com/encrypted_video"
}
The metadata are passed to the app via url query parameter named source. The value of that parameter should be a base64-encoded
metadata JSON. There are multiple ways to encode a string in base64 any of which should work fine for this example.
Now open your browser and point to http://localhost:3000/?source=<source> where <source> is the string obtained on the previous step.
For audio and video files only the following MIME types are supported:
- audio/aac (.aac)
- audio/mp4 (.mp4 .m4a)
- audio/mpeg (.mp1 .mp2 .mp3 .mpg .mpeg)
- audio/ogg (.oga .ogg)
- audio/wav (.wav)
- audio/webm (.webm)
- video/mp4 (.mp4 .m4v)
- video/ogg (.ogv)
- video/webm (.webm)
Due to the use of Blob objects the maximum file size is limited to 500Mb in Google Chrome browser.
In browsers where size of Blob is not restricted it is not guaranteed that files over ~700Mb will be successfully decrypted due to memory limitations.