2016-06-02 16:07:45 +00:00
|
|
|
|
|
|
|
|
===== SP PrincipalNameMapping element
|
|
|
|
|
|
|
|
|
|
This element is optional.
|
2016-06-02 20:50:43 +00:00
|
|
|
When creating a Java Principal object that you obtain from methods like `HttpServletRequest.getUserPrincipal()`, you can
|
|
|
|
|
define what name that is returned by the `Principal.getName()` method.
|
|
|
|
|
|
|
|
|
|
[source,xml]
|
|
|
|
|
----
|
|
|
|
|
<SP ...>
|
|
|
|
|
<PrincipalNameMapping policy="FROM_NAME_ID"/>
|
|
|
|
|
</SP>
|
|
|
|
|
|
|
|
|
|
<SP ...>
|
|
|
|
|
<PrincipalNameMapping policy="FROM_ATTRIBUTE" attribute="email" />
|
|
|
|
|
</SP>
|
|
|
|
|
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
|
2016-06-02 16:07:45 +00:00
|
|
|
The `policy` attribute defines the policy used to populate this value.
|
2016-06-02 20:50:43 +00:00
|
|
|
The possible values for this attribute are:
|
|
|
|
|
|
|
|
|
|
FROM_NAME_ID::
|
|
|
|
|
This policy just uses whatever the SAML subject value is. This is the default setting
|
|
|
|
|
FROM_ATTRIBUTE::
|
|
|
|
|
This will pull the value from one of the attributes declared in the SAML assertion received from the server.
|
|
|
|
|
You'll need to specify the name of the SAML assertion attribute to use within the `attribute` XML attribute.
|
