Felsök en misslyckad SSO-inloggning
När en inloggning via din identity provider inte fungerar är Kliv byggt för att berätta den faktiska fixen — inte bara "sign-in failed." Den här sidan visar var du ska titta och hur du läser det du hittar.
Var svaret finns
Det finns två olika vyer av en misslyckad inloggning, avsiktligt:
- Personen som loggar in ser ett enkelt meddelande om att de inte kunde loggas in, med ett kort reference ID. De ser inte de tekniska detaljerna — det skulle läcka hur din identitet är konfigurerad.
- Du, admin, ser hela diagnosen i auditloggen. Det är dit reference ID pekar.
Så när en teamkamrat rapporterar en misslyckad inloggning ber du om reference ID och slår sedan upp det.
Läs diagnosen
- Gå till User Management → Single Sign-On och öppna fliken Audit.
- Hitta den misslyckade inloggningen (matcha reference ID, eller titta bara på de senaste posterna).
- Öppna den för att se detaljerna expected-versus-received: för varje kontroll Kliv kör, vad Kliv förväntade sig och vad din provider faktiskt skickade. Skillnaden är din fix.
Du kan köra steget Test login på Single Sign-On-sidan för att reproducera ett fel på begäran medan du arbetar med det, utan att involvera riktiga användare.
Vanliga orsaker och fixar
Issuern matchar inte (OIDC). Det vanligaste OIDC-problemet. Issuer URL måste matcha din provider tecken för tecken. Microsoft Entra-issuers är specifika för din tenant; Google publicerar mer än en form. Kopiera exakt issuer från din egen provider-app och klistra in den i Kliv.
Signeringscertifikatet har gått ut (SAML). Inloggningar som fungerade i går misslyckas plötsligt. Din providers signeringscertifikat löpte ut. Ladda upp det aktuella certifikatet (eller uppdatera från din providers metadata). Statuskortet varnar dig innan detta händer — håll koll på det.
Användarens e-postdomän är inte verifierad. Kliv skapar bara konton för e-postdomäner som du har bevisat att du kontrollerar. Om en inloggning avvisas för en overifierad domän, slutför Verifiera din domän för den domänen.
Kontot är inaktiverat. Om personen inaktiverades i din identity provider eller i Kliv nekas inloggning av design — en SSO-inloggning återaktiverar aldrig tyst ett inaktiverat konto. Återaktivera dem i din provider om de ska ha åtkomst.
Identiteten (NameID) är inte stabil. Om din provider skickar en annan identifierare varje gång, eller skickar e-post i stället för ett stabilt ID, kan Kliv inte tillförlitligt känna igen samma person. Konfigurera din provider så att den skickar den stabila identifieraren som preset:en anger för den.
En e-post är inte markerad "verified." Kliv kräver inte detta — Kliv identifierar personer med en stabil provider-identifierare, inte med en e-postverifierad flagga — så en saknad "verified"-markering är inte orsaken. Titta på de andra kontrollerna i stället.
Om du fortfarande sitter fast
Detaljen expected-versus-received namnger den specifika kontrollen som misslyckades och ger provider-medveten vägledning. Arbeta med den kontrollen, fixa den i din provider och kör Test login igen. Eftersom aktivering krävde ett lyckat test är en konfiguration som fungerade tidigare och plötsligt slutade nästan alltid ett utgånget certifikat eller en ändrad inställning på din providers sida.