CAS Authentication for Blackboard Learn 9.1
build.properties file for settings and configuration.
Next, customize the following blackboard files by adding the lines immediately following each filename listed below, (including any leading spaces):
-C:\blackboard\system\build\bin\launch-app.bat: rem # CAS set THIRD_PARTY_CP=%THIRD_PARTY_CP%;cas-bbauth.jar set THIRD_PARTY_CP=%THIRD_PARTY_CP%;cas-client-core-3.2.1.jar set THIRD_PARTY_CP=%THIRD_PARTY_CP%;xmlsec-1.3.0.jar rem # CAS -C:\blackboard\apps\collab-server\config\wrapper.conf.bb: rem # CAS wrapper.java.classpath.43=@@bbconfig.basedir@@/systemlib/cas-bbauth.jar wrapper.java.classpath.44=@@bbconfig.basedir@@/systemlib/cas-client-core-3.2.1.jar wrapper.java.classpath.45=@@bbconfig.basedir@@/systemlib/xmlsec-1.3.0.jar rem # CAS -C:\blackboard\apps\snapshot\config\env.cmd.bb: rem # CAS set CP=%CP%;%BBLIB%\cas-bbauth.jar set CP=%CP%;%BBLIB%\cas-client-core-3.2.1.jar set CP=%CP%;%BBLIB%\xmlsec-1.3.0.jar rem # CAS -C:\blackboard\apps\content-exchange\bin\content-exchange.bat.bb: rem # CAS set CP=%CP%;%BBLIB%\cas-bbauth.jar set CP=%CP%;%BBLIB%\cas-client-core-3.2.1.jar set CP=%CP%;%BBLIB%\xmlsec-1.3.0.jar rem # CAS
You'll need an instance of Blackboard in
c:\blackboard in order to build and Apache Ant (1.8.2) to run the build.
Once you have configured everything, you can build with ant:
The init target will compile, package and deploy the CAS custom authentication module. Previous log files are also cleared out.
Next, the build will attempt to stop Blackboard services. The Blackboard
Push Config process is then executed to deploy custom changes to Blackboard.
Services are automatically restarted once the
Push Config step is done.
Push Config step resets Blackboard property files back to their default state! The build will automatically readjust the property values in files
config/authentication.properties so Blackboard can recognize the new authentication mechanism with CAS.
To log into Blackboard without using CAS SSO, append the parameter
disableCAS=1 at the end of the URL specified by
the blackboard.url property, i.e. http://blackboard.domain.edu/?disableCAS=1
Inside the logs directory of the Blackboard installation folder, you may analyze the following files to examine and troubleshoot CAS behavior (where xyz indicates the file date):
- Tomcat logs inside the tomcat directory (i.e.
- Collab server logs inside the
If you plan to upgrade Blackboard to the next service pack, etc you'll need to make sure that certain CAS changes are disabled before you run upgrade commands.
- Make sure
config/authentication.propertiesare reset to their original version.
- Remove the
Push Configto enforce the changes.
- Upgrade Blackboard and repeat the instructions. (You'll have to make the classpath adjustments above again noted in the Configuration section, as the upgrade completely resets everything)