Hoppa till innehåll

MFA med OneGate: vem gör vad

Eneo och OneGate · MFA

Vad Eneo behöver i inloggningsbiljetten, vad som ställs in i våra två OneGate-instanser, vad vi frågar MobilityGuard om och vad vi kan se själva.

  • Eneo ska kunna kräva MFA för ett arbetsutrymme (space). Eneo kontrollerar inte koder eller metoder. Det gör IdP:n, alltså OneGate.
  • Eneo behöver bara veta en sak om varje inloggning: gjordes den med MFA, ja eller nej. Svaret läser Eneo i den signerade inloggningsbiljetten (id-token).
  • Därför behöver vi ett värde i biljetten som betyder MFA. Vilka metoder som räknas som MFA avgörs i OneGate.
  • Dessutom behöver vi ett av två: att OneGate tar emot en begäran om MFA från Eneo, eller att MFA är obligatoriskt för Eneos klient.
  • Eneo följer standarden OpenID Connect och bygger ingenting särskilt för OneGate.
OneGateloggar in personenoch avgör vilka metodersom räknas som MFAskickarid-token, påhittade värden"sub": "7f3c9e…""acr": "https://exempel.se/loa/mfa""amr": ["pwd", "otp"]"auth_time": 1762934400jämförsEneojämför värdet meddet inställda värdetMFA: ja eller nejNär MFA behövs räcker ett av två sätt:Eneo begär MFA av OneGatemed parametern acr_values eller claimsellerMFA är obligatoriskt för Eneos klientdå behöver Eneo inte begära någotOneGateloggar in personen och avgörvilka metoder som räknas som MFAskickarid-token, påhittade värden"sub": "7f3c9e…""acr": "https://exempel.se/loa/mfa""amr": ["pwd", "otp"]"auth_time": 1762934400jämförsEneojämför värdet meddet inställda värdetMFA: ja eller nejNär MFA behövs räcker ett av två sätt:Eneo begär MFA av OneGatemed parametern acr_values eller claimsellerMFA är obligatoriskt för Eneos klientdå behöver Eneo inte begära något
Påhittade värden. Eneo läser bara den markerade raden och jämför den med det inställda värdet. Används amr i stället läser Eneo den raden. Den gråa raden behövs inte. Vilka metoder som ger värdet avgörs i OneGate.
Vem Gör
Eneo-teamet Skriver koden i Eneo, gör testinloggningen och läser själv det som går att se.
Det vi ser själva, provet
IdP- och IDM-gruppen Ställer in OneGate, först i testinstansen och sedan i produktion, och vet hur produktionen är inställd.
Det som ska gälla i OneGate, frågorna om instansen
MobilityGuard Företaget bakom OneGate. Svarar på vad OneGate kan, hur det ställs in och vad de rekommenderar.
Frågorna till MobilityGuard

Varje del går att skicka för sig. Koden i Eneo byggs oberoende av svaren; de avgör bara när MFA kan slås på.

Till IdP- och IDM-gruppen. Det här är vad Eneo behöver av instansen. Hur det ställs in i OneGate är frågan till MobilityGuard längre ner.

  1. Ett värde som betyder MFA, i id-token. Ett av följande räcker:
    • Helst acr (Authentication Context Class Reference): en sträng som väljs i OneGate, till exempel en URI för “flerfaktor”. I OneGate bestäms vilka inloggningssätt som ger värdet. Eneo jämför bara strängen med det värde som är inställt i Eneo.
    • Eller amr (Authentication Methods References): en lista av strängar som innehåller ett värde som bara finns vid MFA, till exempel mfa enligt RFC 8176.
  2. En inloggning utan MFA ska sakna värdet. Kan en inloggning utan MFA förekomma för Eneos klient ska den ge ett annat acr-värde, eller inget. Är alla inloggningar för klienten alltid MFA räcker det att vi vet det.
  3. Ett sätt att få MFA när det behövs. Ett av följande:
    • OneGate tar emot en begäran om MFA från Eneo och kräver då MFA. Standarden har två sätt: parametern acr_values med värdet, eller parametern claims med acr som “essential”.
    • MFA är obligatoriskt för Eneos klient i OneGate. Då behöver Eneo inte begära något.
  4. Rätt format. acr är en sträng. amr är en lista av strängar, också när den bara har ett värde: ["mfa"], inte "mfa".
  5. Som i dag för inloggningen: id-token har kid i huvudet och nyckeln finns i JWKS. Biljetten har email, och email_verified är true (boolean) för att ett nytt konto ska kunna skapas.
  6. Först i test, sedan produktion. När IdP- och IDM-gruppen har bekräftat vilken instans och klient eneo-test använder slås värdet på för den klienten. Produktionen får samma inställning när testinloggningen nedan är gjord.

Det här behövs inte

  • auth_time, max_age och prompt=login. Eneo tvingar inte fram ny inloggning och räknar ingen ålder på MFA. Hur ofta MFA görs avgörs i OneGate.
  • Uppgifter om vilken metod som användes (BankID, Freja, app-kod, SMS). Eneo läser dem inte.
  • Extra uppgifter i biljetten stör inte. Eneo ignorerar det som den inte känner till, och sparar eller loggar det inte.

Bra att veta om formatet

Värden med fel format räknas som saknade: inloggningen fungerar, men Eneo ser den som utan MFA.

Ett undantag gäller just nu. Utvecklingsversionen av Eneo nekar i dag varje inloggning om amr är en ensam sträng, om acr inte är en sträng eller om auth_time är text. Rättningen, där sådana värden räknas som saknade, är inte byggd än. Den släppta versionen 2.3 har inte de kontrollerna. Det är skälet till att värdet ska slås på i test först.

Håll biljetten liten. Eneo nekar ett svar från token-adressen som är större än 256 kB (id-token och access-token tillsammans).

Eneo-teamet. Det här behöver ingen svara på; det går att läsa.

  • Vad som skickas i dag. Vilket acr-värde och vilka amr-värden biljetten bär vid inloggning med Authenticator respektive SMS läser vi i testinloggningen nedan.
  • Scope. Eneo begär openid email profile, och discovery-dokumentet annonserar just de tre. De står som en enda sträng, ["openid email profile"], i stället för tre.
  • Värdarna för token och nycklar. Lästa 13 november i discovery-dokumentet som eneo-test använder: token-adressen och nycklarna ligger på samma värd som utfärdaren, så inga extra värdar behöver läggas in i Eneo. Samma kontroll görs för produktionen.
  • Inget annonseras om MFA. Dokumentet saknar acr_values_supported, claims_supported och claims_parameter_supported. Det säger inte att OneGate saknar stödet, bara att det inte går att läsa där.
  • Redan sett, 9 november. OneGate återanvände inte en inloggning för Eneos klient i test. En ny begäran några minuter efter en genomförd inloggning med SMS visar valet mellan Authenticator och SMS igen.

Frågor till IdP- och IDM-gruppen

Avsnittet ”Frågor till IdP- och IDM-gruppen”

Om hur våra två instanser är inställda.

  1. Finns det inloggningar utan MFA för Eneos klient i produktion, till exempel från ett internt nät? I test har vi bara sett inloggningar med MFA.
  2. Återanvänder produktionen en inloggning mellan klienter (SSO)? I test såg vi ingen återanvändning.
  3. Vilken OneGate-instans använder eneo-test i dag, test eller produktion? Och vilken adress har utfärdaren som produktionsmiljön ska använda? Då läser vi discovery-dokumentet där själva.

Om vad OneGate kan och vad ni rekommenderar. Bakgrunden: Eneo loggar in personer med OpenID Connect och ska kunna kräva MFA för vissa arbetsutrymmen. Eneo kontrollerar inga koder eller metoder, utan läser i id-token om inloggningen gjordes med MFA.

  1. Hur sätter man ett acr-värde som betyder MFA i id-token för en klient, och vilket värde rekommenderar ni? Om acr inte går: kan amr bära ett värde som bara finns vid MFA, till exempel mfa, som en lista av strängar?
  2. Stöder OneGate att klienten begär MFA, med acr_values eller med claims och acr som “essential”? Vilket rekommenderar ni, eller är det bättre att göra MFA obligatoriskt för klienten?
  3. Om en person redan är inloggad utan MFA och klienten begär MFA: frågar OneGate då bara efter den andra faktorn?
  4. Discovery-dokumentet för vår klient anger scopes_supported som en enda sträng med tre namn (["openid email profile"]) i stället för tre strängar, och saknar acr_values_supported och claims_parameter_supported. Är det en inställning i instansen, eller så produkten fungerar? Inget av det hindrar MFA, men en lista och ett publicerat värde gör felsökning enklare.

Så kontrollerar vi att det fungerar

Avsnittet ”Så kontrollerar vi att det fungerar”

Eneo-teamet gör en testinloggning när värdet är inställt i testinstansen, utan lösenord eller token i mejl eller chatt.

  1. En testanvändare loggar in i Eneos testmiljö med MFA. Vi läser namn och värde på acr och amr i id-token, men sparar aldrig hela token.
  2. Om det går: samma användare loggar in utan MFA, och vi ser att värdet saknas.
  3. Om OneGate stöder begäran: Eneo begär MFA, OneGate frågar efter den andra faktorn, och värdet finns i den nya biljetten.

Resultatet avgör när MFA kan slås på i Eneo. Bygget i Eneo väntar inte på det.