Skip to content
vFileLock powered by VOIMARvFileLock powered by VOIMAR

How vFileLock works

Two people take part in every share: the person who shares the file, and the person who opens it. Here is each step, and what each of them sees.

Livewith planned items markedPlanned

Before the first file

  • Sign in with Voimar ID on gpg.voimar.co.za, the vFileLock app.
  • Accept the vFileLock terms once. You tick each statement; the acceptance is recorded with the time, your IP address and device, and your location only if you allow it.
  • For files at Restricted and above, acknowledge your organisation's classification policy once.
  • Your organisation's admin chooses a recovery option once, before anyone locks a file: a signed waiver, or key escrow under dual control.
    Coming key escrow. See Key escrow and recovery.

The sender, step by step

  1. Step 1: Drop the file in

    It stays on your device.
  2. Step 2: Choose the level

    Internal is already selected. Then the POPIA category (personal information, financial, contact details, health, criminal record, biometric, children's information, or no personal information) and the kind of file (document, image, video, audio, call recording or other).
  3. Step 3: Choose who may open it

    • an e-mail address: they get a one-time code by e-mail;
    • a person in your organisation: they sign in with Voimar ID, no code needed.
    • Coming a South African mobile number, with the code by SMS.
  4. Step 4: Pick a preset, or set the rules yourself

    • Standard: one person, 7 days, 10 opens, view only.
    • Confidential: one person, 24 hours, open once, view only, gone after reading.
    • Secret: a person in your organisation, first device only, open once.
    • More rules: available for 1 hour, 24 hours, 7 days or 30 days, or until a date; 1 to 50 opens; allow a download; terms first; first device only; e-mail me at every open; burn after reading.
  5. Step 5: Say why this person needs it, when the level needs an approval

  6. Step 6: Press Lock and share

    Your browser locks the file with a fresh 256-bit key, splits the key in two, keeps one half for the link and sends the other half, sealed, to vFileLock.
  7. Step 7: Copy the link

    It is shown once: vFileLock cannot rebuild it. Send it any way you like. The code goes separately to the person you chose, so the link and the code never travel together.

What the sender sees

  • The level label on the file, everywhere it appears.
  • My shares with rules: each share's state (live, waiting for approval or ended), opens used and left, and when it ends.
  • Who opened what, and when, with the IP address and device.
  • An e-mail when someone forwards the link, breaks a rule or is locked out. An e-mail at every open, if you ask for it.
  • Revoke now, extend (within the level's limits), or burn the file.

When a share needs approval

  • The share waits. You may send the link straight away; it opens only once the share is approved.
  • The approver gets an e-mail and sees the request in their queue: the label, the file name, the owner, the recipient, the rules and your purpose. Never the file.
  • Approved: the share goes live, and its time limit starts then. Declined, or no answer within 72 hours: the share ends and its key half is destroyed.
  • Top Secret needs two different approvers, and neither may be the owner.

The recipient, step by step

  1. Step 1: Open the link

    There is nothing to install. A recipient outside the organisation needs no account.
  2. Step 2: See who sent it

    See who sent it (their name and organisation), the label, the file name, where the code will go (shown masked, like t*****@e******.co.za), how many opens are left and when the link ends.
  3. Step 3: Accept the terms first, if the sender asked for that

  4. Step 4: Ask for the code

    It arrives by e-mail, has 6 digits and lasts 10 minutes. A person in the sender's organisation signs in with Voimar ID instead.
  5. Step 5: Enter the code

    When every rule passes, the browser receives the second key half, joins the two halves and opens the file in the page.
  6. Step 6: Read it

    PDFs, images, plain text, audio and video open in the browser. The label shows at the top and bottom, and a watermark with your name or address, the date and time and the share's number lies over every page and over video. With view only there is no download or print button.

What the recipient never gets

  • Other people's shares, or any list of files.
  • A way in through a forwarded link. The code goes only to the named person, and a forwarded link that asks for a code is reported to the sender.
  • A second chance on another device, where the sender chose first device only. Clearing the browser counts as a new device.

Behind the scenes

Sender’s browser
  1. Locks the file with a fresh 256-bit key
  2. Splits the key in two
AB
AIn the link, after the #

Browsers never send this part of a link to a server. Send the link any way you like.

BSealed at vFileLock

Released only when every rule passes: the right person, the code, the time, the opens left.

PersonCodeTimeOpensApproval
Recipient’s browser
  1. Proves who it is: the code, or Voimar ID
  2. Joins A and B
  3. Opens the file in the page
AB
Either half on its own says nothing about the key. VOIMAR never holds both halves.

The sender's browser locks the file and splits the key. Half A goes into the link, after the #, a part browsers never send to a server. Half B goes to vFileLock, sealed. The recipient's browser proves who it is with the code or the sign-in. Only then does vFileLock release half B. The browser joins A and B and opens the file. More on Security and standards.

Two other ways to lock

  • With a secret phrase. vFileLock makes a 20-character phrase. Give it by phone or SMS, never in the same message as the file.
  • For people who have a vFileLock key. Only their own key opens it.

Either way the link expires and counts its downloads, and you can stop it. Any standards-compliant OpenPGP program also opens these files with the right phrase or key.

See vFileLock with your own files and rules

Bring your Information Officer, your security officer and your IT lead. Or open vFileLock and lock your first file.