رمزگشا / رمزگذار SAML
پیام SAML
XML رمزگشاییشده
جزئیات فنی
رمزگشای SAML چگونه کار میکند
رمزگشای SAML چه کاری انجام میدهد
رمزگشای SAML مقادیر مبهم SAMLRequest و SAMLResponse را که در ترافیک مرورگر میبینید به XML خوانا تبدیل میکند. یک رشته Base64، یک payload ریدایرکت با رمزگذاری URL، یک URL کامل حاوی SAMLRequest یا SAMLResponse، یا XML ساده را جایگذاری کنید و ابزار اتصال را خودکار تشخیص میدهد: در صورت نیاز URL را رمزگشایی میکند، Base64 را رمزگشایی میکند و دادههای خام DEFLATE را برای اتصال HTTP-Redirect از حالت فشرده خارج میکند. XML مرتبسازی میشود و خلاصه نوع پیام، ID، صادرکننده، مقصد، وضعیت، NameID، شرایط، مخاطبان، بافت احراز هویت، ویژگیها، الگوریتمهای امضا و گواهیهای X.509 جاسازیشده را فهرست میکند. همچنین میتواند XML را دوباره به شکل POST یا Redirect رمزگذاری کند. همهچیز بهصورت محلی در مرورگر شما اجرا میشود.
کاربردهای رایج
توسعهدهندگان هنگام یکپارچهسازی ورود یکپارچه (SSO) با ارائهدهندگانی مانند Okta، Azure AD، Keycloak، ADFS یا Shibboleth از رمزگشای SAML استفاده میکنند. کارهای معمول شامل بررسی این است که ارائهدهنده هویت واقعاً چه ویژگیهایی و چه قالب NameID میفرستد، تأیید تطابق Audience و Destination با پیکربندی ارائهدهنده خدمت شما، یافتن علت شکست ورود بهدلیل NotOnOrAfter منقضیشده یا اختلاف ساعت، مقایسه الگوریتمهای امضا و digest، و بررسی زمان انقضای گواهی امضا است. مهندسان پشتیبانی نیز از آن برای خواندن یک ردیابی SAML ضبطشده بدون نصب افزونه مرورگر استفاده میکنند.
اتصالها و ورودیهای پشتیبانیشده
اتصال HTTP-POST، XML را بهصورت Base64 ساده در یک فیلد فرم میفرستد. اتصال HTTP-Redirect، XML را با DEFLATE خام (RFC 1951، بدون سرایند zlib) فشرده میکند، با Base64 رمزگذاری میکند و سپس آن را در رشته کوئری، در کنار پارامترهای اختیاری RelayState، SigAlg و Signature، با URL رمزگذاری میکند. این ابزار هر دو، نسخههای رمزگذاریشده با URL از هرکدام، URLهای کامل و XML از قبل رمزگشاییشده را میپذیرد. انواع پیام AuthnRequest، Response، LogoutRequest و LogoutResponse شناسایی میشوند و گواهیهای درون عناصر ds:X509Certificate همراه با موضوع، صادرکننده، اعتبار و اثرانگشت رمزگشایی میشوند.
نکات احتیاطی و محدودیتها
این ابزار امضاهای XML را تأیید نمیکند و نمیتواند عناصر EncryptedAssertion را رمزگشایی کند، بنابراین پیام رمزگشاییشده دلیلی بر اصالت آن نیست. payloadهای Redirect در صورت ناقص بودن، کپی شدن با از دست رفتن شکستگی خط یا رمزگذاری دوباره با URL رمزگشایی نمیشوند. assertionها ممکن است دادههای شخصی داشته باشند و تا زمان انقضا قابل بازپخش باشند، پس با آنها مانند اعتبارنامه رفتار کنید، حتی اگر رمزگشایی بهصورت محلی انجام شود. مهرهای زمانی را در UTC مقایسه کنید و هنگام اشکالزدایی خطاهای NotBefore و NotOnOrAfter اختلاف ساعت بین ارائهدهنده هویت و ارائهدهنده خدمت را در نظر بگیرید.