documize/domain/auth/cas/README.md

# Authenticating with Aperao CAS

## Introduction

Documize can delegate user authentication to aperao CAS integration.

This document assumes that the Documize administrator has installed and is familiar with CAS server.

https://www.apereo.org/projects/cas

Documize is tested against the CAS version 5.3.x.

## Run a CAS server

Refer to the following like [https://apereo.github.io/cas/5.0.x/installation/Docker-Installation.html](https://apereo.github.io/cas/5.0.x/installation/Docker-Installation.html) to run CAS server. Usually the server address is `https://localhost:8443/cas".

## Configuring Documize

CAS authentication is configured and enabled from Settings.

Type in the CAS Server URL, Redirect URL.

* **CAS Server URL**: The CAS host address, eg: `https://localhost:8443/cas`
* **Redirect URL**: The CAS authorize callback URL. If your documize URL is `https://example.documize.com,` then redirect URL is `https://example.documize.com/auth/cas`.
Get firstname and lastname from CAS attributes 2019-08-17 22:13:37 +08:00			`# Authenticating with Aperao CAS`

			`## Introduction`

			`Documize can delegate user authentication to aperao CAS integration.`

			`This document assumes that the Documize administrator has installed and is familiar with CAS server.`

			`https://www.apereo.org/projects/cas`

			`Documize is tested against the CAS version 5.3.x.`

add run cas server section 2019-08-21 23:25:12 +08:00			`## Run a CAS server`

			Refer to the following like [https://apereo.github.io/cas/5.0.x/installation/Docker-Installation.html](https://apereo.github.io/cas/5.0.x/installation/Docker-Installation.html) to run CAS server. Usually the server address is `https://localhost:8443/cas".

Get firstname and lastname from CAS attributes 2019-08-17 22:13:37 +08:00			`## Configuring Documize`

			`CAS authentication is configured and enabled from Settings.`

			`Type in the CAS Server URL, Redirect URL.`

add run cas server section 2019-08-21 23:25:12 +08:00			* CAS Server URL: The CAS host address, eg: `https://localhost:8443/cas`
Get firstname and lastname from CAS attributes 2019-08-17 22:13:37 +08:00			* Redirect URL: The CAS authorize callback URL. If your documize URL is `https://example.documize.com,` then redirect URL is `https://example.documize.com/auth/cas`.