SAML Web SSO 2.0 认证 (samlWebSso20)

控制安全性断言标记语言 Web SSO 2.0 机制的操作。

属性名称 数据类型 缺省值 描述
allowCreate 布尔型   允许 IdP 在请求用户不具有帐户的情况下创建新帐户。
allowCustomCacheKey 布尔型 true 允许生成定制高速缓存密钥以访问认证高速缓存和获取主体集。
authFilterRef 对顶级 authFilter 元素的引用(字符串)。   指定认证过滤器引用。
authnContextComparisonType
  • minimum
  • better
  • maximum
  • exact
exact 如果指定了 authnContextClassRef,那么可设置 authnContextComparisonType。
minimum
最小值。认证语句中的认证上下文必须至少达到所指定认证上下文的其中一项的强度。
better
更强。认证语句中的认证上下文必须比所指定认证上下文中的任何一项更强。
maximum
最大值。认证语句中的认证上下文必须尽可能强,但不超过所指定认证上下文的至少其中一项的强度。
exact
完全匹配。认证语句中的认证上下文必须与所指定认证上下文中的至少一项的强度完全匹配。
authnRequestTime 具有毫秒精度的时间段 10m 指定从服务提供者生成并发送到 IdP 以请求 SAML 令牌的 authnReuqest 的生存时间段。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
authnRequestsSigned 布尔型 true 指示是否签署此服务提供者发送的 <samlp:AuthnRequest> 消息。
clockSkew 具有毫秒精度的时间段 5m 此属性用来指定验证 SAML 令牌时允许的时钟偏差(分钟)。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
createSession 布尔型 true 指定当前 HttpSession 不存在时是否创建 HttpSession。
customizeNameIDFormat string   指定与 SAML 核心规范中未定义的名称标识格式对应的定制 URI 引用。
disableLtpaCookie 布尔型 true 处理 SAML 断言期间不创建 LTPA 令牌。改为创建特定服务提供者的 cookie。
enabled 布尔型 true 如果为 true,那么启用服务提供者;如果为 false,那么禁用服务提供者。
errorPageURL string   指定在 SAML 验证失败的情况下将显示的错误页面。如果未指定此属性,那么所接收 SAML 无效,用户将重定向回 SAML IdP 以重新启动 SSO。
forceAuthn 布尔型 False 指示 IdP 是否应强制该用户重新认证。
groupIdentifier string   指定 SAML 属性,该属性将用作已认证主体所属的组的名称。没有缺省值。
httpsRequired 布尔型 true 访问 SAML WebSSO 服务提供者端点(例如,acs 或元数据)时强制使用 SSL 通信。
id string   唯一配置标识。
idpMetadata string ${server.config.dir}/resources/security/idpMetadata.xml 指定 IdP 元数据文件。
inboundPropagation
  • 无
  • required
无 控制 Web Service 入站传播机制中安全性断言标记语言 Web SSO 2.0 的操作。
无
%inboundPropagation.none
required
%inboundPropagation.required
includeTokenInSubject 布尔型 true 指定是否在主体集中包含 SAML 断言。
includeX509InSPMetadata 布尔型 true 指定是否要在 Liberty SP 元数据中包含 x509 证书。
isPassive 布尔型 False 指示 IdP 不得控制最终用户界面。
keyAlias string   用于查找签名和解密所需的专用密钥的密钥别名。如果密钥库正好具有一个密钥条目或如果具有一个别名为“samlsp”的密钥,那么这为可选。
keyStoreRef 对顶级 keyStore 元素的引用(字符串)。   密钥库,它包含用于签署 AuthnRequest 和解密 EncryptedAssertion 元素的专用密钥。缺省值为服务器的缺省密钥库。
loginPageURL string   指定未认证请求重定向至的 SAML IdP 登录应用程序 URL。此属性触发 IdP 发起的 SSO,仅 IdP 发起的 SSO 需要此属性。
mapToUserRegistry
  • User
  • No
  • 组
No 指定如何将身份映射至注册表用户。选项为 No、User 和 Group。缺省值为 No,不会使用用户注册表来创建用户主体集。
User
将 SAML 身份映射至注册表中定义的用户
No
不会将 SAML 身份映射至注册表中的用户或组
组
将 SAML 身份映射至用户注册表中定义的组
nameIDFormat
  • encrypted
  • customize
  • persistent
  • x509SubjectName
  • email
  • transient
  • entity
  • unspecified
  • kerberos
  • windowsDomainQualifiedName
email 指定与 SAML 核心规范中定义的名称标识格式对应的 URI 引用。
encrypted
urn:oasis:names:tc:SAML:2.0:nameid-format:encrypted
customize
已定制名称标识格式。
persistent
urn:oasis:names:tc:SAML:2.0:nameid-format:persistent
x509SubjectName
urn:oasis:names:tc:SAML:1.1:nameid-format:X509SubjectName
email
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
transient
urn:oasis:names:tc:SAML:2.0:nameid-format:transient
entity
urn:oasis:names:tc:SAML:2.0:nameid-format:entity
unspecified
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
kerberos
urn:oasis:names:tc:SAML:2.0:nameid-format:kerberos
windowsDomainQualifiedName
urn:oasis:names:tc:SAML:1.1:nameid-format:WindowsDomainQualifiedName
reAuthnCushion 具有毫秒精度的时间段 0m SAML 断言将到期时再次认证的时间段,通过 SAML 断言的 NotOnOrAfter 语句或 SessionNotOnOrAfter 属性指示。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
reAuthnOnAssertionExpire 布尔型 False SAML 断言将到期时再次认证传入的 HTTP 请求。
realmIdentifier string   指定将用作领域名的 SAML 属性。如果未指定值,那么会使用签发者 SAML 断言元素值。
realmName string   mapToUserRegistry 设置为 No 或 Group 时,指定领域名。
sessionNotOnOrAfter 具有毫秒精度的时间段 120m 指示 SAML 会话持续时间的上限,之后 Liberty SP 应要求用户向 IdP 重新认证。如果从 IdP 返回的 SAML 令牌未包含 sessionNotOnOrAfter 断言,那么将使用此属性指定的值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
signatureMethodAlgorithm
  • SHA256
  • SHA128
  • SHA1
SHA256 指示此服务提供者所需的算法。
SHA256
SHA-256 签名算法
SHA128
%signatureMethodAlgorithm.SHA128
SHA1
SHA-1 签名算法
spHostAndPort string   指定 SAML 服务提供者主机名和端口号。
targetPageUrl string   缺少 relayState 时 IdP 发起的 SSO 的缺省登录页面。
tokenReplayTimeout 具有毫秒精度的时间段 30m 此属性用于指定 Liberty SP 应阻止令牌重放的时间长度。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
userIdentifier string   指定将用作主体集中的用户主体名称的 SAML 属性。如果未指定值,那么会使用名称标识 SAML 断言元素值。
userUniqueIdentifier string   指定 SAML 属性,此属性将在应用于主体集中的 WSCredential 时用作唯一用户名。缺省值与 userIdentifier 属性值相同。
wantAssertionsSigned 布尔型 true 指示签署此服务提供者接收的 <saml:Assertion> 元素的要求。
audiences
描述:可以信任以便验证 SAML 令牌受众的受众的列表。如果值为“ANY”,那么将信任所有受众。
必需:False
数据类型:string
authFilter
描述:指定认证过滤器引用。
必需:False
数据类型:
authFilter > host
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
id string   唯一配置标识。
matchType
  • equals
  • contains
  • notContain
contains 指定匹配类型。
equals
等于
contains
包含
notContain
不包含
名称 string   指定名称。
authFilter > remoteAddress
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
id string   唯一配置标识。
ip string   指定 IP 地址。
matchType
  • lessThan
  • equals
  • greaterThan
  • contains
  • notContain
contains 指定匹配类型。
lessThan
小于
equals
等于
greaterThan
大于
contains
包含
notContain
不包含
authFilter > requestUrl
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
id string   唯一配置标识。
matchType
  • equals
  • contains
  • notContain
contains 指定匹配类型。
equals
等于
contains
包含
notContain
不包含
urlPattern string   指定 URL 模式。
authFilter > userAgent
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
agent string   指定用户代理
id string   唯一配置标识。
matchType
  • equals
  • contains
  • notContain
contains 指定匹配类型。
equals
等于
contains
包含
notContain
不包含
authFilter > webApp
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
id string   唯一配置标识。
matchType
  • equals
  • contains
  • notContain
contains 指定匹配类型。
equals
等于
contains
包含
notContain
不包含
名称 string   指定名称。
authnContextClassRef
描述:标识描述了认证上下文声明的认证上下文类的 URI 引用。缺省值为空。
必需:False
数据类型:string
headerName
描述:存储 SAML 令牌的 HTTP 请求的头名称。
必需:False
数据类型:string
pkixTrustEngine
描述:指定用于评估 SAML 响应中 XML 签名的可信度和有效性的 PKIX 信任信息。请勿在 samlWebSso20 中指定多个 pkixTrustEngine。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
trustAnchorRef 对顶级 keyStore 元素的引用(字符串)。   密钥库,包含在验证 SAMLResponse 和断言的签名时必需的公用密钥。
pkixTrustEngine > crl
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
id string   唯一配置标识。
path string   指定 CRL 的路径。
pkixTrustEngine > trustedIssuers
描述:指定受信任 IdP 签发者的身份。如果值为“ALL_ISSUERS”,那么将信任所有 IdP 身份。
必需:False
数据类型:string
pkixTrustEngine > x509Certificate
描述:唯一配置标识。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
id string   唯一配置标识。
path string   指定 x509 证书的路径。

用于指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_config_samlWebSso20
文件名:rwlp_config_samlWebSso20.html