A quick and simple encrypted file store for easy sharing within your organisation
CSS JavaScript HTML Python

README.md

Korra

Transferring files securely is a pain in the ass, especially if you work in an office environment where the technologies are heavily fragmented, and/or you're working with users who are not particularly technically savvy.

The common denominator for many office environments consists of two tools: websites and (unencrypted) email. Slightly more advanced companies may make use of IRC, Slack, and maybe some combination of Dropbox and Google Drive. None of these tools make it easy to transfer files one-to-one safely & securely, so I wrote this. Do with it as you will.

upload success download

Installation

As Korra is effectively an anonymous file store, it isn't meant to be a public web service, lest you run the risk of being an unwitting participant in distribution of files you may not want to distribute. Instead, this code is meant to be plugged into a private server somewhere that's accessible within your office and secured with HTTPS.

Setup

Docker

We're using docker-compose, so it's a pretty quick process:

  • Copy docker-compose.env.examplto docker-compose.env and edit it for tastes. The only thing you should need to fiddle with is KORRA_SALT and KORRA_SECRET_KEY. Everything else should work within the containers as you'd expect.
  • Run docker-compose up and then open a browser at http://localhost:8000/.

The Hard Way (not really)

For the most part, this is just a plain & simple Django project. There's a gunicorn sample file and a Systemd .service file to get you started, and there's only one tricky part that's worth mentioning here: the environment variables.

Basically anywhere you might want to run this will have to define a set of environment variables, so here's a list that you can use for reference:

  • KORRA_SALT: A long random string used to salt your file encryption. Set this once and don't change it unless you're cool with any existing files being irretrievable. The longer this string, the stronger the encryption, so about 128 characters is a good place to start.
  • KORRA_SECRET_KEY: The Django secret key. This should be a long random string. Don't change it once it's set. A good length is about 64 characters.
  • KORRA_MEDIA_ROOT: Your Django media root. See the Django docs covering media files for more info here.
  • KORRA_STATIC_ROOT: Your Django static root. Seed the Django docs on staticfiles for more info.
  • KORRA_DBNAME: The database name. If you're using Sqlite, you can skip this, otherwise we assume you've got PostgreSQL running and this is your db name.
  • KORRA_DBUSER: Ditto
  • KORRA_DBPASS: Ditto
  • KORRA_DOMAIN: The domain you're hosting this on. If you're not using the sample gunicorn script though, you can skip this.

But how exactly do you deploy this on say, your Ubuntu box at home running Apache or Nginx? For that, the only thing you really need to know is that this is a standard Django project, so deploying this project should work just like every other Django setup. For details on how a typical Djano project is deployed, see the Django documentation.

The User Journey

  1. Sender uploads file and gives it a password, and optionally provides a time limit value.
  2. The server symmetrically encrypts the file and stores it locally.
  3. The sender is redirected to a thank you page with a URL for the file.
  4. The sender copy/pastes this URL into whatever channel they might have to communicate with their target user and passes on the password to them (hopefully) by some other means.
  5. The recipient goes to the URL, types in the password, and gets the file.
  6. Depending on the rules set by the sending user, the file is deleted once it's been downloaded, or is deleted after a fixed time.

Why Korra?

Given the nature of this project, I was looking for a name of a famous medium between parties, someone who helped with communication, and I settled on the Avatar. However, given that that word can be ambiguous, I opted for Korra, in reference to the title character in the excellent Nickelodeon series The Legend of Korra.