SAML-dekooderi / -koodaaja
SAML-viesti
Dekoodattu XML
Tekniset tiedot
Näin SAML-dekooderi toimii
Mitä SAML-dekooderi tekee
SAML-dekooderi muuttaa selainliikenteessä näkyvät läpinäkymättömät SAMLRequest- ja SAMLResponse-arvot luettavaksi XML:ksi. Liitä Base64-merkkijono, URL-koodattu redirect-sisältö, koko URL, jossa on SAMLRequest tai SAMLResponse, tai pelkkä XML, ja työkalu tunnistaa sidonnan automaattisesti: se tarvittaessa URL-dekoodaa, Base64-dekoodaa ja purkaa raakan DEFLATE-datan HTTP-Redirect-sidontaa varten. XML muotoillaan luettavaksi, ja yhteenvedossa näkyvät viestin tyyppi, ID, myöntäjä, kohde, tila, NameID, ehdot, kohdeyleisöt, todennuskonteksti, attribuutit, allekirjoitusalgoritmit ja upotetut X.509-varmenteet. Voit myös koodata XML:n takaisin POST- tai Redirect-muotoon. Kaikki toimii paikallisesti selaimessasi.
Yleisiä käyttötapauksia
Kehittäjät käyttävät SAML-dekooderia yhdistäessään kertakirjautumista (SSO) esimerkiksi Oktan, Azure AD:n, Keycloakin, ADFS:n tai Shibbolethin kanssa. Tyypillisiä tehtäviä ovat sen tarkistaminen, mitä attribuutteja ja NameID-muotoa identiteetintarjoaja todella lähettää, Audiencen ja Destinationin vastaaminen palveluntarjoajan asetuksia, syyn selvittäminen kirjautumisen epäonnistumiselle vanhentuneen NotOnOrAfter-arvon tai kellonaikapoikkeaman vuoksi, allekirjoitus- ja tiivistealgoritmien vertailu sekä allekirjoitusvarmenteen voimassaolon tarkistus. Tukihenkilöt käyttävät sitä myös tallennetun SAML-jäljen lukemiseen ilman selainlaajennuksen asentamista.
Tuetut sidonnat ja syötteet
HTTP-POST-sidonta lähettää XML:n pelkkänä Base64:nä lomakekentässä. HTTP-Redirect-sidonta pakkaa XML:n raa'alla DEFLATE-menetelmällä (RFC 1951, ei zlib-otsaketta), Base64-koodaa sen ja URL-koodaa kyselymerkkijonoon, jota seuraavat valinnaiset RelayState-, SigAlg- ja Signature-parametrit. Työkalu hyväksyy molemmat, myös URL-koodatut variantit, kokonaiset URL-osoitteet ja jo dekoodatun XML:n. Viestityypit AuthnRequest, Response, LogoutRequest ja LogoutResponse tunnistetaan, ja ds:X509Certificate-elementeissä olevat varmenteet dekoodataan haltijan, myöntäjän, voimassaolon ja sormenjäljen osalta.
Sudenkuopat ja rajoitukset
Työkalu ei tarkista XML-allekirjoituksia eikä voi purkaa EncryptedAssertion-elementtejä, joten dekoodattu viesti ei ole todiste aitoudesta. Redirect-sisältö ei dekoodaudu, jos se on katkennut, kopioitu rivinvaihdot kadottaen tai URL-koodattu kahdesti. Assertionit sisältävät henkilötietoja ja saattavat olla toistettavissa vanhenemiseensa asti, joten käsittele niitä kuin tunnuksia, vaikka dekoodaus tapahtuu paikallisesti. Vertaa aikaleimoja UTC-ajassa ja ota huomioon identiteetintarjoajan ja palveluntarjoajan välinen kellopoikkeama, kun selvität NotBefore- ja NotOnOrAfter-virheitä.