The primary channel for communication of user information between the SP software and the web applications running behind it is the use of CGI request headers or environment variables. Some applications have advanced requirements for which access to actual SAML assertions can be useful. For these cases, the SP is able to provide the assertions it receives, but cannot do so in the same way due to size. Instead, a simple query mechanism is used.
Some security checks are still performed by the SP, but no value filtering or other policies are applied.
When instructed to do so for a request (via the exportAssertion
content setting), the application will be given a header or variable called Shib-Assertion-Count
with the number of assertions that are available.
The URL to query for each assertion is passed in an individual header or variable named Shib-Assertion-NN
, where NN
is the two-digit sequence number of the assertion(01
, 02
, etc). Performing a GET on that location will result in the assertion, with a MIME type of "application/samlassertion+xml".