# Herstelzin en shares

Hoe je sleutel in drieën wordt gesplitst, waarom twee delen genoeg zijn en waarom Databeamer hem niet voor je kan resetten.

## Drie shares, twee zijn genoeg

Je hoofdsleutel wordt nooit op één plek bewaard. Tijdens de installatie wordt hij gesplitst in drie **shares**:

| Share             | Waar die staat                                                                     |
| ----------------- | ---------------------------------------------------------------------------------- |
| **Apparaatshare** | Op elk apparaat dat je hebt ingesteld, beschermd door de pincode van dat apparaat. |
| **Servershare**   | Op de servers van Databeamer. Op zichzelf onthult die niets.                       |
| **Herstelzin**    | De 24 woorden die je tijdens de installatie hebt bewaard.                          |

Elke **twee van de drie** bouwen de sleutel weer op. Dagelijks doen je apparaatshare en de servershare het werk. Raak je al je apparaten kwijt, dan brengen de herstelzin plus de servershare je terug. Je ziet dit onder **Instellingen › Beveiliging › Shares & Apparaten**.

> **Beveiligingsdetails**
>
> - De master key wordt op je apparaat gegenereerd en gesplitst met Pedersen verifiable secret sharing op drempel 2. Eén share alleen zegt niets over de sleutel.
> - De server share is willekeurig en wordt pas vrijgegeven nadat je bent ingelogd. Elke device share is willekeurig en verzegeld onder de pincode van het apparaat met Argon2id. Geen enkele share wordt afgeleid uit een wachtwoord of pincode.
> - De herstelzin codeert 32 willekeurige bytes als 24 BIP39-woorden. Daaruit wordt een recovery key pair afgeleid; de recovery share wordt voor dat key pair versleuteld en op de server bewaard, opnieuw uitgegeven telkens als de shares veranderen, zodat de zin blijft werken.

## Waarom Databeamer je account niet kan herstellen

Wij hebben maar één share, en één share is nutteloos. Dat is precies de bedoeling: niemand bij Databeamer, en niemand die bij Databeamer inbreekt, kan je gegevens lezen. De keerzijde is dat als je je apparaten **én** je herstelzin kwijtraakt, niemand je gegevens kan terughalen. Ook wij niet.

Bewaar de zin op een plek die het verlies van je laptop of telefoon overleeft: een wachtwoordmanager, een geprinte kopie op een veilige plek, of allebei.

## De zin gebruiken

Kies op een nieuw apparaat **Gebruik je herstelzin** op het scherm **Je account ontgrendelen**, voer de 24 woorden in en kies **Ontgrendelen**. De zin blijft geldig; gebruiken verandert hem niet.

## De zin opnieuw genereren

Onder **Instellingen › Beveiliging › Herstelzin** vervangt **Opnieuw genereren** de zin door een nieuwe en maakt de oude ongeldig. Doe dit als:

- iemand anders de zin mogelijk heeft gezien,
- hij stond op een apparaat dat je sindsdien bent kwijtgeraakt of hebt ingetrokken,
- je hem de eerste keer nooit goed hebt bewaard (kies **Genereren** als er nog geen is).

Bewaar de nieuwe zin net zo zorgvuldig als de eerste.

> **Beveiligingsdetails**
> Opnieuw genereren geeft een nieuwe zin en vernieuwt de shares, zodat de oude zin niet meer met de server share te combineren is. De wijziging wordt als ondertekende entry in het auditlog geschreven.