Tweestapsverificatie en single sign-on

Tweestapsverificatie vraagt na je wachtwoord om een code van je telefoon. Een gestolen wachtwoord is dan niet genoeg om in SendKettle te komen. Met single sign-on logt je team in met het account dat ze op het werk al gebruiken, via elke OpenID Connect-provider.

Tweestapsverificatie aanzetten voor je account

Iedereen kan dit voor het eigen account doen, welke rol je ook hebt.

  1. Klik onderaan het menu op je naam en dan op Profiel om Je profiel te openen.
  2. Klik in het vak Tweestapsverificatie op Tweestapsverificatie instellen.
  3. Open een authenticator-app op je telefoon, zoals 1Password, Google Authenticator, Microsoft Authenticator of Aegis.
  4. Scan de QR-code met de app. Lukt scannen niet, typ dan de sleutel onder de QR-code over in de app. Op een telefoon kun je ook op Openen in een authenticator-app op dit apparaat tikken.
  5. Typ de code van 6 cijfers die de app toont en klik op Tweestapsverificatie aanzetten.
  6. Bewaar de tien herstelcodes die verschijnen. Je ziet ze maar één keer. Bewaar ze in een wachtwoordbeheerder of print ze.

De QR-code wordt op je eigen server gemaakt. De geheime sleutel gaat nooit naar een andere dienst en wordt versleuteld opgeslagen.

Bedenk je je voor stap 5, klik dan op Instellen annuleren.

Inloggen met een code

  1. Vul op de inlogpagina je e-mailadres en wachtwoord in en klik op Inloggen.
  2. Typ de code van 6 cijfers uit je authenticator-app en klik op Inloggen.

Een code werkt één keer en is ongeveer anderhalve minuut geldig. Loopt de klok van je telefoon een beetje achter, dan is dat geen probleem. Na vijf verkeerde codes moet je je wachtwoord opnieuw invullen.

Codes per sms en beveiligingssleutels

Als de authenticator-app aan staat, kun je andere manieren toevoegen om de tweede stap te halen. Bij het inloggen kies je dan wat je bij de hand hebt.

Om codes per sms te krijgen (de eerste werkruimte heeft een sms-provider nodig onder Instellingen, Kanalen):

  1. Open Je profiel en ga naar Tweestapsverificatie.
  2. Typ onder Codes per sms je mobiele nummer met landcode en klik op Code sturen.
  3. Typ de code uit de sms en klik op Codes per sms aanzetten.

Klik bij het inloggen op Sms me een code en typ de code die je krijgt. Hij werkt 10 minuten.

Om een beveiligingssleutel of passkey toe te voegen:

  1. Geef onder Beveiligingssleutels en passkeys de sleutel een naam, bijvoorbeeld "YubiKey".
  2. Klik op Beveiligingssleutel toevoegen.
  3. Raak de sleutel aan, of bevestig met je vingerafdruk, gezicht of pincode als je browser erom vraagt.

Klik bij het inloggen op Beveiligingssleutel gebruiken en raak de sleutel aan. APP_URL moet het adres zijn waarop je de site opent, want sleutels werken alleen op de site waar ze zijn toegevoegd.

Zet je tweestapsverificatie uit, dan verdwijnen ook je telefoonnummer en beveiligingssleutels.

Je telefoon kwijt

  1. Klik in het scherm voor de code op Gebruik in plaats daarvan een herstelcode.
  2. Typ een van je herstelcodes en klik op Inloggen met herstelcode.
  3. Ga naar Je profiel en stel tweestapsverificatie opnieuw in op je nieuwe telefoon, of maak nieuwe herstelcodes.

Elke herstelcode werkt één keer. Je profiel laat zien hoeveel je er nog hebt. Heb je er geen meer en ook geen telefoon? Vraag dan een Eigenaar of Beheerder om hulp: die kan je account verwijderen en je opnieuw uitnodigen.

Nieuwe herstelcodes of uitzetten

  1. Ga naar Je profiel.
  2. Typ je huidige wachtwoord in het vak Tweestapsverificatie.
  3. Klik op Nieuwe herstelcodes aanmaken (de oude werken dan niet meer) of op Tweestapsverificatie uitzetten.

Een link om je wachtwoord te herstellen slaat de code niet over. Na een nieuw wachtwoord log je in met dat wachtwoord en je code.

Wijzig of herstel je je wachtwoord, dan word je overal anders uitgelogd: andere browsers, telefoons en "onthoud mij"-logins moeten opnieuw inloggen met het nieuwe wachtwoord. Je API-sleutels worden ook ingetrokken.

Tweestapsverificatie verplicht maken voor iedereen

Installatiebeheerders (de Eigenaren van de eerste werkruimte, zie Werkruimtes) kunnen tweestapsverificatie verplicht maken en single sign-on instellen.

  1. Ga naar Instellingen en open het tabblad Beveiliging.
  2. Vink Tweestapsverificatie verplicht maken voor iedereen aan.
  3. Klik op Beveiligingsinstellingen opslaan.

Mensen zonder tweestapsverificatie gaan de volgende keer dat ze een pagina openen naar hun profiel om het in te stellen. Tot ze dat doen, kunnen ze alleen tweestapsverificatie instellen, hun taal en thema kiezen, de help lezen en Uitloggen: geen API-sleutels, e-mail- of wachtwoordwijzigingen, en hun bestaande API-sleutels, gekoppelde apps (zoals een AI-assistent) en logins op de SMTP-relay werken niet meer. Zolang het verplicht is, kan niemand de eigen tweestapsverificatie uitzetten.

Mensen die inloggen met single sign-on en hier geen tweestapsverificatie hebben ingesteld, hoeven dat niet te doen, omdat je identiteitsprovider ze controleert. Zet bij je provider een tweede stap aan als je die ook voor hen wilt. Wie hier wel tweestapsverificatie aanzette, typt na single sign-on nog steeds de code.

Single sign-on instellen

Single sign-on werkt met elke provider die OpenID Connect ondersteunt, bijvoorbeeld Microsoft Entra ID, Google Workspace, Okta, Auth0, Keycloak en Authentik.

  1. Ga naar Instellingen en open het tabblad Beveiliging.
  2. Kopieer de Redirect-URL in het vak Single sign-on.
  3. Registreer bij je provider een nieuwe webapplicatie (soms client of app-registratie genoemd). Plak daar de redirect-URL. Sta de scopes openid, email en profile toe.
  4. Kopieer de issuer-URL, de client-ID en het clientgeheim bij je provider.
  5. Vink in SendKettle Single sign-on aanzetten aan en vul Issuer-URL, Client-ID en Clientgeheim in.
  6. Wijzig eventueel Knoptekst op de inlogpagina, bijvoorbeeld in "Inloggen met Acme".
  7. Klik op Beveiligingsinstellingen opslaan.

Bij het opslaan leest SendKettle de configuratie van de provider via de issuer-URL, om te controleren of het werkt. De issuer moet een openbaar https-adres zijn. Het clientgeheim wordt versleuteld opgeslagen. Laat het veld voor het geheim later leeg om het huidige te houden.

De inlogpagina toont nu boven het formulier met het wachtwoord een knop voor single sign-on. Wachtwoorden blijven werken. Je kunt dus altijd inloggen, ook als de provider niet werkt.

Single sign-on met SAML

Voor providers die SAML 2.0 gebruiken (Okta, Microsoft Entra ID, Google Workspace, OneLogin, Keycloak en andere) gebruik je het vak SAML-single sign-on op hetzelfde tabblad. Je kunt SAML, OpenID Connect of allebei gebruiken.

  1. Ga naar Instellingen en open het tabblad Beveiliging.
  2. Kopieer in het vak SAML-single sign-on de Entity ID (audience) en de ACS-URL (antwoord-URL). Metadata downloaden geeft ze allebei in één bestand, als je provider dat kan importeren.
  3. Maak bij je provider een SAML-applicatie met die twee waarden. Zet de NameID op het e-mailadres, of stuur het in een attribuut met de naam email. Laat de provider de assertion ondertekenen met RSA-SHA256.
  4. Kopieer de entity ID van de provider (ook wel issuer), de inlog-URL (SSO-URL) en het ondertekeningscertificaat.
  5. Vink in SendKettle SAML-single sign-on aanzetten aan, vul Entity ID van de identiteitsprovider en Inlog-URL (SSO-URL) in en plak het Ondertekeningscertificaat.
  6. Staat het e-mailadres in een ander attribuut, typ dan de naam ervan bij Attribuut met e-mailadres.
  7. Klik op SAML-instellingen opslaan.

De inlogpagina toont nu Inloggen met SAML-single sign-on (of de knoptekst die je koos). SendKettle accepteert alleen antwoorden die met dat certificaat zijn ondertekend, voor deze app bedoeld zijn, naar de ACS-URL zijn gestuurd, nog geldig zijn en vanaf de eigen inlogpagina zijn gestart; elk antwoord werkt één keer. Versleutelde assertions worden niet ondersteund. Automatische accounts, de standaardrol en de toegestane domeinen onder Wie mag inloggen gelden ook voor SAML.

Vink Single sign-on verplichten voor gekoppelde accounts en de toegestane domeinen aan om wachtwoorden uit te zetten voor iedereen die aan de provider gekoppeld is of een adres op je Toegestane e-maildomeinen heeft. Zij kunnen niet met een wachtwoord inloggen en geen resetlink aanvragen, zodat de tweede stap, voorwaardelijke toegang en het afsluiten van accounts bij de provider altijd gelden. Eigenaren houden hun wachtwoord, zodat je er nog in kunt als de provider niet werkt.

Wie mag inloggen

  • Wie al eerder met single sign-on inlogde, wordt herkend aan het account bij de provider, ook als het e-mailadres verandert.
  • Wie hier al een account heeft met hetzelfde e-mailadres, wordt daaraan alleen gekoppeld als de provider bevestigt dat het adres geverifieerd is (email_verified), en pas nadat diegene hier één keer inlogt met het wachtwoord (en de code), in dezelfde browser en binnen tien minuten. De inlogpagina vraagt daarom. Een adres op je Toegestane e-maildomeinen is op zich niet genoeg.
  • Iemand die nieuw is, krijgt alleen een account als Maak een account aan voor nieuwe mensen als ze voor het eerst inloggen aangevinkt is. Die krijgt de Rol voor nieuwe accounts, wat alles tot en met Beheerder kan zijn. Eigenaren worden altijd met de hand uitgenodigd.
  • Is Toegestane e-maildomeinen ingevuld, dan kunnen alleen adressen op die domeinen inloggen met single sign-on.

Zonder automatische accounts nodig je mensen eerst uit op de pagina Gebruikers. Daarna kunnen ze inloggen met single sign-on.

Als het niet werkt

De inlogpagina toont de reden, en de auditlog legt een regel "Mislukte single sign-on" vast. Veelvoorkomende oorzaken:

  • De redirect-URL bij je provider is niet precies gelijk aan die in Instellingen.
  • De client-ID of het geheim is gekopieerd met een spatie aan het eind.
  • De provider deelt het e-mailadres niet. Sta de scope email toe.
  • Het adres staat niet op je toegestane domeinen, of er is geen account en automatische accounts staan uit.