WORKERS AHEAD!
You are viewing the development documentation for the Apereo CAS server. The functionality presented here is not officially released yet. This is a work in progress and will be continually updated as development moves forward. You are most encouraged to test the changes presented.
Consul Server Discovery Service
HashiCorp Consul has multiple components, but as a whole, it is a tool for discovering and configuring services in your infrastructure. It provides key features:
-
Service Discovery: Clients of Consul can provide a service, such as api or mysql, and other clients can use Consul to discover providers of a given service. Using either DNS or HTTP, applications can easily find the services they depend upon.
-
Health Checking: Consul clients can provide any number of health checks, either associated with a given service (“is the webserver returning 200 OK”), or with the local node (“is memory utilization below 90%”). This information can be used by an operator to monitor cluster health, and it is used by the service discovery components to route traffic away from unhealthy hosts.
-
KV Store: Applications can make use of Consul’s hierarchical key/value store for any number of purposes, including dynamic configuration, feature flagging, coordination, leader election, and more. The simple HTTP API makes it easy to use.
-
Multi Datacenter: Consul supports multiple datacenters out of the box. This means users of Consul do not have to worry about building additional layers of abstraction to grow to multiple regions.
CAS provides a Consul-enabled service discovery server that is based on Spring Cloud Consul and bootstrapped via Spring Cloud.
Installation
- To run the Consul discovery server, please see this guide for installation instructions. A simple Consul installation may be run as
consul agent -dev -ui
- Look for a suitable and relevant ready-made Docker image via
docker search consul
.
When deployed and assuming default settings, the Consul dashboard would be available at: http://localhost:8500/ui
.
Note that a Consul Agent client must be available to all CAS server nodes. By default, the agent client is expected to be at localhost:8500
. See the Agent documentation for specifics on how to start an Agent client.
CAS Discovery Service Clients
Each individual CAS server is given the ability to auto-register itself with the discovery server, provided configuration is made available to instruct the CAS server how to locate and connect to the discover server service.
Support is added by including the following dependency in the WAR overlay:
1
2
3
4
5
<dependency>
<groupId>org.apereo.cas</groupId>
<artifactId>cas-server-support-consul-client</artifactId>
<version>${cas.version}</version>
</dependency>
1
implementation "org.apereo.cas:cas-server-support-consul-client:${project.'cas.version'}"
1
2
3
4
5
6
7
8
9
dependencyManagement {
imports {
mavenBom "org.apereo.cas:cas-server-support-bom:${project.'cas.version'}"
}
}
dependencies {
implementation "org.apereo.cas:cas-server-support-consul-client"
}
1
2
3
4
5
6
7
8
9
10
dependencies {
/*
The following platform references should be included automatically and are listed here for reference only.
implementation enforcedPlatform("org.apereo.cas:cas-server-support-bom:${project.'cas.version'}")
implementation platform(org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES)
*/
implementation "org.apereo.cas:cas-server-support-consul-client"
}
The following settings and properties are available from the CAS configuration catalog:
- Required
- Optional
- Signing & Encryption
- Hibernate & JDBC
- Email Servers
- Groovy Scripting
- LDAP & Active Directory
- Authentication
- Password Encoding
- Principal Transformation
- Password Policy
- Third Party
- Notes
spring.cloud.config.discovery.enabled=false
Flag to indicate that config server discovery is enabled (config server URL will be looked up via discovery).
CAS Property:
|
1 |
spring.cloud.config.discovery.enabled=... |
1
spring:
cloud:
config:
discovery:
enabled: "..."
1
java -Dspring.cloud.config.discovery.enabled="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONFIG_DISCOVERY_ENABLED="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.config.discovery.enabled="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.config.discovery.service-id=configserver
Service id to locate config server.
org.springframework.cloud.config.client.ConfigClientProperties$Discovery.
CAS Property: spring.cloud.config.discovery.service-id
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.config.discovery.service-id=configserver
1
spring:
cloud:
config:
discovery:
service-id: "configserver"
1
java -Dspring.cloud.config.discovery.service-id="configserver" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONFIG_DISCOVERY_SERVICE_ID="configserver"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.config.discovery.service-id="configserver"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.acl-token=
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.acl-token
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.acl-token=...
1
spring:
cloud:
consul:
config:
acl-token: "..."
1
java -Dspring.cloud.consul.config.acl-token="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_ACL_TOKEN="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.acl-token="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.data-key=data
If format is Format.PROPERTIES or Format.YAML then the following field is used as key to look up consul for configuration.
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.data-key
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.data-key=data
1
spring:
cloud:
consul:
config:
data-key: "data"
1
java -Dspring.cloud.consul.config.data-key="data" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_DATA_KEY="data"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.data-key="data"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.default-context=application
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.default-context
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.default-context=application
1
spring:
cloud:
consul:
config:
default-context: "application"
1
java -Dspring.cloud.consul.config.default-context="application" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_DEFAULT_CONTEXT="application"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.default-context="application"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.enabled=true
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.enabled=true
1
spring:
cloud:
consul:
config:
enabled: "true"
1
java -Dspring.cloud.consul.config.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.fail-fast=true
Throw exceptions during config lookup if true, otherwise, log warnings.
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.fail-fast
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.fail-fast=true
1
spring:
cloud:
consul:
config:
fail-fast: "true"
1
java -Dspring.cloud.consul.config.fail-fast="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_FAIL_FAST="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.fail-fast="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.format=key-value
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.format
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.format=key-value
1
spring:
cloud:
consul:
config:
format: "key-value"
1
java -Dspring.cloud.consul.config.format="key-value" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_FORMAT="key-value"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.format="key-value"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.name=
Alternative to spring.application.name to use in looking up values in consul KV.
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.name
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.name=...
1
spring:
cloud:
consul:
config:
name: "..."
1
java -Dspring.cloud.consul.config.name="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_NAME="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.name="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.prefix=
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.prefix
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.prefix=...
1
spring:
cloud:
consul:
config:
prefix: "..."
1
java -Dspring.cloud.consul.config.prefix="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_PREFIX="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.prefix="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
Deprecation status is WARNING
with a replacement setting: spring.cloud.consul.config.prefixes
.
spring.cloud.consul.config.prefixes=
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.prefixes
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.prefixes=...
1
spring:
cloud:
consul:
config:
prefixes: "..."
1
java -Dspring.cloud.consul.config.prefixes="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_PREFIXES="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.prefixes="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.profile-separator=,
org.springframework.cloud.consul.config.ConsulConfigProperties.
CAS Property: spring.cloud.consul.config.profile-separator
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.profile-separator=,
1
spring:
cloud:
consul:
config:
profile-separator: ","
1
java -Dspring.cloud.consul.config.profile-separator="," -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_PROFILE_SEPARATOR=","
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.profile-separator=","
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.watch.delay=1000
The value of the fixed delay for the watch in millis. Defaults to 1000.
org.springframework.cloud.consul.config.ConsulConfigProperties$Watch.
CAS Property: spring.cloud.consul.config.watch.delay
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.watch.delay=1000
1
spring:
cloud:
consul:
config:
watch:
delay: "1000"
1
java -Dspring.cloud.consul.config.watch.delay="1000" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_WATCH_DELAY="1000"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.watch.delay="1000"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.watch.enabled=true
If the watch is enabled. Defaults to true.
org.springframework.cloud.consul.config.ConsulConfigProperties$Watch.
CAS Property: spring.cloud.consul.config.watch.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.watch.enabled=true
1
spring:
cloud:
consul:
config:
watch:
enabled: "true"
1
java -Dspring.cloud.consul.config.watch.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_WATCH_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.watch.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.config.watch.wait-time=55
The number of seconds to wait (or block) for watch query, defaults to 55. Needs to be less than default ConsulClient (defaults to 60). To increase ConsulClient timeout create a ConsulClient bean with a custom ConsulRawClient with a custom HttpClient.
org.springframework.cloud.consul.config.ConsulConfigProperties$Watch.
CAS Property: spring.cloud.consul.config.watch.wait-time
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.config.watch.wait-time=55
1
spring:
cloud:
consul:
config:
watch:
wait-time: "55"
1
java -Dspring.cloud.consul.config.watch.wait-time="55" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_CONFIG_WATCH_WAIT_TIME="55"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.config.watch.wait-time="55"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.acl-token=
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.acl-token
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.acl-token=...
1
spring:
cloud:
consul:
discovery:
acl-token: "..."
1
java -Dspring.cloud.consul.discovery.acl-token="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_ACL_TOKEN="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.acl-token="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.catalog-services-watch-delay=1000
The delay between calls to watch consul catalog in millis, default is 1000.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.catalog-services-watch-delay
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.catalog-services-watch-delay=1000
1
spring:
cloud:
consul:
discovery:
catalog-services-watch-delay: "1000"
1
java -Dspring.cloud.consul.discovery.catalog-services-watch-delay="1000" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_CATALOG_SERVICES_WATCH_DELAY="1000"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.catalog-services-watch-delay="1000"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.catalog-services-watch-timeout=2
The number of seconds to block while watching consul catalog, default is 2.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.catalog-services-watch-timeout
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.catalog-services-watch-timeout=2
1
spring:
cloud:
consul:
discovery:
catalog-services-watch-timeout: "2"
1
java -Dspring.cloud.consul.discovery.catalog-services-watch-timeout="2" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_CATALOG_SERVICES_WATCH_TIMEOUT="2"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.catalog-services-watch-timeout="2"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.consistency-mode=default
Consistency mode for health service request.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.consistency-mode
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.consistency-mode=default
1
spring:
cloud:
consul:
discovery:
consistency-mode: "default"
1
java -Dspring.cloud.consul.discovery.consistency-mode="default" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_CONSISTENCY_MODE="default"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.consistency-mode="default"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.datacenters=
Map of serviceId's -> datacenter to query for in server list. This allows looking up services in another datacenters.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.datacenters
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.datacenters=...
1
spring:
cloud:
consul:
discovery:
datacenters: "..."
1
java -Dspring.cloud.consul.discovery.datacenters="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_DATACENTERS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.datacenters="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.default-query-tag=
Tag to query for in service list if one is not listed in serverListQueryTags. Multiple tags can be specified with a comma separated value.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.default-query-tag
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.default-query-tag=...
1
spring:
cloud:
consul:
discovery:
default-query-tag: "..."
1
java -Dspring.cloud.consul.discovery.default-query-tag="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_DEFAULT_QUERY_TAG="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.default-query-tag="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.default-zone-metadata-name=zone
Service instance zone comes from metadata. This allows changing the metadata tag name.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.default-zone-metadata-name
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.default-zone-metadata-name=zone
1
spring:
cloud:
consul:
discovery:
default-zone-metadata-name: "zone"
1
java -Dspring.cloud.consul.discovery.default-zone-metadata-name="zone" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_DEFAULT_ZONE_METADATA_NAME="zone"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.default-zone-metadata-name="zone"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.deregister=true
Disable automatic de-registration of service in consul.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.deregister
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.deregister=true
1
spring:
cloud:
consul:
discovery:
deregister: "true"
1
java -Dspring.cloud.consul.discovery.deregister="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_DEREGISTER="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.deregister="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.enable-tag-override=
Enable tag override for the registered service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.enable-tag-override
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.enable-tag-override=...
1
spring:
cloud:
consul:
discovery:
enable-tag-override: "..."
1
java -Dspring.cloud.consul.discovery.enable-tag-override="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_ENABLE_TAG_OVERRIDE="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.enable-tag-override="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.enabled=true
Is service discovery enabled?
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.enabled=true
1
spring:
cloud:
consul:
discovery:
enabled: "true"
1
java -Dspring.cloud.consul.discovery.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.fail-fast=true
Throw exceptions during service registration if true, otherwise, log warnings (defaults to true).
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.fail-fast
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.fail-fast=true
1
spring:
cloud:
consul:
discovery:
fail-fast: "true"
1
java -Dspring.cloud.consul.discovery.fail-fast="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_FAIL_FAST="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.fail-fast="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-critical-timeout=
Timeout to deregister services critical for longer than timeout (e.g. 30m). Requires consul version 7.x or higher.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-critical-timeout
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-critical-timeout=...
1
spring:
cloud:
consul:
discovery:
health-check-critical-timeout: "..."
1
java -Dspring.cloud.consul.discovery.health-check-critical-timeout="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_CRITICAL_TIMEOUT="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-critical-timeout="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-headers=
Headers to be applied to the Health Check calls.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-headers
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-headers=...
1
spring:
cloud:
consul:
discovery:
health-check-headers: "..."
1
java -Dspring.cloud.consul.discovery.health-check-headers="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_HEADERS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-headers="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-interval=10s
How often to perform the health check (e.g. 10s), defaults to 10s.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-interval
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-interval=10s
1
spring:
cloud:
consul:
discovery:
health-check-interval: "10s"
1
java -Dspring.cloud.consul.discovery.health-check-interval="10s" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_INTERVAL="10s"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-interval="10s"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-path=/actuator/health
Alternate server path to invoke for health checking.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-path
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-path=/actuator/health
1
spring:
cloud:
consul:
discovery:
health-check-path: "/actuator/health"
1
java -Dspring.cloud.consul.discovery.health-check-path="/actuator/health" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_PATH="/actuator/health"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-path="/actuator/health"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-timeout=
Timeout for health check (e.g. 10s).
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-timeout
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-timeout=...
1
spring:
cloud:
consul:
discovery:
health-check-timeout: "..."
1
java -Dspring.cloud.consul.discovery.health-check-timeout="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_TIMEOUT="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-timeout="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-tls-skip-verify=
Skips certificate verification during service checks if true, otherwise runs certificate verification.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-tls-skip-verify
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-tls-skip-verify=...
1
spring:
cloud:
consul:
discovery:
health-check-tls-skip-verify: "..."
1
java -Dspring.cloud.consul.discovery.health-check-tls-skip-verify="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_TLS_SKIP_VERIFY="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-tls-skip-verify="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.health-check-url=
Custom health check url to override default.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.health-check-url
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.health-check-url=...
1
spring:
cloud:
consul:
discovery:
health-check-url: "..."
1
java -Dspring.cloud.consul.discovery.health-check-url="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEALTH_CHECK_URL="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.health-check-url="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.heartbeat.actuator-health-group=
The actuator health group to use (null for the root group) when determining system health via Actuator.
org.springframework.cloud.consul.discovery.HeartbeatProperties.
CAS Property: spring.cloud.consul.discovery.heartbeat.actuator-health-group
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.heartbeat.actuator-health-group=...
1
spring:
cloud:
consul:
discovery:
heartbeat:
actuator-health-group: "..."
1
java -Dspring.cloud.consul.discovery.heartbeat.actuator-health-group="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEARTBEAT_ACTUATOR_HEALTH_GROUP="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.heartbeat.actuator-health-group="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.heartbeat.enabled=false
org.springframework.cloud.consul.discovery.HeartbeatProperties.
CAS Property: spring.cloud.consul.discovery.heartbeat.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.heartbeat.enabled=...
1
spring:
cloud:
consul:
discovery:
heartbeat:
enabled: "..."
1
java -Dspring.cloud.consul.discovery.heartbeat.enabled="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEARTBEAT_ENABLED="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.heartbeat.enabled="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.heartbeat.interval-ratio=
org.springframework.cloud.consul.discovery.HeartbeatProperties.
CAS Property: spring.cloud.consul.discovery.heartbeat.interval-ratio
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.heartbeat.interval-ratio=...
1
spring:
cloud:
consul:
discovery:
heartbeat:
interval-ratio: "..."
1
java -Dspring.cloud.consul.discovery.heartbeat.interval-ratio="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEARTBEAT_INTERVAL_RATIO="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.heartbeat.interval-ratio="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.heartbeat.reregister-service-on-failure=false
org.springframework.cloud.consul.discovery.HeartbeatProperties.
CAS Property: spring.cloud.consul.discovery.heartbeat.reregister-service-on-failure
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.heartbeat.reregister-service-on-failure=...
1
spring:
cloud:
consul:
discovery:
heartbeat:
reregister-service-on-failure: "..."
1
java -Dspring.cloud.consul.discovery.heartbeat.reregister-service-on-failure="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEARTBEAT_REREGISTER_SERVICE_ON_FAILURE="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.heartbeat.reregister-service-on-failure="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.heartbeat.ttl=30s
org.springframework.cloud.consul.discovery.HeartbeatProperties.
CAS Property: spring.cloud.consul.discovery.heartbeat.ttl
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.heartbeat.ttl=30s
1
spring:
cloud:
consul:
discovery:
heartbeat:
ttl: "30s"
1
java -Dspring.cloud.consul.discovery.heartbeat.ttl="30s" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEARTBEAT_TTL="30s"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.heartbeat.ttl="30s"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.heartbeat.use-actuator-health=true
Whether or not to take the current system health (as reported via the Actuator Health endpoint) into account when reporting the application status to the Consul TTL check. Actuator Health endpoint also has to be available to the application.
org.springframework.cloud.consul.discovery.HeartbeatProperties.
CAS Property: spring.cloud.consul.discovery.heartbeat.use-actuator-health
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.heartbeat.use-actuator-health=true
1
spring:
cloud:
consul:
discovery:
heartbeat:
use-actuator-health: "true"
1
java -Dspring.cloud.consul.discovery.heartbeat.use-actuator-health="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HEARTBEAT_USE_ACTUATOR_HEALTH="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.heartbeat.use-actuator-health="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.hostname=
Hostname to use when accessing server.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.hostname
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.hostname=...
1
spring:
cloud:
consul:
discovery:
hostname: "..."
1
java -Dspring.cloud.consul.discovery.hostname="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_HOSTNAME="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.hostname="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.include-hostname-in-instance-id=false
Whether hostname is included into the default instance id when registering service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.include-hostname-in-instance-id
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.include-hostname-in-instance-id=...
1
spring:
cloud:
consul:
discovery:
include-hostname-in-instance-id: "..."
1
java -Dspring.cloud.consul.discovery.include-hostname-in-instance-id="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_INCLUDE_HOSTNAME_IN_INSTANCE_ID="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.include-hostname-in-instance-id="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.instance-group=
Service instance group.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.instance-group
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.instance-group=...
1
spring:
cloud:
consul:
discovery:
instance-group: "..."
1
java -Dspring.cloud.consul.discovery.instance-group="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_INSTANCE_GROUP="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.instance-group="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.instance-id=
Unique service instance id.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.instance-id
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.instance-id=...
1
spring:
cloud:
consul:
discovery:
instance-id: "..."
1
java -Dspring.cloud.consul.discovery.instance-id="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_INSTANCE_ID="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.instance-id="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.instance-zone=
Service instance zone.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.instance-zone
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.instance-zone=...
1
spring:
cloud:
consul:
discovery:
instance-zone: "..."
1
java -Dspring.cloud.consul.discovery.instance-zone="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_INSTANCE_ZONE="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.instance-zone="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.ip-address=
IP address to use when accessing service (must also set preferIpAddress to use).
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.ip-address
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.ip-address=...
1
spring:
cloud:
consul:
discovery:
ip-address: "..."
1
java -Dspring.cloud.consul.discovery.ip-address="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_IP_ADDRESS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.ip-address="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.lifecycle.enabled=true
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties$Lifecycle.
CAS Property: spring.cloud.consul.discovery.lifecycle.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.lifecycle.enabled=true
1
spring:
cloud:
consul:
discovery:
lifecycle:
enabled: "true"
1
java -Dspring.cloud.consul.discovery.lifecycle.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_LIFECYCLE_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.lifecycle.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.management-enable-tag-override=
Enable tag override for the registered management service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.management-enable-tag-override
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.management-enable-tag-override=...
1
spring:
cloud:
consul:
discovery:
management-enable-tag-override: "..."
1
java -Dspring.cloud.consul.discovery.management-enable-tag-override="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_MANAGEMENT_ENABLE_TAG_OVERRIDE="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.management-enable-tag-override="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.management-metadata=
Metadata to use when registering management service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.management-metadata
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.management-metadata=...
1
spring:
cloud:
consul:
discovery:
management-metadata: "..."
1
java -Dspring.cloud.consul.discovery.management-metadata="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_MANAGEMENT_METADATA="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.management-metadata="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.management-port=
Port to register the management service under (defaults to management port).
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.management-port
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.management-port=...
1
spring:
cloud:
consul:
discovery:
management-port: "..."
1
java -Dspring.cloud.consul.discovery.management-port="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_MANAGEMENT_PORT="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.management-port="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.management-suffix=management
Suffix to use when registering management service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.management-suffix
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.management-suffix=management
1
spring:
cloud:
consul:
discovery:
management-suffix: "management"
1
java -Dspring.cloud.consul.discovery.management-suffix="management" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_MANAGEMENT_SUFFIX="management"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.management-suffix="management"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.management-tags=
Tags to use when registering management service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.management-tags
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.management-tags=...
1
spring:
cloud:
consul:
discovery:
management-tags: "..."
1
java -Dspring.cloud.consul.discovery.management-tags="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_MANAGEMENT_TAGS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.management-tags="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.metadata=
Metadata to use when registering service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.metadata
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.metadata=...
1
spring:
cloud:
consul:
discovery:
metadata: "..."
1
java -Dspring.cloud.consul.discovery.metadata="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_METADATA="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.metadata="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.order=0
Order of the discovery client used by `CompositeDiscoveryClient` for sorting available clients.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.order
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.order=0
1
spring:
cloud:
consul:
discovery:
order: "0"
1
java -Dspring.cloud.consul.discovery.order="0" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_ORDER="0"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.order="0"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.port=
Port to register the service under (defaults to listening port).
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.port
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.port=...
1
spring:
cloud:
consul:
discovery:
port: "..."
1
java -Dspring.cloud.consul.discovery.port="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_PORT="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.port="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.prefer-agent-address=false
Source of how we will determine the address to use.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.prefer-agent-address
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.prefer-agent-address=...
1
spring:
cloud:
consul:
discovery:
prefer-agent-address: "..."
1
java -Dspring.cloud.consul.discovery.prefer-agent-address="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_PREFER_AGENT_ADDRESS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.prefer-agent-address="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.prefer-ip-address=false
Use ip address rather than hostname during registration.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.prefer-ip-address
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.prefer-ip-address=...
1
spring:
cloud:
consul:
discovery:
prefer-ip-address: "..."
1
java -Dspring.cloud.consul.discovery.prefer-ip-address="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_PREFER_IP_ADDRESS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.prefer-ip-address="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.query-passing=false
Add the 'passing` parameter to /v1/health/service/serviceName. This pushes health check passing to the server.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.query-passing
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.query-passing=...
1
spring:
cloud:
consul:
discovery:
query-passing: "..."
1
java -Dspring.cloud.consul.discovery.query-passing="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_QUERY_PASSING="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.query-passing="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.register=true
Register as a service in consul.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.register
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.register=true
1
spring:
cloud:
consul:
discovery:
register: "true"
1
java -Dspring.cloud.consul.discovery.register="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_REGISTER="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.register="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.register-health-check=true
Register health check in consul. Useful during development of a service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.register-health-check
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.register-health-check=true
1
spring:
cloud:
consul:
discovery:
register-health-check: "true"
1
java -Dspring.cloud.consul.discovery.register-health-check="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_REGISTER_HEALTH_CHECK="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.register-health-check="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.scheme=http
Whether to register an http or https service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.scheme
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.scheme=http
1
spring:
cloud:
consul:
discovery:
scheme: "http"
1
java -Dspring.cloud.consul.discovery.scheme="http" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_SCHEME="http"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.scheme="http"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.server-list-query-tags=
Map of serviceId's -> tag to query for in server list. This allows filtering services by one more tags. Multiple tags can be specified with a comma separated value.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.server-list-query-tags
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.server-list-query-tags=...
1
spring:
cloud:
consul:
discovery:
server-list-query-tags: "..."
1
java -Dspring.cloud.consul.discovery.server-list-query-tags="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_SERVER_LIST_QUERY_TAGS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.server-list-query-tags="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.service-name=
Service name.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.service-name
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.service-name=...
1
spring:
cloud:
consul:
discovery:
service-name: "..."
1
java -Dspring.cloud.consul.discovery.service-name="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_SERVICE_NAME="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.service-name="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.discovery.tags=
Tags to use when registering service.
org.springframework.cloud.consul.discovery.ConsulDiscoveryProperties.
CAS Property: spring.cloud.consul.discovery.tags
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.discovery.tags=...
1
spring:
cloud:
consul:
discovery:
tags: "..."
1
java -Dspring.cloud.consul.discovery.tags="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_DISCOVERY_TAGS="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.discovery.tags="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.enabled=true
Is spring cloud consul enabled.
org.springframework.cloud.consul.ConsulProperties.
CAS Property: spring.cloud.consul.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.enabled=true
1
spring:
cloud:
consul:
enabled: "true"
1
java -Dspring.cloud.consul.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.host=localhost
Consul agent hostname. Defaults to 'localhost'.
org.springframework.cloud.consul.ConsulProperties.
CAS Property: spring.cloud.consul.host
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.host=localhost
1
spring:
cloud:
consul:
host: "localhost"
1
java -Dspring.cloud.consul.host="localhost" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_HOST="localhost"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.host="localhost"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.path=
Custom path if consul is under non-root.
org.springframework.cloud.consul.ConsulProperties.
CAS Property: spring.cloud.consul.path
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.path=...
1
spring:
cloud:
consul:
path: "..."
1
java -Dspring.cloud.consul.path="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_PATH="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.path="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.port=8500
Consul agent port. Defaults to '8500'.
org.springframework.cloud.consul.ConsulProperties.
CAS Property: spring.cloud.consul.port
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.port=8500
1
spring:
cloud:
consul:
port: "8500"
1
java -Dspring.cloud.consul.port="8500" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_PORT="8500"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.port="8500"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.retry.enabled=true
If consul retry is enabled.
org.springframework.cloud.consul.RetryProperties.
CAS Property: spring.cloud.consul.retry.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.retry.enabled=true
1
spring:
cloud:
consul:
retry:
enabled: "true"
1
java -Dspring.cloud.consul.retry.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_RETRY_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.retry.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.retry.initial-interval=1000
Initial retry interval in milliseconds.
org.springframework.cloud.consul.RetryProperties.
CAS Property: spring.cloud.consul.retry.initial-interval
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.retry.initial-interval=1000
1
spring:
cloud:
consul:
retry:
initial-interval: "1000"
1
java -Dspring.cloud.consul.retry.initial-interval="1000" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_RETRY_INITIAL_INTERVAL="1000"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.retry.initial-interval="1000"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.retry.max-attempts=6
Maximum number of attempts.
org.springframework.cloud.consul.RetryProperties.
CAS Property: spring.cloud.consul.retry.max-attempts
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.retry.max-attempts=6
1
spring:
cloud:
consul:
retry:
max-attempts: "6"
1
java -Dspring.cloud.consul.retry.max-attempts="6" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_RETRY_MAX_ATTEMPTS="6"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.retry.max-attempts="6"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.retry.max-interval=2000
Maximum interval for backoff.
org.springframework.cloud.consul.RetryProperties.
CAS Property: spring.cloud.consul.retry.max-interval
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.retry.max-interval=2000
1
spring:
cloud:
consul:
retry:
max-interval: "2000"
1
java -Dspring.cloud.consul.retry.max-interval="2000" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_RETRY_MAX_INTERVAL="2000"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.retry.max-interval="2000"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.retry.multiplier=1.1
Multiplier for next interval.
org.springframework.cloud.consul.RetryProperties.
CAS Property: spring.cloud.consul.retry.multiplier
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.retry.multiplier=1.1
1
spring:
cloud:
consul:
retry:
multiplier: "1.1"
1
java -Dspring.cloud.consul.retry.multiplier="1.1" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_RETRY_MULTIPLIER="1.1"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.retry.multiplier="1.1"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.ribbon.enabled=true
Enables Consul and Ribbon integration.
How can I configure this property?
CAS Property: spring.cloud.consul.ribbon.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.ribbon.enabled=true
1
spring:
cloud:
consul:
ribbon:
enabled: "true"
1
java -Dspring.cloud.consul.ribbon.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_RIBBON_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.ribbon.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.scheme=
Consul agent scheme (HTTP/HTTPS). If there is no scheme in address - client will use HTTP.
org.springframework.cloud.consul.ConsulProperties.
CAS Property: spring.cloud.consul.scheme
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.scheme=...
1
spring:
cloud:
consul:
scheme: "..."
1
java -Dspring.cloud.consul.scheme="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_SCHEME="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.scheme="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.service-registry.auto-registration.enabled=true
Enables Consul Service Registry Auto-registration.
How can I configure this property?
CAS Property: spring.cloud.consul.service-registry.auto-registration.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.service-registry.auto-registration.enabled=true
1
spring:
cloud:
consul:
service-registry:
auto-registration:
enabled: "true"
1
java -Dspring.cloud.consul.service-registry.auto-registration.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_SERVICE_REGISTRY_AUTO_REGISTRATION_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.service-registry.auto-registration.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.service-registry.enabled=true
Enables Consul Service Registry functionality.
How can I configure this property?
CAS Property: spring.cloud.consul.service-registry.enabled
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.service-registry.enabled=true
1
spring:
cloud:
consul:
service-registry:
enabled: "true"
1
java -Dspring.cloud.consul.service-registry.enabled="true" -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_SERVICE_REGISTRY_ENABLED="true"
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.service-registry.enabled="true"
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.tls.certificate-password=
Password to open the certificate.
org.springframework.cloud.consul.ConsulProperties$TLSConfig.
CAS Property: spring.cloud.consul.tls.certificate-password
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.tls.certificate-password=...
1
spring:
cloud:
consul:
tls:
certificate-password: "..."
1
java -Dspring.cloud.consul.tls.certificate-password="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_TLS_CERTIFICATE_PASSWORD="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.tls.certificate-password="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.tls.certificate-path=
File path to the certificate.
org.springframework.cloud.consul.ConsulProperties$TLSConfig.
CAS Property: spring.cloud.consul.tls.certificate-path
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.tls.certificate-path=...
1
spring:
cloud:
consul:
tls:
certificate-path: "..."
1
java -Dspring.cloud.consul.tls.certificate-path="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_TLS_CERTIFICATE_PATH="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.tls.certificate-path="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.tls.key-store-instance-type=
Type of key framework to use.
org.springframework.cloud.consul.ConsulProperties$TLSConfig.
CAS Property: spring.cloud.consul.tls.key-store-instance-type
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.tls.key-store-instance-type=...
1
spring:
cloud:
consul:
tls:
key-store-instance-type: "..."
1
java -Dspring.cloud.consul.tls.key-store-instance-type="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_TLS_KEY_STORE_INSTANCE_TYPE="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.tls.key-store-instance-type="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.tls.key-store-password=
Password to an external keystore.
org.springframework.cloud.consul.ConsulProperties$TLSConfig.
CAS Property: spring.cloud.consul.tls.key-store-password
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.tls.key-store-password=...
1
spring:
cloud:
consul:
tls:
key-store-password: "..."
1
java -Dspring.cloud.consul.tls.key-store-password="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_TLS_KEY_STORE_PASSWORD="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.tls.key-store-password="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
spring.cloud.consul.tls.key-store-path=
Path to an external keystore.
org.springframework.cloud.consul.ConsulProperties$TLSConfig.
CAS Property: spring.cloud.consul.tls.key-store-path
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
.properties
files:
1
spring.cloud.consul.tls.key-store-path=...
1
spring:
cloud:
consul:
tls:
key-store-path: "..."
1
java -Dspring.cloud.consul.tls.key-store-path="..." -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory. Note the placement of the system property which must be
specified before the CAS web application is launched.
1
2
3
export SPRING_CLOUD_CONSUL_TLS_KEY_STORE_PATH="..."
java -jar build/libs/cas.war
cas.war
with an embedded server container and can be found in the build/libs
directory.
1
java -jar build/libs/cas.war --spring.cloud.consul.tls.key-store-path="..."
cas.war
with an embedded server container and can be found in the build/libs
directory.
Configuration Metadata
The collection of configuration properties listed in this section are automatically generated from the CAS source and components that contain the actual field definitions, types, descriptions, modules, etc. This metadata may not always be 100% accurate, or could be lacking details and sufficient explanations.
Be Selective
This section is meant as a guide only. Do NOT copy/paste the entire collection of settings into your CAS configuration; rather pick only the properties that you need. Do NOT enable settings unless you are certain of their purpose and do NOT copy settings into your configuration only to keep them as reference. All these ideas lead to upgrade headaches, maintenance nightmares and premature aging.
YAGNI
Note that for nearly ALL use cases, declaring and configuring properties listed here is sufficient. You should NOT have to explicitly massage a CAS XML/Java/etc configuration file to design an authentication handler, create attribute release policies, etc. CAS at runtime will auto-configure all required changes for you. If you are unsure about the meaning of a given CAS setting, do NOT turn it on without hesitation. Review the codebase or better yet, ask questions to clarify the intended behavior.
Naming Convention
Property names can be specified in very relaxed terms. For instance cas.someProperty
, cas.some-property
, cas.some_property
are all valid names. While all
forms are accepted by CAS, there are certain components (in CAS and other frameworks used) whose activation at runtime is conditional on a property value, where
this property is required to have been specified in CAS configuration using kebab case. This is both true for properties that are owned by CAS as well as those
that might be presented to the system via an external library or framework such as Spring Boot, etc.
When possible, properties should be stored in lower-case kebab format, such as cas.property-name=value
.
The only possible exception to this rule is when naming actuator endpoints; The name of the
actuator endpoints (i.e. ssoSessions
) MUST remain in camelCase mode.
Settings and properties that are controlled by the CAS platform directly always begin with the prefix cas
. All other settings are controlled and provided
to CAS via other underlying frameworks and may have their own schemas and syntax. BE CAREFUL with
the distinction. Unrecognized properties are rejected by CAS and/or frameworks upon which CAS depends. This means if you somehow misspell a property definition
or fail to adhere to the dot-notation syntax and such, your setting is entirely refused by CAS and likely the feature it controls will never be activated in the
way you intend.
Validation
Configuration properties are automatically validated on CAS startup to report issues with configuration binding, specially if defined CAS settings cannot be recognized or validated by the configuration schema. Additional validation processes are also handled via Configuration Metadata and property migrations applied automatically on startup by Spring Boot and family.
Indexed Settings
CAS settings able to accept multiple values are typically documented with an index, such as cas.some.setting[0]=value
. The index [0]
is meant to be
incremented by the adopter to allow for distinct multiple configuration blocks.
Troubleshooting
To enable additional logging, configure the log4j configuration file to add the following levels:
1
2
3
4
<Logger name="org.springframework.cloud.consul" level="debug" additivity="false">
<AppenderRef ref="casConsole"/>
<AppenderRef ref="casFile"/>
</Logger>