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 指定 authnReuqest 的生命週期,在這段期間中,將產生 authnReuqest,並從服務提供者傳送給 IdP,以索取 SAML 記號。請指定一個正整數,後面接著一個時間單位,可以是時 (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 字串   指定自訂的 URI 參照,以對應至未定義在 SAML 核心規格中的名稱 ID 格式。
disableLtpaCookie 布林 True 在處理「SAML 主張」期間,不建立「LTPA 記號」。改為建立特定「服務提供者」的 Cookie。
已啟用 布林 True 若為 true,則啟用服務提供者,若為 false,則停用。
errorPageURL 字串   指定一旦 SAML 驗證失敗,要顯示的錯誤頁面。如果未指定這個屬性,且收到的 SAML 無效,會將使用者重新導向回 SAML IdP,以重新啟動 SSO。
forceAuthn 布林 false 指出 IdP 是否應強迫使用者重新鑑別。
groupIdentifier 字串   指定一個 SAML 屬性,以作為受鑑別主體的所屬群組名稱。沒有預設值。
httpsRequired 布林 True 在存取 SAML WebSSO 服務提供者端點(例如 acs 或 meta 資料)時強制採取 SSL 通訊。
id 字串   唯一的配置 ID。
idpMetadata 字串 ${server.config.dir}/resources/security/idpMetadata.xml 指定 IdP meta 資料檔。
inboundPropagation
  • none
  • required
none 針對「Web 服務」機制的入埠傳播,控制「安全主張標記語言」Web SSO 2.0 的運作。
none
%inboundPropagation.none
required
%inboundPropagation.required
includeTokenInSubject 布林 True 指定是否在主體中包含 SAML 主張。
includeX509InSPMetadata 布林 True 指定是否在 Liberty SP meta 資料中包含 x509 憑證。
isPassive 布林 false 指出 IdP 不得控制一般使用者介面。
keyAlias 字串   用來尋找私密金鑰的金鑰別名,以用於簽署和解密。如果金鑰儲存庫單單只有一個金鑰項目,或者有一個金鑰的別名是 'samlsp',則這是選用項目。
keyStoreRef 最上層 keyStore 元素的參照(字串)。   此金鑰儲存庫含有用來簽署 AuthnRequest 和解密 EncryptedAssertion 元素的私密金鑰。預設值是伺服器的預設值。
loginPageURL 字串   指定重新導向未經鑑別的要求時的目標 SAML IdP 登入應用程式 URL。這個屬性會觸發由 IdP 起始的 SSO,且只有由 IdP 起始的 SSO,才需要指定此項。
mapToUserRegistry
  • User
  • No
  • Group
No 指定如何將身分對映至登錄使用者。選項有 No、User 和 Group。預設值為 No,且不會使用使用者登錄來建立使用者主體。
User
將 SAML 身分對映至登錄中所定義的使用者
No
不將 SAML 身分對映至登錄中的使用者或群組
Group
將 SAML 身分對映至登錄中所定義的群組
nameIDFormat
  • encrypted
  • customize
  • persistent
  • x509SubjectName
  • email
  • transient
  • entity
  • unspecified
  • kerberos
  • windowsDomainQualifiedName
email 指定 URI 參照,以對應至未定義在 SAML 核心規格中的名稱 ID 格式。
encrypted
urn:oasis:names:tc:SAML:2.0:nameid-format:encrypted
customize
自訂的名稱 ID 格式。
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 字串   指定一個 SAML 屬性,以作為網域範圍名稱。如果沒有指定任何值,會使用發證者 SAML 主張元素值。
realmName 字串   指定當 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 字串   指定 SAML 服務提供者的主機名稱和埠號。
targetPageUrl 字串   當遺漏 relayState 時,由 IdP 起始之 SSO 的預設登入頁面。
tokenReplayTimeout 具有毫秒精準度的時間量 30m 這個內容用來指定 Liberty SP 應阻止記號重播多久。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。
userIdentifier 字串   指定一個 SAML 屬性,以作為主體中的使用者主體名稱。如果沒有指定任何值,會使用 NameID SAML 主張元素值。
userUniqueIdentifier 字串   指定一個 SAML 屬性,以便在套用至主體中的 WSCredential 時,作為唯一使用者名稱。預設值與 userIdentifier 屬性值相同。
wantAssertionsSigned 布林 True 指出需要簽署這個服務提供者所收到的 <saml:Assertion> 元素。
audiences
說明:獲信任可供驗證 SAML 記號之對象的對象清單。如果值是 "ANY",就會信任所有對象。
必要:false
資料類型:字串
authFilter
說明:指定鑑別過濾器參照。
必要:false
資料類型:
authFilter > host
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
matchType
  • equals
  • contains
  • notContain
contains 指定相符類型。
equals
等於
contains
包含
notContain
不包含
name 字串   指定名稱。
authFilter > remoteAddress
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
ip 字串   指定 IP 位址。
matchType
  • lessThan
  • equals
  • greaterThan
  • contains
  • notContain
contains 指定相符類型。
lessThan
小於
equals
等於
greaterThan
大於
contains
包含
notContain
不包含
authFilter > requestUrl
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
matchType
  • equals
  • contains
  • notContain
contains 指定相符類型。
equals
等於
contains
包含
notContain
不包含
urlPattern 字串   指定 URL 型樣。
authFilter > userAgent
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
agent 字串   指定使用者代理程式
id 字串   唯一的配置 ID。
matchType
  • equals
  • contains
  • notContain
contains 指定相符類型。
equals
等於
contains
包含
notContain
不包含
authFilter > webApp
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
matchType
  • equals
  • contains
  • notContain
contains 指定相符類型。
equals
等於
contains
包含
notContain
不包含
name 字串   指定名稱。
authnContextClassRef
說明:用來識別說明鑑別環境定義宣告之鑑別環境定義類別的 URI 參照。預設值為 null。
必要:false
資料類型:字串
headerName
說明:儲存 SAML 記號之 HTTP 要求的標頭名稱。
必要:false
資料類型:字串
pkixTrustEngine
說明:指定 PKIX 信任資訊,以用來評估 SAML 回應中之 XML 簽章的可信度和有效性。請勿在一個 samlWebSso20 中指定多個 pkixTrustEngine。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
trustAnchorRef 最上層 keyStore 元素的參照(字串)。   含有用來驗證 SAMLResponse 和 Assertion 簽章之必要公開金鑰的金鑰儲存庫。
pkixTrustEngine > crl
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
path 字串   指定 CRL 的路徑。
pkixTrustEngine > trustedIssuers
說明:指定授信 IdP 發證者的身分。如果值是 "ALL_ISSUERS",表示信任所有 IdP 身分。
必要:false
資料類型:字串
pkixTrustEngine > x509Certificate
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
path 字串   指定 x509 憑證的路徑。

指示主題類型的圖示 參照主題



「時間戳記」圖示 前次更新: 2016 年 6 月 3 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_config_samlWebSso20
檔名:rwlp_config_samlWebSso20.html