Under the hood
This page lists exactly what Starseal does with your files. For the story behind it and the choices we weighed, read How Starseal was built.
What happens to a file
Your browser encrypts each file with AES-256-GCM before anything is uploaded. Files are cut into 1 MiB records; each record is sealed with its own number and a flag marking the last one, so records cannot be reordered, dropped or swapped between files without the check failing. The key is placed after the # in the link. Browsers do not send that part of a link to servers.
What the server sees
- It sees: a random drop id, the total encrypted size, how many files and parts there are, when things happened, and IP addresses while requests are in transit.
- It never sees: file names, file types, contents, the link key or the spoken phrase.
- It stores hashes of three secrets so it can check them without knowing them: a proof that you hold the link, a proof that you hold the full key (and phrase, if there is one), and the sender's receipt secret.
- If someone types their name when opening a drop, their browser encrypts it with a key made from the drop link (and the spoken phrase, if there is one), which the sender's receipt link also carries, so the server stores scrambled bytes. The server does record when each open has saved every file. The sender sees names and saved times on the receipt. Names are not checked, so anyone can type anything.
The spoken phrase
With the phrase option, half of the key is in the link and the other half comes from four words chosen at random from the EFF long wordlist (7,776 words). The words are stretched with PBKDF2-SHA256 at 600,000 rounds. The file list is only released after the server has checked the phrase, and five wrong phrases delete the drop, so someone who finds only the link cannot try guesses offline.
The Seal
Each drop has a Seal drawn from 32 bytes that depend on the drop's key and its exact encrypted file list. The sender and the recipient see the same Seal and the same three words. Comparing them over a phone call confirms you are both looking at the same drop. The encryption itself already detects tampering; the Seal is for spotting a swapped or fake link.
The Seal shows Te Iwa o Matariki, the nine stars of Matariki, at their real positions in the sky, with sizes from their real brightness. The cluster never changes shape. The bytes turn it (as the sky turns overnight), choose its colour, place faint background stars and set the 32 marks around the rim. When a drop is opened, the Seal shows Matariki rising at dawn: the heliacal rising of Matariki marks the Māori New Year. When a drop expires or is deleted, the stars rest.
| Whetū | Associated with |
|---|---|
| Matariki | health and wellbeing |
| Pōhutukawa | those who have passed on |
| Tupuānuku | food grown in the soil |
| Tupuārangi | food from the trees and the sky, such as fruit, berries and birds |
| Waitī | fresh water and the food it sustains |
| Waitā | the ocean and its food |
| Waipuna-ā-rangi | rain |
| Ururangi | the winds |
| Hiwa-i-te-rangi | wishes and aspirations for the year ahead |
Sources: Te Wānanga o Aotearoa, Te Iwa a Matariki (drawing on the research of Dr Rangi Matamua); AUT, The 9 Whetū of Matariki; Wikipedia, Matariki. Star positions and brightness: the SIMBAD database, operated at CDS, Strasbourg, France.
What Starseal cannot protect against
- A compromised server could send altered JavaScript that leaks keys. This is true of every tool that encrypts inside a web page. Starseal keeps its scripts small and loads nothing from other sites.
- A compromised phone or computer at either end.
- Someone who has the full link of a drop without a phrase. That is what the phrase option is for.
- Traffic analysis: sizes, timing and IP addresses.
Limits
Up to 2 GB and 100 files per drop. Drops expire after 1 hour, 1 day or 7 days, and can be opened once, up to 5 times, up to 10 times, or any number of times until they expire. Starseal runs on Cloudflare's free tier and refuses new drops before it would go over it.