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.
Kort sagt
Avsnittet ”Kort sagt”- 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.
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 vad
Avsnittet ”Vem gör vad”| 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å.
Det som ska gälla i OneGate
Avsnittet ”Det som ska gälla i OneGate”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.
- 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 exempelmfaenligt RFC 8176.
- Helst
- 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. - 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_valuesmed värdet, eller parameternclaimsmedacrsom “essential”. - MFA är obligatoriskt för Eneos klient i OneGate. Då behöver Eneo inte begära något.
- OneGate tar emot en begäran om MFA från Eneo och kräver då MFA. Standarden har två sätt: parametern
- 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". - Som i dag för inloggningen: id-token har
kidi huvudet och nyckeln finns i JWKS. Biljetten haremail, ochemail_verifiedärtrue(boolean) för att ett nytt konto ska kunna skapas. - 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_ageochprompt=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).
Det vi ser själva
Avsnittet ”Det vi ser själva”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 vilkaamr-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_supportedochclaims_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.
- 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.
- Återanvänder produktionen en inloggning mellan klienter (SSO)? I test såg vi ingen återanvändning.
- 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.
Frågor till MobilityGuard
Avsnittet ”Frågor till MobilityGuard”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.
- Hur sätter man ett
acr-värde som betyder MFA i id-token för en klient, och vilket värde rekommenderar ni? Omacrinte går: kanamrbära ett värde som bara finns vid MFA, till exempelmfa, som en lista av strängar? - Stöder OneGate att klienten begär MFA, med
acr_valueseller medclaimsochacrsom “essential”? Vilket rekommenderar ni, eller är det bättre att göra MFA obligatoriskt för klienten? - Om en person redan är inloggad utan MFA och klienten begär MFA: frågar OneGate då bara efter den andra faktorn?
- Discovery-dokumentet för vår klient anger
scopes_supportedsom en enda sträng med tre namn (["openid email profile"]) i stället för tre strängar, och saknaracr_values_supportedochclaims_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.
- En testanvändare loggar in i Eneos testmiljö med MFA. Vi läser namn och värde på
acrochamri id-token, men sparar aldrig hela token. - Om det går: samma användare loggar in utan MFA, och vi ser att värdet saknas.
- 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.
Hör ihop med
Avsnittet ”Hör ihop med”- Ta över arbetet: läget, ordningen och det som väntar på beslut
- MFA i Eneo
- Space och ägande i Eneo
- Vägen till produktion
- IdP-provet på GitHub (#807), i MFA-epicen #804