SAML Web SSO 2.0 鑑別 (samlWebSso20)
控制「安全主張標記語言 Web SSO 2.0」機制的運作。
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| allowCreate | 布林 | 如果發出要求的使用者沒有新帳戶,則容許 IdP 建立一個。 | |
| allowCustomCacheKey | 布林 | True | 容許產生自訂快取索引鍵,以存取鑑別快取並取得主體。 |
| authFilterRef | 最上層 authFilter 元素的參照(字串)。 | 指定鑑別過濾器參照。 | |
| authnContextComparisonType |
|
exact | 當指定 authnContextClassRef 時,可以設定 authnContextComparisonType。
|
| 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 | 針對「Web 服務」機制的入埠傳播,控制「安全主張標記語言」Web SSO 2.0 的運作。
|
| 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 |
|
No | 指定如何將身分對映至登錄使用者。選項有 No、User 和 Group。預設值為 No,且不會使用使用者登錄來建立使用者主體。
|
| nameIDFormat |
|
指定 URI 參照,以對應至未定義在 SAML 核心規格中的名稱 ID 格式。
|
|
| 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 | 指出這個服務提供者的必要演算法。
|
| 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> 元素。 |
- 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 型樣。
- pkixTrustEngine
說明: 指定 PKIX 信任資訊,以用來評估 SAML 回應中之 XML 簽章的可信度和有效性。請勿在一個 samlWebSso20 中指定多個 pkixTrustEngine。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 trustAnchorRef 最上層 keyStore 元素的參照(字串)。 含有用來驗證 SAMLResponse 和 Assertion 簽章之必要公開金鑰的金鑰儲存庫。 - pkixTrustEngine > crl
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id 字串 唯一的配置 ID。 path 字串 指定 CRL 的路徑。
參照主題