SAML 디코더 / 인코더
SAML 메시지
디코딩된 XML
기술적 세부 정보
SAML 디코더 작동 방식
SAML 디코더가 하는 일
SAML 디코더는 브라우저 트래픽에서 보이는 알아보기 어려운 SAMLRequest 및 SAMLResponse 값을 읽기 쉬운 XML로 바꿔 줍니다. Base64 문자열, URL 인코딩된 리디렉션 페이로드, SAMLRequest 또는 SAMLResponse가 포함된 전체 URL, 또는 일반 XML을 붙여넣으면 도구가 바인딩을 자동으로 감지합니다. 필요하면 URL 디코딩과 Base64 디코딩을 하고, HTTP-Redirect 바인딩의 경우 원시 DEFLATE 데이터를 압축 해제합니다. XML은 보기 좋게 정렬되며 요약에는 메시지 유형, ID, 발급자, 대상, 상태, NameID, 조건, 대상 그룹, 인증 컨텍스트, 속성, 서명 알고리즘, 포함된 X.509 인증서가 표시됩니다. XML을 다시 POST 또는 Redirect 형식으로 인코딩할 수도 있습니다. 모든 작업은 브라우저에서 로컬로 실행됩니다.
일반적인 사용 사례
개발자는 Okta, Azure AD, Keycloak, ADFS, Shibboleth 같은 공급자와 싱글 사인온(SSO)을 연동할 때 SAML 디코더를 사용합니다. 대표적인 작업으로는 ID 공급자가 실제로 어떤 속성과 NameID 형식을 보내는지 확인하기, Audience와 Destination이 서비스 공급자 설정과 일치하는지 확인하기, 만료된 NotOnOrAfter나 시계 오차 때문에 로그인이 실패하는 이유 찾기, 서명 및 다이제스트 알고리즘 비교하기, 서명 인증서의 만료 시점 확인하기가 있습니다. 지원 엔지니어도 브라우저 확장 프로그램을 설치하지 않고 캡처한 SAML 트레이스를 읽는 데 사용합니다.
지원되는 바인딩 및 입력
HTTP-POST 바인딩은 XML을 일반 Base64로 폼 필드에 담아 보냅니다. HTTP-Redirect 바인딩은 XML을 원시 DEFLATE(RFC 1951, zlib 헤더 없음)로 압축하고 Base64와 URL 인코딩을 거쳐 쿼리 문자열에 넣으며, 뒤에 선택적인 RelayState, SigAlg, Signature 매개변수가 붙습니다. 도구는 두 가지 모두와 URL 인코딩된 변형, 전체 URL, 이미 디코딩된 XML을 받아들입니다. AuthnRequest, Response, LogoutRequest, LogoutResponse 메시지 유형을 인식하며, ds:X509Certificate 요소의 인증서는 주체, 발급자, 유효 기간, 지문까지 디코딩합니다.
주의할 점과 제한 사항
이 도구는 XML 서명을 검증하지 않고 EncryptedAssertion 요소를 복호화할 수도 없으므로 디코딩된 메시지가 진본이라는 증거가 되지는 않습니다. Redirect 페이로드는 잘렸거나, 줄 바꿈이 사라진 채 복사되었거나, URL 인코딩이 두 번 적용된 경우 디코딩에 실패합니다. 어설션에는 개인 정보가 들어 있고 만료될 때까지 재전송될 수 있으므로, 디코딩이 로컬에서 이루어지더라도 자격 증명처럼 취급하세요. NotBefore 및 NotOnOrAfter 오류를 디버깅할 때는 타임스탬프를 UTC로 비교하고 ID 공급자와 서비스 공급자 사이의 시계 오차를 고려하세요.