/keycloak-cas-services

Primary LanguageJavaApache License 2.0Apache-2.0

Maven Central Build Status Quality Gate Coverage Bugs Code smells Security Rating

Keycloak CAS Services

Using as maven dependency

You can use this module as dependency in your own modules.

<dependency>
	<groupId>io.github.johnjcool</groupId>
	<artifactId>keycloak-cas-services</artifactId>
	<version>4.8.3.Final</version>
</dependency>

Manual Deployment

  1. Download keycloak version from https://www.keycloak.org/
  2. Download corresponding keycloak-cas-services version from maven central
  3. Copy keycloak-cas-services-.jar to <KEYCLOAK_INSTALLATION_DIR>/standalone/deployments
  4. Start keycloak with <KEYCLOAK_INSTALLATION_DIR>/bin/standalone.<sh|bat>
  5. Navigate to http://localhost:8080 and create an admin account

Using docker image

Start ready to use docker image:

docker run -p 8080:8080 -e KEYCLOAK_USER=admin -e KEYCLOAK_PASSWORD=xxxxxx johnjcool/keycloak-cas

Central Authentication Service Configuration

  1. Navigate to http://localhost:8080/auth/admin
  2. Login with your admin credentials
  3. Navigate to Themes Important!!! You have to do this on master realm
  4. Switch Admin Console Theme to keycloak-extended
  5. Signout
  6. Login with your admin credentials
  7. Navigate to Identity Providers
  8. Add provider CAS
  9. Configure CAS provider
  10. Click Save
  11. Navigate to Mappers to get Attributes from CAS
  12. Configure Attribute Mapper for email, firstName, lastName
  13. Signout and Central Authentication Service should be available

Optional Central Authentication Service Configuration

  1. Login with your admin credentials
  2. Navigate to Authetication
  3. Click on Actions/Config for Identity Provider Redirector
  4. Set Alias and Default Identiy Provider to cas
  5. Signout and now you are automatically redirected to CAS for Login

Have fun!