Class SokletSaml
java.lang.Object
com.revetsec.soklet.SokletSaml
Thin SAML transport helpers for application-routed Soklet endpoints. Core performs all SAML
parsing, signature, pending, audience and replay decisions. The application owns cookies,
IdP selection, local sessions and response policy.
- Since:
- 1.0.0
-
Method Summary
Modifier and TypeMethodDescriptionauthenticationRedirect(@NonNull SamlAuthenticationRequestResult.Prepared prepared, @NonNull Set<@NonNull ResponseCookie> cookies) Sends a core-prepared authentication Redirect with no-store and no-referrer headers.static @NonNull MarshaledResponselogoutPostFormResponse(@NonNull SamlLogoutPostResult.Prepared prepared, @Nullable String cspNonce) Sends a core-prepared SP logout POST form.logoutRedirect(@NonNull SamlLogoutRedirectResult.Prepared prepared, @NonNull Set<@NonNull ResponseCookie> cookies) Sends a core-prepared SP logout Redirect.static @NonNull MarshaledResponselogoutResponsePostFormResponse(@NonNull SamlLogoutResponsePostResult.Prepared prepared, @Nullable String cspNonce) Sends a core-prepared POST answer to an IdP logout request.logoutResponseRedirect(@NonNull SamlLogoutResponseRedirectResult.Prepared prepared, @NonNull Set<@NonNull ResponseCookie> cookies) Sends a core-prepared answer to an IdP logout request.postBindingResultFor(@NonNull Request request) Parses a raw ACS POST body and every materialized Content-Type value, preserving duplicates.static @NonNull MarshaledResponsepostFormResponse(@NonNull SamlPostForm form, @Nullable String cspNonce) Sends a core-prepared POST form with no-store headers.postLogoutBindingResultFor(@NonNull Request request) Parses an original logout POST body and every Content-Type value, preserving duplicates.redirectBindingResultFor(@NonNull Request request) Parses the untouched query string for HTTP-Redirect logout signature verification.
-
Method Details
-
postBindingResultFor
@CheckReturnValue public static @NonNull SokletRequestResult<@NonNull SamlPostBindingParseResult> postBindingResultFor(@NonNull Request request) Parses a raw ACS POST body and every materialized Content-Type value, preserving duplicates.- Parameters:
request- application-routed ACS request- Returns:
- an oversized transport outcome or core's untrusted POST-binding parse result
- Throws:
IllegalArgumentException- if the application route is not POST- Since:
- 1.0.0
-
postLogoutBindingResultFor
@CheckReturnValue public static @NonNull SokletRequestResult<@NonNull SamlPostBindingParseResult> postLogoutBindingResultFor(@NonNull Request request) Parses an original logout POST body and every Content-Type value, preserving duplicates. The application supplies its browser-bound pending state to core when completing SP logout; a pending cookie for a cross-site POST requires Secure, HttpOnly and SameSite=None.- Parameters:
request- application-routed logout POST request- Returns:
- an oversized transport outcome or core's untrusted logout POST-binding parse result
- Throws:
IllegalArgumentException- if the application route is not POST- Since:
- 1.0.0
-
redirectBindingResultFor
@CheckReturnValue public static @NonNull SamlRedirectBindingParseResult redirectBindingResultFor(@NonNull Request request) Parses the untouched query string for HTTP-Redirect logout signature verification.- Parameters:
request- application-routed logout GET request- Returns:
- an oversized transport outcome or core's untrusted Redirect-binding parse result
- Since:
- 1.0.0
-
authenticationRedirect
@CheckReturnValue public static @NonNull Response authenticationRedirect(@NonNull SamlAuthenticationRequestResult.Prepared prepared, @NonNull Set<@NonNull ResponseCookie> cookies) Sends a core-prepared authentication Redirect with no-store and no-referrer headers.- Parameters:
prepared- core-prepared authentication requestcookies- application-selected response cookies- Returns:
- Soklet redirect response
- Since:
- 1.0.0
-
logoutRedirect
@CheckReturnValue public static @NonNull Response logoutRedirect(@NonNull SamlLogoutRedirectResult.Prepared prepared, @NonNull Set<@NonNull ResponseCookie> cookies) Sends a core-prepared SP logout Redirect.- Parameters:
prepared- core-prepared logout requestcookies- application-selected response cookies- Returns:
- Soklet redirect response
- Since:
- 1.0.0
-
logoutResponseRedirect
@CheckReturnValue public static @NonNull Response logoutResponseRedirect(@NonNull SamlLogoutResponseRedirectResult.Prepared prepared, @NonNull Set<@NonNull ResponseCookie> cookies) Sends a core-prepared answer to an IdP logout request.- Parameters:
prepared- core-prepared logout responsecookies- application-selected response cookies- Returns:
- Soklet redirect response
- Since:
- 1.0.0
-
logoutPostFormResponse
@CheckReturnValue public static @NonNull MarshaledResponse logoutPostFormResponse(@NonNull SamlLogoutPostResult.Prepared prepared, @Nullable String cspNonce) Sends a core-prepared SP logout POST form. Set the browser-bound pending cookie and CSP before delivery; a cross-site POST pending cookie requires Secure, HttpOnly and SameSite=None.- Parameters:
prepared- core-prepared logout requestcspNonce- application-generated nonce, or null for manual submission- Returns:
- exact UTF-8 HTML response
- Since:
- 1.0.0
-
logoutResponsePostFormResponse
@CheckReturnValue public static @NonNull MarshaledResponse logoutResponsePostFormResponse(@NonNull SamlLogoutResponsePostResult.Prepared prepared, @Nullable String cspNonce) Sends a core-prepared POST answer to an IdP logout request. The application sets its CSP.- Parameters:
prepared- core-prepared logout responsecspNonce- application-generated nonce, or null for manual submission- Returns:
- exact UTF-8 HTML response
- Since:
- 1.0.0
-
postFormResponse
@CheckReturnValue public static @NonNull MarshaledResponse postFormResponse(@NonNull SamlPostForm form, @Nullable String cspNonce) Sends a core-prepared POST form with no-store headers. The application sets a CSP header appropriate to its page and chooses the pending cookie before calling this helper.- Parameters:
form- core-prepared SAML authentication or logout formcspNonce- application-generated nonce, or null for manual submission- Returns:
- exact UTF-8 HTML response
- Since:
- 1.0.0
-