Wat is een SAML-bericht?

SAML (Security Assertion Markup Language) 2.0 is de basis voor veel configuraties voor single sign-on (SSO). Wanneer je je aanmeldt bij een app via de identiteitsprovider van je bedrijf, zoals Okta, Microsoft Entra ID, Google Workspace of Keycloak, stuurt de app een verzoek (een AuthnRequest) naar de identiteitsprovider. Die stuurt vervolgens een antwoord terug waarin staat wie je bent (een Response met een Assertion). Beide zijn XML-documenten, maar ze worden gecodeerd verzonden. Daarom zien ze eruit als lange blokken willekeurige letters in het netwerklogboek van je browser.

Hoe je een bericht decodeert

Plak het bericht in een van de vormen waarin je het waarschijnlijk hebt:

  • De waarde van een SAMLRequest- of SAMLResponse-veld, gekopieerd uit het netwerktabblad van de ontwikkelaarstools van je browser of uit een SAML-tracerextensie.
  • Een volledige URL of een formulierbody zoals SAMLResponse=…&RelayState=…, met zo'n veld. Ook RelayState en, bij een ondertekende redirect, het handtekeningalgoritme worden weergegeven.
  • De XML zelf, om de velden ervan te bekijken.

De decoder herkent zelf hoe het bericht is gecodeerd:

  • De HTTP-POST-binding verstuurt de XML, gecodeerd met Base64, in een verborgen formulierveld.
  • De HTTP-Redirect-binding comprimeert de XML met DEFLATE, codeert die met Base64 en codeert het resultaat vervolgens voor gebruik in een URL, zodat het in een link past. De decoder maakt deze drie bewerkingen ongedaan.

Regelafbrekingen, URL-veilige Base64 en plustekens die door formulierdecodering in spaties zijn veranderd, worden allemaal verwerkt.

Wat je te zien krijgt

  • Binding en parameter: hoe het bericht is gecodeerd en of het een verzoek of een antwoord is.
  • Bericht: de velden die mensen meestal controleren bij het instellen of debuggen van SSO. Hieronder vallen de issuer (wie het heeft verzonden), de bestemming, de status (Success of een fout zoals Responder / AuthnFailed), de NameID (wie zich heeft aangemeld) en de indeling ervan, de audience (voor welke app de assertion bedoeld is) en de geldigheidsperiode (Not before en Not on or after). Ook worden de authenticatiecontext, de sessie-index en de aanwezigheid van een handtekening weergegeven: bij het bericht, de assertion of, voor de HTTP-Redirect-binding, de URL.
  • Attributen: de gebruikersattributen die de identiteitsprovider heeft vrijgegeven, zoals e-mailadres, naam en groepen, met alle waarden van elk attribuut.
  • Gedecodeerde XML: het volledige bericht, met inspringing en klaar om te kopiëren of te downloaden.

Goed om te weten

  • De decoder geeft aan of er een handtekening aanwezig is, maar verifieert die niet. Daarvoor is het certificaat van de identiteitsprovider nodig; verificatie is de verantwoordelijkheid van de serviceprovider.
  • Een versleutelde assertion (EncryptedAssertion) kan alleen worden gelezen met de privésleutel van de serviceprovider. De decoder geeft dus aan dat die aanwezig is, maar kan de inhoud niet weergeven.
  • Tijden in SAML-berichten zijn in UTC. Een veelvoorkomende oorzaak van mislukte aanmeldingen is een tijdsverschil tussen de servers. Dat blijkt uit een Not before-tijdstip in de toekomst of een Not on or after-tijdstip dat al verstreken is.
  • Alles gebeurt in je browser. Niets wat je plakt, wordt ergens naartoe verzonden. Dat is belangrijk, omdat een SAML-antwoord persoonlijke gegevens kan bevatten.

Functies

  • Decodeert HTTP-Redirect- (met DEFLATE gecomprimeerde) en HTTP-POST-berichten (Base64)
  • Accepteert waarden, volledige URL's, formulierbody's en gewone XML
  • Toont de issuer, status, subject, voorwaarden en authenticatiegegevens
  • Toont alle attributen en hun waarden
  • XML met inspringing, klaar om te kopiëren of te downloaden
  • Werkt in je browser