cas README

The project's README from github.com/apereo/cas. As one markdown file: README.md.

Central Authentication Service (CAS)

License Slack Support

Introduction

Welcome to the home of the Central Authentication Service project, more commonly referred to as CAS. CAS is an enterprise multilingual identity provider and single sign-on solution for the web and attempts to be a comprehensive platform for your authentication and authorization needs.

CAS is an open and well-documented authentication protocol. The primary implementation of the protocol is an open-source Java server component by the same name hosted here, with support for a plethora of additional authentication protocols and features such as SAML2, OpenID Connect, MFA, and many more.

Contributions

Contributing Guide Open Pull Requests

If you have already identified an enhancement or a bug, it is STRONGLY recommended that you submit a pull request to address the case. There is no need for special ceremony to create separate issues. The pull request IS the issue and it will be tracked and tagged as such.

Contributors

Documentation

Version Reference
Link
Link

Additional resources are available as follows:

Getting Started

Maven Central GitHub Releases

It is recommended to deploy CAS locally using the WAR Overlay method. Cloning or downloading the CAS codebase is ONLY required if you wish to contribute to the development of the project.

We recommend that you review this page to get started with your CAS deployment.

Features

The following features are supported by the CAS project:

The foundations of CAS are built upon: Spring Boot and Spring Cloud.

Development Revved up by Develocity codecov

Support

Apereo CAS is 100% free open source software managed by Apereo, licensed under Apache v2. Our community has access to all releases of the CAS software with absolutely no costs. We welcome contributions from our community of all types and sizes. The time and effort to develop and maintain this project is dedicated by a group of volunteers and contributors. If you (or your employer) benefit from this project, please consider becoming a Friend of Apereo and contribute.

Commercial support options may be found here.

cas (apereo/cas)

openid-connect
Searching Database…

11.4K ·GitHub
What is this?CAS (Central Authentication Service) is an enterprise multilingual identity provider and single sign-on server for the web: an open-source Java platform for centralizing authentication and authorization.
Is this a library I add to my app's code, or a separate server I run?A server you deploy, not a library: your applications redirect users to CAS to log in, and it asserts their identity back to each app. This repo is that server implementation — nothing gets added into your app's codebase.
How do I actually get a CAS server up and running?Build a WAR using the recommended WAR Overlay method and run it on Apache Tomcat or Jetty, or as a Docker container. Cloning this codebase is only needed if you want to contribute to CAS itself.
Where do the usernames and passwords come from — does it force a particular user database on me?Nothing is forced: it can authenticate against JAAS, LDAP, relational databases, X.509, Radius, SPNEGO, JWT, MongoDB, Apache Cassandra and more, or delegate login to external identity providers over SAML2, OpenID Connect and OAuth.
How much work is it to keep running day to day — is there a catch?You operate the whole thing: register every application, run and scale the servers, and handle upgrades yourself. The software is free, but ongoing commercial support from Apereo is a paid extra.
Would a solo dev realistically run this for a small project, or is it built for organizations?It is built for organizations — companies, universities, anyone with many web apps that should share one login. A small personal project rarely justifies hosting a full identity platform.
Where can the server run — am I locked into Linux?It runs wherever Java runs — it is packaged for Apache Tomcat and Jetty and as Docker containers — so Linux servers are the norm, though not required. End users only ever meet it in a browser.
Is it really free to use for a commercial product?Yes — 100% free open source under Apache v2, with every release available at no cost, including for companies. Only optional commercial support from Apereo costs money.
Which SSO protocols can my applications use to talk to it?The full enterprise set: CAS v1/v2/v3, SAML v1 and v2, OAuth v2, OpenID Connect, and WS-Federation Passive Requester.
Can it require a second factor, like Duo or YubiKey?Yes — multifactor authentication is built in, with support for Duo Security, Simple MFA, YubiKey, RSA, Google Authenticator, WebAuthn FIDO2 and more.
Does it handle authorization too, or just login?Authorization is covered as well: policies can be enforced via Heimdall, OpenFGA, OPA, ABAC rules, time/date constraints, REST, or Internet2's Grouper.
Can I run several instances for high availability?Yes — clustered HA deployments are a supported scenario, with shared state in Hazelcast, JPA, Memcached, Apache Ignite, MongoDB, Redis, DynamoDB and more.
Creator
apereo
Size
350.8 MB
Stars
11.4K
Age
15y
Commits · 90 Days