casgo

CASGO CAS Authentication Server

What is CASGO?

Casgo is a simple to use, simple to deploy Single Sign On that uses the CAS protocol developed by Shawn Bayern of Yale University.

CAS Spec

Casgo implements version 1.0 of the CAS Specification as defined with a few key changes:

• JSON is preferred over XML/plaintext responses
• The /validate endpoint behaves as specified in CAS 1.0 (success/failure and the username of the user)
• The /validate endpoint returns user attributes

Getting started (deploying an instance of Casgo)

1. Install your database of choice (default is RethinkDB, version 2.0+)
2. Download the casgo binary for your operating system
3. Ensure port 443 is open (and your database instance is at the right port, 28015 by default)
4. Run the binary

Contributing to Casgo (setting up your local development environment)

1. Install your database of choice (default is RethinkDB, version 2.0+)
2. Install bower
3. bower install
4. Install go.rice
5. go get github.com/t3hmrman/casgo
6. make all (or go install/go build)
7. Ensure port 443 is open (and your database instance is at the right port, 28015 by default)
8. casgo

NOTE - You may have to add an exception for the included self-signed certificate

You may also find it helpful to install Gin

Running tests

1. (If using RethinkDB) Download the RethinkDB python driver
2. Run load-test-fixtures.sh to load a running RethinkDB instance with fixture data.
3. Install ginkgo and agouti
4. ginkgo -r (from the main casgo directory)

Note As some tests rely on the database to be up, RethinkDB must be running.

make test

OR

cd cas && ginkgo -r

Options

Configuration

By File

Casgo can be configured by file if you specify the -c/--config <filename> flag. See Options section for a full list of CASGO's command line options.

By ENV

Contributing

1. Fork the repo
2. Follow the instructions for contributing to Casgo
3. Fix issues, make changes
4. Run tests, ensure make targets are functional
5. Pull Request
6. Receive thanks from the community