Dekodirnik / kodirnik SAML
Sporočilo SAML
Dekodirani XML
Tehnične podrobnosti
Kako deluje dekodirnik SAML
Kaj počne dekodirnik SAML
Dekodirnik SAML pretvori neprozorne vrednosti SAMLRequest in SAMLResponse, ki jih vidite v brskalniškem prometu, v berljiv XML. Prilepite niz Base64, URL-kodiran naboj Redirect, celoten URL, ki vsebuje SAMLRequest ali SAMLResponse, ali navaden XML, orodje pa samodejno zazna vezavo: po potrebi dekodira URL, dekodira Base64 in razširi surove podatke DEFLATE za vezavo HTTP-Redirect. XML je lepo oblikovan, povzetek pa našteva vrsto sporočila, ID, izdajatelja, cilj, stanje, NameID, pogoje, občinstva, kontekst overitve, atribute, podpisne algoritme in vdelane certifikate X.509. XML lahko tudi kodira nazaj v obliko POST ali Redirect. Vse teče lokalno v vašem brskalniku.
Pogosti primeri uporabe
Razvijalci uporabljajo dekodirnik SAML pri integraciji enotne prijave z ponudniki, kot so Okta, Azure AD, Keycloak, ADFS ali Shibboleth. Tipične naloge so preverjanje, katere atribute in format NameID ponudnik identitete dejansko pošilja, potrjevanje, da se Audience in Destination ujemata z nastavitvami vašega ponudnika storitev, ugotavljanje, zakaj prijava ne uspe zaradi potekle vrednosti NotOnOrAfter ali zamika ure, primerjava podpisnih algoritmov in algoritmov povzetka ter preverjanje, kdaj poteče podpisni certifikat. Podporni inženirji ga uporabljajo tudi za branje zajetega sledenja SAML brez nameščanja razširitve brskalnika.
Podprte vezave in vnosi
Vezava HTTP-POST pošlje XML kot navaden Base64 v polju obrazca. Vezava HTTP-Redirect stisne XML s surovim DEFLATE (RFC 1951, brez glave zlib), ga kodira z Base64 in nato z URL v poizvedbeni niz, ob izbirnih parametrih RelayState, SigAlg in Signature. To orodje sprejema oboje, URL-kodirane različice obeh, celotne URL-je in že dekodiran XML. Prepoznana so sporočila AuthnRequest, Response, LogoutRequest in LogoutResponse, certifikati v elementih ds:X509Certificate pa so dekodirani s subjektom, izdajateljem, veljavnostjo in prstnim odtisom.
Pasti in omejitve
Orodje ne preverja podpisov XML in ne more dešifrirati elementov EncryptedAssertion, zato dekodirano sporočilo ni dokaz, da je pristno. Naboji Redirect se ne dekodirajo, če so okrnjeni, kopirani brez prelomov vrstic ali dvakrat URL-kodirani. Trditve lahko vsebujejo osebne podatke in jih je morda mogoče ponovno uporabiti, dokler ne potečejo, zato jih obravnavajte kot poverilnice, čeprav dekodiranje poteka lokalno. Časovne žige primerjajte v UTC in upoštevajte zamik ure med ponudnikom identitete in ponudnikom storitev, ko odpravljate napake NotBefore in NotOnOrAfter.