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.
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
Step 1: Drop the file in
It stays on your device.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).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.
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.
Step 5: Say why this person needs it, when the level needs an approval
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.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.
The recipient, step by step
Step 1: Open the link
There is nothing to install. A recipient outside the organisation needs no account.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, liket*****@e******.co.za), how many opens are left and when the link ends.Step 3: Accept the terms first, if the sender asked for that
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.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.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
- Locks the file with a fresh 256-bit key
- Splits the key in two
Browsers never send this part of a link to a server. Send the link any way you like.
Released only when every rule passes: the right person, the code, the time, the opens left.
- Proves who it is: the code, or Voimar ID
- Joins A and B
- Opens the file in the page
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.
