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.
Scripting with Apache Groovy
Apache Groovy is a powerful, optionally typed and dynamic language, with static-typing and static compilation capabilities, for the Java platform aimed at improving developer productivity thanks to a concise, familiar and easy to learn syntax.
Support is enabled by including the following module in the WAR overlay:
1
2
3
4
5
<dependency>
<groupId>org.apereo.cas</groupId>
<artifactId>cas-server-core-scripting</artifactId>
<version>${cas.version}</version>
</dependency>
1
implementation "org.apereo.cas:cas-server-core-scripting:${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-core-scripting"
}
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-core-scripting"
}
![:information_source: :information_source:](https://github.githubassets.com/images/icons/emoji/unicode/2139.png)
Remember to include the above module in your CAS build if you intend to implement any sort of behavior with Apache Groovy and scripting. This includes evaluating policies, release attributes, modifying or customizing components, etc. Without the listed above module, Apache Groovy functionality and libraries will not be pulled into your CAS project and CAS would most likely fail to deliver at runtime.
CAS takes advantage of Apache Groovy in forms of either embedded or external scripts that allow one to, by default, dynamically build constructs, attributes, access strategies and a lot more.
As an example, the following construct is what’s referred to in CAS as an embedded or inline Groovy script:
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"@class": "org.apereo.cas.services.CasRegisteredService",
"serviceId": "^https://example.app.org/login",
"name": "Sample",
"id": 1,
"attributeReleasePolicy" : {
"@class" : "org.apereo.cas.services.ReturnMappedAttributeReleasePolicy",
"allowedAttributes" : {
"@class" : "java.util.TreeMap",
"name" : "groovy { return ['casuser'] }"
}
}
}
By default, all such scripts are evaluated and executed dynamically using the Groovy meta object protocol. There is also support for the
alternative that allows CAS to tune the Groovy compiler for static compilation. In this mode, all methods, properties, files,
inner classes, etc. found in scripts will be type checked. If you wish to always compile Groovy scripts using CompileStatic
,
you may specify the following system property when you run CAS:
1
-Dorg.apereo.cas.groovy.compile.static=true
When CAS runs in CompileStatic
mode, Groovy scripts most likely will need to be rewritten to remove all dynamic constructs.
For example, the following Groovy script is one that uses dynamic/meta aspects of the Groovy programming language:
1
2
3
4
5
if (attributes['entitlement'].contains('admin')) {
return [attributes['uid'].get(0).toUpperCase()]
} else {
return attributes['identifier']
}
The same script in CompileStatic
mode would be rewritten as:
1
2
3
4
5
6
def attributes = (Map) binding.getVariable('attributes')
if ((attributes.get('entitlement') as List).contains('admin')) {
return [(attributes['uid'] as List).get(0).toString().toUpperCase()]
} else {
return attributes['identifier'] as List
}