Package swiss.trustbroker.config
Class TrustBrokerProperties
java.lang.Object
swiss.trustbroker.config.TrustBrokerProperties
@Configuration
@ConfigurationProperties(prefix="trustbroker.config")
@RefreshScope
public class TrustBrokerProperties
extends Object
The root of the XTB configuration.
It provides global defaults, some of which can be overridden in the XML configurations.
It provides global defaults, some of which can be overridden in the XML configurations.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected booleanbooleanAccess request configuration.Secret for administrative APIs.Announcement configuration.Configuration for attributesgetAudit()Audit configuration.Header block list.Request parameter block list.Deprecated.Replaced by the 'first' marker on the network, e.g.Relative path of the ClaimsProviderDefinitions configuration.Relative path of the SetupCP file.Configuration branch.Configuration path.Global default cookie sameSite flag.getCors()HTTP CORS configuration.getCsp()HTTP CSP configuration.Deprecated.Replaced by the 'first' marker on the network, e.g.HTTP Frame Options configuration.Unused / empty for normal setup.Relative path todefinitionof the global profiles.swiss.trustbroker.common.config.KeystorePropertiesOptional trust anchor for SAML request test automation or monitoring.Relative path toscriptPathof the global Groovy scripts.getGui()GUI related configuration.HTTP GET query parameter (or POST parameter) that can be sent to request selection of an IDP instead of showing the HRD screen.Allow hrdHintTestParameter without a network header or from INTERNET.HTTP header / cookie name to allow a testing framework to pass a CP to be selected in HRD.getIdm()Configuration for optional IDM integration.Issuer ID used for all SAML2 messages XTB produces.Base path of the keystores configured in the XML configurations.getLdap()Configuration for optional LDAP integration.Mobile IDP ID that is used for CP filtering in HRD when XTB is accessed via configured IP addresses (mobileGatewayIpRegex).Montiforing configuration.List<swiss.trustbroker.common.config.RegexNameValue> HTTP markers identifying monitoring clients that cannot deal with new features.Network configuration.getOidc()OIDC protocol configuration.Perimeter URL that is used to access XTB.Profile selection configuration.Autologin cookie that can be used for CP filtering in HRD.Deprecated.Replaced by the 'first' marker on the network, e.g.PEN testing cookie that can be used to implement penetration testing scenarios on the OnMessage hook.Testing cookie us used to signal special handling for test users e.g.getQoa()QoA configuration.Relative path of the SetupRP file.Git repo.swiss.trustbroker.common.config.KeystorePropertiesSigner used during rollover.getSaml()SAML protocol configuration.Relative path of the Groovy scripts.Security check configuration.intSession lifetime for non-SSO login exchanges.intgetSessionLifetimeSec(boolean ssoEnabled) swiss.trustbroker.common.config.KeystorePropertiesDefault signer.Skinny SAML messages reducing the size of the messages (large SAML messages on picky perimeters might block).List<swiss.trustbroker.common.config.RegexNameValue> Legacy clients that get the skinny HRD screen (monitor, testing).Global default for OIDC logout responses.Global default for SAML logout responses.String[]Parts of issuer ID ignored when determining Single Logout (SLO).intMinimum wait in case of fire-and-forget SLO notifications
Default: 200intStop waiting for SLO notifications after that and submit LogoutResponse.Prefix for PEP (Policy Enforcement Point) issuer matching.SSH key path.getSso()SSO configuration.Relative path of the SsoGroupSetup fileintGlobal minimum for QoA level for SSO.SSO session ID policy.intSession lifetime during which SSO is possible on XTB.Configuration for DB state cache.Support features.Comma-separated list of supported TLS versions.HTTP header that supplies a request trace ID.Development feature: Set this toXTB version information for the GUIgetWsfed()WS-Fed protocol configuration.WS-Trust protocol configuration.inthashCode()booleanEnable XML schema API.booleanDeprecated.XTB does not support CP/IDP switching based on CP error responses anymore with v1.10.booleanSAML responder error handling enabled.booleanbooleanDefault should be secure, disable in DEV only if needed for picky user-agents.booleanRun session and auth cache in DB
Default: truebooleanDevelopment feature flag to simulate multi-pod behavior with a single service.booleanUse session cookie for SSO, should always be true.voidsetAccessRequest(AccessRequestConfig accessRequest) Access request configuration.voidsetAdminSecret(String adminSecret) Secret for administrative APIs.voidsetAnnouncements(AnnouncementConfig announcements) Announcement configuration.voidsetAttributes(AttributeConfig attributes) Configuration for attributesvoidsetAudit(AuditConfig audit) Audit configuration.voidsetBlockedHeaderNames(List<String> blockedHeaderNames) Header block list.voidsetBlockedRequestParameterNames(List<String> blockedRequestParameterNames) Request parameter block list.voidsetBrokerIdpId(String brokerIdpId) Deprecated.Replaced by the 'first' marker on the network, e.g.voidsetClaimsDefinitionMapping(String claimsDefinitionMapping) Relative path of the ClaimsProviderDefinitions configuration.voidsetClaimsProviderSetup(String claimsProviderSetup) Relative path of the SetupCP file.voidsetConfigBranch(String configBranch) Configuration branch.voidsetConfigurationPath(String configurationPath) Configuration path.voidsetCookieSameSite(String cookieSameSite) Global default cookie sameSite flag.voidsetCors(CorsPolicies cors) HTTP CORS configuration.voidHTTP CSP configuration.voidsetEnabled(boolean enabled) Enable XML schema API.voidsetEnterpriseIdpId(String enterpriseIdpId) Deprecated.Replaced by the 'first' marker on the network, e.g.voidsetFrameOptions(FrameOptionsPolicies frameOptions) HTTP Frame Options configuration.voidsetFrontendBaseUrl(String frontendBaseUrl) Unused / empty for normal setup.voidvoidsetGlobalProfilesPath(String globalProfilesPath) Relative path todefinitionof the global profiles.voidsetGlobalRequestTrust(swiss.trustbroker.common.config.KeystoreProperties globalRequestTrust) Optional trust anchor for SAML request test automation or monitoring.voidsetGlobalScriptPath(String globalScriptPath) Relative path toscriptPathof the global Groovy scripts.voidsetGui(GuiProperties gui) GUI related configuration.voidsetHandleEnterpriseSwitch(boolean handleEnterpriseSwitch) Deprecated.XTB does not support CP/IDP switching based on CP error responses anymore with v1.10.voidsetHandleResponderErrors(boolean handleResponderErrors) SAML responder error handling enabled.voidsetHrdHintParameter(String hrdHintParameter) HTTP GET query parameter (or POST parameter) that can be sent to request selection of an IDP instead of showing the HRD screen.voidsetHrdHintTestAllowedFromInternet(Boolean hrdHintTestAllowedFromInternet) Allow hrdHintTestParameter without a network header or from INTERNET.voidsetHrdHintTestParameter(String hrdHintTestParameter) HTTP header / cookie name to allow a testing framework to pass a CP to be selected in HRD.voidConfiguration for optional IDM integration.voidIssuer ID used for all SAML2 messages XTB produces.voidsetKeystoreBasePath(String keystoreBasePath) Base path of the keystores configured in the XML configurations.voidsetLdap(LdapStoreConfig ldap) Configuration for optional LDAP integration.voidsetMobileIdpId(String mobileIdpId) Mobile IDP ID that is used for CP filtering in HRD when XTB is accessed via configured IP addresses (mobileGatewayIpRegex).voidsetMonitoring(MonitoringConfig monitoring) Montiforing configuration.voidsetMonitoringHints(List<swiss.trustbroker.common.config.RegexNameValue> monitoringHints) HTTP markers identifying monitoring clients that cannot deal with new features.voidsetNetwork(NetworkConfig network) Network configuration.voidsetOidc(OidcProperties oidc) OIDC protocol configuration.voidsetPerimeterUrl(String perimeterUrl) Perimeter URL that is used to access XTB.voidsetProfileSelection(ProfileSelectionConfig profileSelection) Profile selection configuration.voidsetPublicAutoLoginCookie(String publicAutoLoginCookie) Autologin cookie that can be used for CP filtering in HRD.voidsetPublicIdpId(String publicIdpId) Deprecated.Replaced by the 'first' marker on the network, e.g.voidsetPublicPenTestCookie(String publicPenTestCookie) PEN testing cookie that can be used to implement penetration testing scenarios on the OnMessage hook.voidsetPublicTestCookie(String publicTestCookie) Testing cookie us used to signal special handling for test users e.g.voidQoA configuration.voidsetRelyingPartySetup(String relyingPartySetup) Relative path of the SetupRP file.voidsetRemoteRepoUri(String remoteRepoUri) Git repo.voidsetRolloverSigner(swiss.trustbroker.common.config.KeystoreProperties rolloverSigner) Signer used during rollover.voidsetSaml(SamlProperties saml) SAML protocol configuration.voidsetScriptPath(String scriptPath) Relative path of the Groovy scripts.voidsetSecureBrowserHeaders(boolean secureBrowserHeaders) Default should be secure, disable in DEV only if needed for picky user-agents.voidsetSecurity(SecurityChecks security) Security check configuration.voidsetServerMultiProcessed(boolean serverMultiProcessed) Run session and auth cache in DB
Default: truevoidsetServerSingleUser(boolean serverSingleUser) Development feature flag to simulate multi-pod behavior with a single service.voidsetSessionLifetimeSec(int sessionLifetimeSec) Session lifetime for non-SSO login exchanges.voidsetSigner(swiss.trustbroker.common.config.KeystoreProperties signer) Default signer.voidsetSkinnyAssertionNamespaces(String skinnyAssertionNamespaces) Skinny SAML messages reducing the size of the messages (large SAML messages on picky perimeters might block).voidsetSkinnyHrdTriggers(List<swiss.trustbroker.common.config.RegexNameValue> skinnyHrdTriggers) Legacy clients that get the skinny HRD screen (monitor, testing).voidsetSloDefaultOidcDestinationPath(String sloDefaultOidcDestinationPath) Global default for OIDC logout responses.voidsetSloDefaultSamlDestinationPath(String sloDefaultSamlDestinationPath) Global default for SAML logout responses.voidsetSloIssuerIdDropPatterns(String[] sloIssuerIdDropPatterns) Parts of issuer ID ignored when determining Single Logout (SLO).voidsetSloNotificationMinWaitMillis(int sloNotificationMinWaitMillis) Minimum wait in case of fire-and-forget SLO notifications
Default: 200voidsetSloNotificationTimeoutMillis(int sloNotificationTimeoutMillis) Stop waiting for SLO notifications after that and submit LogoutResponse.voidsetSloNotificationTimoutMillis(int timeout) Deprecated, for removal: This API element is subject to removal in a future version.use sloNotificationTimeoutMillisvoidsetSloPepIssuerIdPrefix(String sloPepIssuerIdPrefix) Prefix for PEP (Policy Enforcement Point) issuer matching.voidsetSshConfigKeyPath(String sshConfigKeyPath) SSH key path.voidSSO configuration.voidsetSsoGroupSetup(String ssoGroupSetup) Relative path of the SsoGroupSetup filevoidsetSsoMinQoaLevel(int ssoMinQoaLevel) Global minimum for QoA level for SSO.voidsetSsoSessionIdPolicy(String ssoSessionIdPolicy) SSO session ID policy.voidsetSsoSessionLifetimeSec(int ssoSessionLifetimeSec) Session lifetime during which SSO is possible on XTB.voidsetStateCache(StateCacheProperties stateCache) Configuration for DB state cache.voidsetSupport(Support support) Support features.voidsetSupportedTlsVersions(String supportedTlsVersions) Comma-separated list of supported TLS versions.voidsetTraceIdHeader(String traceIdHeader) HTTP header that supplies a request trace ID.voidsetUseSessionCookieForSso(boolean useSessionCookieForSso) Use session cookie for SSO, should always be true.voidsetVelocityTemplatePath(String velocityTemplatePath) Development feature: Set this tovoidsetVersionInfo(String versionInfo) XTB version information for the GUIvoidsetWsfed(WsFedConfig wsfed) WS-Fed protocol configuration.voidsetWstrust(WsTrustConfig wstrust) WS-Trust protocol configuration.toString()
-
Constructor Details
-
TrustBrokerProperties
public TrustBrokerProperties()
-
-
Method Details
-
setGitParamsFromEnv
public void setGitParamsFromEnv() -
getSessionLifetimeSec
public int getSessionLifetimeSec(boolean ssoEnabled) -
isPepIssuerMatchingEnabled
-
getSamlConsumerUrl
-
getQoaMap
-
setSloNotificationTimoutMillis
@Deprecated(since="1.15.0", forRemoval=true) public void setSloNotificationTimoutMillis(int timeout) Deprecated, for removal: This API element is subject to removal in a future version.use sloNotificationTimeoutMillis -
isEnabled
public boolean isEnabled()Enable XML schema API.
Default: false- Since:
- 1.15.0
-
getIssuer
Issuer ID used for all SAML2 messages XTB produces.
(The perimeterUrl can be used as issuer ID.) -
getPerimeterUrl
Perimeter URL that is used to access XTB. -
getFrontendBaseUrl
Unused / empty for normal setup.
In development Angular frontend is used via proxy on http://localhost:4200 -
getKeystoreBasePath
Base path of the keystores configured in the XML configurations.- See Also:
-
getGui
GUI related configuration. -
getClaimsDefinitionMapping
Relative path of the ClaimsProviderDefinitions configuration.- See Also:
-
getRelyingPartySetup
Relative path of the SetupRP file.- See Also:
-
getClaimsProviderSetup
Relative path of the SetupCP file.- See Also:
-
getSsoGroupSetup
Relative path of the SsoGroupSetup file- See Also:
-
getScriptPath
Relative path of the Groovy scripts.
Potentially breaking changes:- With 1.7.0 the last part was extracted into
globalScriptPath.
- See Also:
- With 1.7.0 the last part was extracted into
-
getGlobalScriptPath
Relative path toscriptPathof the global Groovy scripts.- Since:
- 1.7.0
- See Also:
-
getGlobalProfilesPath
Relative path todefinitionof the global profiles.- Since:
- 1.7.0
- See Also:
-
getSigner
public swiss.trustbroker.common.config.KeystoreProperties getSigner()Default signer. -
getRolloverSigner
public swiss.trustbroker.common.config.KeystoreProperties getRolloverSigner()Signer used during rollover. -
getGlobalRequestTrust
public swiss.trustbroker.common.config.KeystoreProperties getGlobalRequestTrust()Optional trust anchor for SAML request test automation or monitoring.- Since:
- 1.12.0
-
getIdm
Configuration for optional IDM integration. -
getLdap
Configuration for optional LDAP integration. -
getAttributes
Configuration for attributes -
getAdminSecret
Secret for administrative APIs.
E.g. the one to trigger immediate config reload. -
getSshConfigKeyPath
SSH key path. Set during bootstrap, not via application.yml. -
getRemoteRepoUri
Git repo. Set during bootstrap, not via application.yml. -
getConfigBranch
Configuration branch. Set during bootstrap, not via application.yml. -
getConfigurationPath
Configuration path. Set during bootstrap, not via application.yml. -
getMonitoring
Montiforing configuration.- Since:
- 1.15.0
-
getWstrust
WS-Trust protocol configuration. -
getWsfed
WS-Fed protocol configuration.- Since:
- 1.13.0
-
getSaml
SAML protocol configuration. -
getOidc
OIDC protocol configuration. -
getSecurity
Security check configuration. -
getCors
HTTP CORS configuration. -
getCsp
HTTP CSP configuration. -
getFrameOptions
HTTP Frame Options configuration. -
isServerMultiProcessed
public boolean isServerMultiProcessed()Run session and auth cache in DB
Default: true -
isServerSingleUser
public boolean isServerSingleUser()Development feature flag to simulate multi-pod behavior with a single service.
Default: false -
getSupport
Support features.
Default: null, disabled- Since:
- 1.7.0
-
getAudit
Audit configuration.- Since:
- 1.8.0
-
isSecureBrowserHeaders
public boolean isSecureBrowserHeaders()Default should be secure, disable in DEV only if needed for picky user-agents.
Default: true -
isUseSessionCookieForSso
public boolean isUseSessionCookieForSso()Use session cookie for SSO, should always be true.
Default: true -
getCookieSameSite
Global default cookie sameSite flag.
Default: None -
getTraceIdHeader
HTTP header that supplies a request trace ID. -
getSessionLifetimeSec
public int getSessionLifetimeSec()Session lifetime for non-SSO login exchanges. State used to correlate pending AuthnRequest with Response received from CP after a user has logged in there. A too short value leads to aborted logins when users continue their login on the CP after a longer delay. -
getSsoSessionLifetimeSec
public int getSsoSessionLifetimeSec()Session lifetime during which SSO is possible on XTB. -
getSsoMinQoaLevel
public int getSsoMinQoaLevel()Global minimum for QoA level for SSO.- See Also:
-
getSloNotificationTimeoutMillis
public int getSloNotificationTimeoutMillis()Stop waiting for SLO notifications after that and submit LogoutResponse.
Default: 2000- See Also:
-
getSloNotificationMinWaitMillis
public int getSloNotificationMinWaitMillis()Minimum wait in case of fire-and-forget SLO notifications
Default: 200- See Also:
-
getSloDefaultSamlDestinationPath
Global default for SAML logout responses. Relative path or known absolute URL (e.g. to confirmation page).- See Also:
-
getSloDefaultOidcDestinationPath
Global default for OIDC logout responses. Relative path or known absolute URL (e.g. to confirmation page).- See Also:
-
getSsoSessionIdPolicy
SSO session ID policy.- See Also:
-
getSloPepIssuerIdPrefix
Prefix for PEP (Policy Enforcement Point) issuer matching. -
getSloIssuerIdDropPatterns
Parts of issuer ID ignored when determining Single Logout (SLO). These are common parts of RP aliases.- See Also:
-
isHandleResponderErrors
public boolean isHandleResponderErrors()SAML responder error handling enabled.
Default: false -
isHandleEnterpriseSwitch
Deprecated.XTB does not support CP/IDP switching based on CP error responses anymore with v1.10.User request switch to Enterprise IDP feature flag. If enabled XTB will redirect the user to the intranet IDP when requested.
Default: false -
getEnterpriseIdpId
Deprecated.Replaced by the 'first' marker on the network, e.g. INTRANET-first.Intranet IDP ID that can be used for CP filtering in HRD. -
getBrokerIdpId
Deprecated.Replaced by the 'first' marker on the network, e.g. INTERNET-first.Broker IDP ID that can be used for CP filtering in HRD.- See Also:
-
getPublicIdpId
Deprecated.Replaced by the 'first' marker on the network, e.g. INTERNET-first.Public IDP ID that can be used for CP filtering in HRD. -
getMobileIdpId
Mobile IDP ID that is used for CP filtering in HRD when XTB is accessed via configured IP addresses (mobileGatewayIpRegex). Special case: A single IDP that can be identified by its IP address and then automatically dispatched to the that CP. -
getHrdHintParameter
HTTP GET query parameter (or POST parameter) that can be sent to request selection of an IDP instead of showing the HRD screen.
SeeClaimsProviderfor the fields matched against this parameter.- Since:
- 1.10.0
- See Also:
-
getHrdHintTestParameter
HTTP header / cookie name to allow a testing framework to pass a CP to be selected in HRD.
For normal applications, setting HTTP headers or cookies is usually not convenient (seehrdHintParameter).
SeeClaimsProviderfor the fields matched against this parameter.
Note: This is ignored if the request is not from INTRANET (seehrdHintTestAllowedFromInternet). If set, it also suppresses the AccessRequest.- Since:
- 1.10.0
- See Also:
-
getHrdHintTestAllowedFromInternet
Allow hrdHintTestParameter without a network header or from INTERNET.
Note: In case you use AccessRequest, only enable this if AccessRequest may be skipped without security impact.
Default: false- Since:
- 1.10.0
-
getPublicAutoLoginCookie
Autologin cookie that can be used for CP filtering in HRD. -
getPublicPenTestCookie
PEN testing cookie that can be used to implement penetration testing scenarios on the OnMessage hook. If not configured, the OnMessage hook is disabled.- Since:
- 1.13.0
-
getPublicTestCookie
Testing cookie us used to signal special handling for test users e.g. showing invisible IDPs on the HRD screen.- Since:
- 1.15.0
-
getNetwork
Network configuration. -
getStateCache
Configuration for DB state cache. -
getVersionInfo
XTB version information for the GUI -
getSupportedTlsVersions
Comma-separated list of supported TLS versions. -
getVelocityTemplatePath
Development feature: Set this to../trustbroker-service/src/main/resources
for faster template development - templates will be loaded from the file system on each access -
getSso
SSO configuration.- Since:
- 1.15.0
-
getAnnouncements
Announcement configuration. -
getQoa
QoA configuration. -
getProfileSelection
Profile selection configuration. -
getAccessRequest
Access request configuration. -
getSkinnyAssertionNamespaces
Skinny SAML messages reducing the size of the messages (large SAML messages on picky perimeters might block).
Default: a,no-type -
getSkinnyHrdTriggers
Legacy clients that get the skinny HRD screen (monitor, testing).
Note: Since 1.15.0 the value is ignored. -
getMonitoringHints
HTTP markers identifying monitoring clients that cannot deal with new features. -
getBlockedRequestParameterNames
Request parameter block list.
If any of these appear in the HTTP request, the request is blocked. Default:- @class used by Jackson JSON
- Since:
- 1.14.0
-
getBlockedHeaderNames
Header block list.
If any of these appear in the HTTP request, the request is blocked. Default: none- Since:
- 1.14.0
-
setEnabled
public void setEnabled(boolean enabled) Enable XML schema API.
Default: false- Since:
- 1.15.0
-
setIssuer
Issuer ID used for all SAML2 messages XTB produces.
(The perimeterUrl can be used as issuer ID.) -
setPerimeterUrl
Perimeter URL that is used to access XTB. -
setFrontendBaseUrl
Unused / empty for normal setup.
In development Angular frontend is used via proxy on http://localhost:4200 -
setKeystoreBasePath
Base path of the keystores configured in the XML configurations.- See Also:
-
setGui
GUI related configuration. -
setClaimsDefinitionMapping
Relative path of the ClaimsProviderDefinitions configuration.- See Also:
-
setRelyingPartySetup
Relative path of the SetupRP file.- See Also:
-
setClaimsProviderSetup
Relative path of the SetupCP file.- See Also:
-
setSsoGroupSetup
Relative path of the SsoGroupSetup file- See Also:
-
setScriptPath
Relative path of the Groovy scripts.
Potentially breaking changes:- With 1.7.0 the last part was extracted into
globalScriptPath.
- See Also:
- With 1.7.0 the last part was extracted into
-
setGlobalScriptPath
Relative path toscriptPathof the global Groovy scripts.- Since:
- 1.7.0
- See Also:
-
setGlobalProfilesPath
Relative path todefinitionof the global profiles.- Since:
- 1.7.0
- See Also:
-
setSigner
public void setSigner(swiss.trustbroker.common.config.KeystoreProperties signer) Default signer. -
setRolloverSigner
public void setRolloverSigner(swiss.trustbroker.common.config.KeystoreProperties rolloverSigner) Signer used during rollover. -
setGlobalRequestTrust
public void setGlobalRequestTrust(swiss.trustbroker.common.config.KeystoreProperties globalRequestTrust) Optional trust anchor for SAML request test automation or monitoring.- Since:
- 1.12.0
-
setIdm
Configuration for optional IDM integration. -
setLdap
Configuration for optional LDAP integration. -
setAttributes
Configuration for attributes -
setAdminSecret
Secret for administrative APIs.
E.g. the one to trigger immediate config reload. -
setSshConfigKeyPath
SSH key path. Set during bootstrap, not via application.yml. -
setRemoteRepoUri
Git repo. Set during bootstrap, not via application.yml. -
setConfigBranch
Configuration branch. Set during bootstrap, not via application.yml. -
setConfigurationPath
Configuration path. Set during bootstrap, not via application.yml. -
setMonitoring
Montiforing configuration.- Since:
- 1.15.0
-
setWstrust
WS-Trust protocol configuration. -
setWsfed
WS-Fed protocol configuration.- Since:
- 1.13.0
-
setSaml
SAML protocol configuration. -
setOidc
OIDC protocol configuration. -
setSecurity
Security check configuration. -
setCors
HTTP CORS configuration. -
setCsp
HTTP CSP configuration. -
setFrameOptions
HTTP Frame Options configuration. -
setServerMultiProcessed
public void setServerMultiProcessed(boolean serverMultiProcessed) Run session and auth cache in DB
Default: true -
setServerSingleUser
public void setServerSingleUser(boolean serverSingleUser) Development feature flag to simulate multi-pod behavior with a single service.
Default: false -
setSupport
Support features.
Default: null, disabled- Since:
- 1.7.0
-
setAudit
Audit configuration.- Since:
- 1.8.0
-
setSecureBrowserHeaders
public void setSecureBrowserHeaders(boolean secureBrowserHeaders) Default should be secure, disable in DEV only if needed for picky user-agents.
Default: true -
setUseSessionCookieForSso
public void setUseSessionCookieForSso(boolean useSessionCookieForSso) Use session cookie for SSO, should always be true.
Default: true -
setCookieSameSite
Global default cookie sameSite flag.
Default: None -
setTraceIdHeader
HTTP header that supplies a request trace ID. -
setSessionLifetimeSec
public void setSessionLifetimeSec(int sessionLifetimeSec) Session lifetime for non-SSO login exchanges. State used to correlate pending AuthnRequest with Response received from CP after a user has logged in there. A too short value leads to aborted logins when users continue their login on the CP after a longer delay. -
setSsoSessionLifetimeSec
public void setSsoSessionLifetimeSec(int ssoSessionLifetimeSec) Session lifetime during which SSO is possible on XTB. -
setSsoMinQoaLevel
public void setSsoMinQoaLevel(int ssoMinQoaLevel) Global minimum for QoA level for SSO.- See Also:
-
setSloNotificationTimeoutMillis
public void setSloNotificationTimeoutMillis(int sloNotificationTimeoutMillis) Stop waiting for SLO notifications after that and submit LogoutResponse.
Default: 2000- See Also:
-
setSloNotificationMinWaitMillis
public void setSloNotificationMinWaitMillis(int sloNotificationMinWaitMillis) Minimum wait in case of fire-and-forget SLO notifications
Default: 200- See Also:
-
setSloDefaultSamlDestinationPath
Global default for SAML logout responses. Relative path or known absolute URL (e.g. to confirmation page).- See Also:
-
setSloDefaultOidcDestinationPath
Global default for OIDC logout responses. Relative path or known absolute URL (e.g. to confirmation page).- See Also:
-
setSsoSessionIdPolicy
SSO session ID policy.- See Also:
-
setSloPepIssuerIdPrefix
Prefix for PEP (Policy Enforcement Point) issuer matching. -
setSloIssuerIdDropPatterns
Parts of issuer ID ignored when determining Single Logout (SLO). These are common parts of RP aliases.- See Also:
-
setHandleResponderErrors
public void setHandleResponderErrors(boolean handleResponderErrors) SAML responder error handling enabled.
Default: false -
setHandleEnterpriseSwitch
Deprecated.XTB does not support CP/IDP switching based on CP error responses anymore with v1.10.User request switch to Enterprise IDP feature flag. If enabled XTB will redirect the user to the intranet IDP when requested.
Default: false -
setEnterpriseIdpId
Deprecated.Replaced by the 'first' marker on the network, e.g. INTRANET-first.Intranet IDP ID that can be used for CP filtering in HRD. -
setBrokerIdpId
Deprecated.Replaced by the 'first' marker on the network, e.g. INTERNET-first.Broker IDP ID that can be used for CP filtering in HRD.- See Also:
-
setPublicIdpId
Deprecated.Replaced by the 'first' marker on the network, e.g. INTERNET-first.Public IDP ID that can be used for CP filtering in HRD. -
setMobileIdpId
Mobile IDP ID that is used for CP filtering in HRD when XTB is accessed via configured IP addresses (mobileGatewayIpRegex). Special case: A single IDP that can be identified by its IP address and then automatically dispatched to the that CP. -
setHrdHintParameter
HTTP GET query parameter (or POST parameter) that can be sent to request selection of an IDP instead of showing the HRD screen.
SeeClaimsProviderfor the fields matched against this parameter.- Since:
- 1.10.0
- See Also:
-
setHrdHintTestParameter
HTTP header / cookie name to allow a testing framework to pass a CP to be selected in HRD.
For normal applications, setting HTTP headers or cookies is usually not convenient (seehrdHintParameter).
SeeClaimsProviderfor the fields matched against this parameter.
Note: This is ignored if the request is not from INTRANET (seehrdHintTestAllowedFromInternet). If set, it also suppresses the AccessRequest.- Since:
- 1.10.0
- See Also:
-
setHrdHintTestAllowedFromInternet
Allow hrdHintTestParameter without a network header or from INTERNET.
Note: In case you use AccessRequest, only enable this if AccessRequest may be skipped without security impact.
Default: false- Since:
- 1.10.0
-
setPublicAutoLoginCookie
Autologin cookie that can be used for CP filtering in HRD. -
setPublicPenTestCookie
PEN testing cookie that can be used to implement penetration testing scenarios on the OnMessage hook. If not configured, the OnMessage hook is disabled.- Since:
- 1.13.0
-
setPublicTestCookie
Testing cookie us used to signal special handling for test users e.g. showing invisible IDPs on the HRD screen.- Since:
- 1.15.0
-
setNetwork
Network configuration. -
setStateCache
Configuration for DB state cache. -
setVersionInfo
XTB version information for the GUI -
setSupportedTlsVersions
Comma-separated list of supported TLS versions. -
setVelocityTemplatePath
Development feature: Set this to../trustbroker-service/src/main/resources
for faster template development - templates will be loaded from the file system on each access -
setSso
SSO configuration.- Since:
- 1.15.0
-
setAnnouncements
Announcement configuration. -
setQoa
QoA configuration. -
setProfileSelection
Profile selection configuration. -
setAccessRequest
Access request configuration. -
setSkinnyAssertionNamespaces
Skinny SAML messages reducing the size of the messages (large SAML messages on picky perimeters might block).
Default: a,no-type -
setSkinnyHrdTriggers
public void setSkinnyHrdTriggers(List<swiss.trustbroker.common.config.RegexNameValue> skinnyHrdTriggers) Legacy clients that get the skinny HRD screen (monitor, testing).
Note: Since 1.15.0 the value is ignored. -
setMonitoringHints
public void setMonitoringHints(List<swiss.trustbroker.common.config.RegexNameValue> monitoringHints) HTTP markers identifying monitoring clients that cannot deal with new features. -
setBlockedRequestParameterNames
Request parameter block list.
If any of these appear in the HTTP request, the request is blocked. Default:- @class used by Jackson JSON
- Since:
- 1.14.0
-
setBlockedHeaderNames
Header block list.
If any of these appear in the HTTP request, the request is blocked. Default: none- Since:
- 1.14.0
-
equals
-
canEqual
-
hashCode
public int hashCode() -
toString
-