Vad är ett SAML-meddelande?

SAML (Security Assertion Markup Language) 2.0 används i många lösningar för enkel inloggning (SSO). När du loggar in i en app via företagets identitetsleverantör, till exempel Okta, Microsoft Entra ID, Google Workspace eller Keycloak, skickar appen en begäran (en AuthnRequest) till identitetsleverantören, som sedan skickar tillbaka ett svar som anger vem du är (ett Response med en Assertion). Båda är XML-dokument, men de skickas i kodad form och ser därför ut som långa block med slumpmässiga bokstäver i nätverksloggen i webbläsaren.

Så avkodar du ett meddelande

Klistra in meddelandet i den form du troligen har det:

  • Värdet i ett SAMLRequest- eller SAMLResponse-fält, kopierat från nätverksfliken i webbläsarens utvecklarverktyg eller från ett SAML tracer-tillägg.
  • En hel URL eller en formulärkropp som SAMLResponse=…&RelayState=…, som innehåller ett sådant fält. RelayState och, vid en signerad omdirigering, signaturalgoritmen visas också.
  • Själva XML-dokumentet, om du vill läsa dess fält.

Avkodaren identifierar själv hur meddelandet är kodat:

  • HTTP-POST-bindningen skickar XML-dokumentet Base64-kodat i ett dolt formulärfält.
  • HTTP-Redirect-bindningen komprimerar XML-dokumentet med DEFLATE, Base64-kodar det och URL-kodar sedan resultatet så att det får plats i en länk. Avkodaren utför alla tre stegen i omvänd ordning.

Radbrytningar, URL-säker Base64 och plustecken som omvandlats till mellanslag vid formuläravkodning hanteras också.

Det här visas

  • Bindning och parameter: hur meddelandet kodades och om det är en begäran eller ett svar.
  • Meddelande: fälten som man oftast kontrollerar när man konfigurerar eller felsöker SSO. De omfattar utfärdaren (vem som skickade meddelandet), destinationen, statusen (Success eller ett fel, till exempel Responder / AuthnFailed), namn-ID:t (vem som loggade in) och dess format, målgruppen (vilken app Assertion gäller) och giltighetsperioden (Inte före och Inte på eller efter). De omfattar också autentiseringskontexten, sessionsindexet och om meddelandet, Assertion eller URL:en vid HTTP-Redirect-bindning har en signatur.
  • Attribut: användarattributen som identitetsleverantören har skickat, till exempel e-postadress, namn och grupper, med samtliga värden för varje attribut.
  • Avkodat XML: hela meddelandet, indraget och klart att kopiera eller ladda ner.

Bra att veta

  • Avkodaren visar om det finns en signatur, men verifierar den inte. Det kräver identitetsleverantörens certifikat och är tjänsteleverantörens ansvar.
  • En krypterad Assertion (EncryptedAssertion) kan bara läsas med tjänsteleverantörens privata nyckel. Avkodaren visar därför att den finns, men kan inte visa dess innehåll.
  • Tider i SAML-meddelanden anges i UTC. En vanlig orsak till misslyckade inloggningar är en tidsskillnad mellan servrarna. Då visas en Inte före-tidpunkt i framtiden eller en Inte på eller efter-tidpunkt som redan har passerat.
  • Allt sker i webbläsaren. Ingenting du klistrar in skickas någonstans, vilket är viktigt eftersom ett SAML-svar kan innehålla personuppgifter.

Funktioner

  • Avkodar meddelanden med HTTP-Redirect (DEFLATE) och HTTP-POST (Base64)
  • Accepterar värden, hela URL:er, formulärkroppar och vanlig XML
  • Visar utfärdare, status, subjekt, villkor och autentiseringsuppgifter
  • Visar alla attribut och deras värden
  • Indraget XML som du kan kopiera eller ladda ner
  • Körs i webbläsaren