Twee-factorauthenticatie
← Terug naar de documentatie-index
Twee-factorauthenticatie (2FA) voegt een tweede stap toe aan het inloggen: na je wachtwoord voer je een korte code in van een authenticatie-app op je telefoon. Zelfs als iemand je wachtwoord achterhaalt, kan diegene zonder jouw apparaat niet binnenkomen.
Het werkt met elke standaard TOTP-authenticator (Google Authenticator, Authy, 1Password, Microsoft Authenticator, en andere), en het is beschikbaar voor elk account, niet alleen voor beheerders. Het beveiligen van je eigen login is geen serverbeheertaak, dus kijkers en operators kunnen het ook inschakelen.
2FA inschakelen
Section titled “2FA inschakelen”Open het accountmenu (je initialen of profielfoto, rechtsboven) en kies 2FA.

Je krijgt een inschrijvingsdialoog:

- Scan de QR-code met je authenticatie-app, of tik op Kopiëren en voer de handmatige sleutel met de hand in.
- Typ de 6-cijferige code die je app nu toont.
- Bevestig je wachtwoord. Het inschakelen van 2FA controleert je wachtwoord opnieuw, zodat een onbedoeld openstaande sessie het niet kan inschakelen met het apparaat van iemand anders.
- Klik op Inschakelen.
Bewaar je back-upcodes
Section titled “Bewaar je back-upcodes”Zodra 2FA is ingeschakeld, toont het paneel een set eenmalige back-upcodes.

Elke code werkt één keer om in te loggen als je ooit de toegang tot je authenticatie-app verliest. Bewaar ze ergens veilig (een wachtwoordmanager is ideaal), want ze worden niet opnieuw getoond. Je kunt op elk moment een nieuwe set genereren (wat de oude ongeldig maakt).
Inloggen met 2FA
Section titled “Inloggen met 2FA”Vanaf dan heeft inloggen een tweede stap. Na je gebruikersnaam en wachtwoord vraagt het paneel om je code:

Voer de huidige 6-cijferige code van je app in (of een van je back-upcodes) en je bent binnen. Totdat je deze stap voltooit, is de sessie niet ingelogd: deze kan geen enkele pagina of API bereiken.
2FA beheren of uitschakelen
Section titled “2FA beheren of uitschakelen”Open dezelfde 2FA-vermelding in het accountmenu terwijl deze is ingeschakeld. Na het bevestigen van je wachtwoord kun je:
- Back-upcodes opnieuw genereren geeft een nieuwe set uit en beëindigt de oude.
- 2FA uitschakelen verwijdert het van je account.
Beide controleren eerst je huidige wachtwoord.
Je telefoon en je back-upcodes kwijt?
Section titled “Je telefoon en je back-upcodes kwijt?”Een beheerder kan de 2FA van een andere gebruiker resetten via Instellingen → Gebruikers (2FA resetten in het actiemenu van die gebruiker). Dat wist 2FA voor het account, zodat de gebruiker kan inloggen met alleen zijn wachtwoord en het opnieuw kan instellen. Beheerders kunnen hun eigen 2FA niet zonder wachtwoord resetten. Zij doorlopen de normale, met wachtwoord beveiligde uitschakeling, zodat een gekaapte beheerderssessie zijn eigen tweede factor niet kan verwijderen.
Goed om te weten
Section titled “Goed om te weten”- Codes zijn tijdsgebonden en wisselen elke 30 seconden; het paneel accepteert een kleine klokafwijking en herstelt stilzwijgend als de klok van de server later wordt gecorrigeerd.
- Een code kan niet opnieuw worden gebruikt: zodra deze is gebruikt om in te loggen, werkt diezelfde code niet meer binnen zijn periode.
- Verkeerde codes worden beperkt in hun aantal. De beperking is gedeeld met de wachtwoordstap (een vergrendeling per account plus een
RATE_LIMIT_AUTH_PER_15MINbeperking per IP-adres), dus het invoeren van een correct wachtwoord kan de teller niet resetten vlak voordat je de 6-cijferige code raadt. - 2FA-wijzigingen (inschakelen, uitschakelen, resetten, gebruik van back-upcodes) worden allemaal vastgelegd in het Activiteitenlogboek.