Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexandre-t/casguard
PhpCas Bundle using guard authentication for symfony 3.4, 4.4 and 5.0
https://github.com/alexandre-t/casguard
cas guard phpcas-bundle symfony symfony-bundle symfony3 symfony4 symfony5
Last synced: about 1 month ago
JSON representation
PhpCas Bundle using guard authentication for symfony 3.4, 4.4 and 5.0
- Host: GitHub
- URL: https://github.com/alexandre-t/casguard
- Owner: Alexandre-T
- License: mit
- Created: 2017-09-29T06:04:47.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-09-08T21:20:15.000Z (about 3 years ago)
- Last Synced: 2024-09-30T16:02:57.572Z (about 2 months ago)
- Topics: cas, guard, phpcas-bundle, symfony, symfony-bundle, symfony3, symfony4, symfony5
- Language: PHP
- Homepage:
- Size: 93.8 KB
- Stars: 9
- Watchers: 7
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: Security/CasAuthenticator.php
Awesome Lists containing this project
README
Php CAS Bundle
==============
PhpCas Bundle provide CAS Authentication using guard for symfony 3.4+ and 4.
This bundle **DO NOT** provide a CAS server. By using this bundle, your application will be able to use your Cas Server
to authenticate your users.
[](https://insight.symfony.com/projects/cb0f5515-dc7a-4295-9faa-83e81fc1e23b)
[](https://coveralls.io/github/Alexandre-T/casguard?branch=master)
[](https://travis-ci.org/Alexandre-T/casguard)
Installation
============
Step 1: Download the Bundle
---------------------------
Open a command console, enter your project directory and execute the
following command to download the latest stable version of this bundle:
```console
$ composer require "alexandret/phpcas-guard-bundle" "~1"
```
This command requires you to have Composer installed globally, as explained
in the [installation chapter](https://getcomposer.org/doc/00-intro.md)
of the Composer documentation.
Step 2: Enable the Bundle
-------------------------
Enable the bundle by adding it to the list of registered bundles
in the `config/bundles.php` file of your project:
```php
['all' => true],
];
```
Step 3: Enable the Security
----------------------------
Update your `config\packages\security.yaml` file:
```yaml
#http://symfony.com/doc/current/reference/configuration/security.html#full-default-configuration
security:
# ...
firewalls:
#Main firewall
main:
# We use Guard !
guard:
authenticators:
# ADD the cas authenticator declared in this bundle
- phpcasguard.cas_authenticator
# The logout path
logout:
# This route will be never called because of listener. It will catch it and redirect user.
path: /logout
# ADD the same cas authenticator declared in this bundle to activate logout function
success_handler: phpcasguard.cas_authenticator
# ...
```
Since Symfony 2.8, Guard is providing a new and excellent way to authenticate. I recommend you to have a look
on [this excellent tutorial](https://knpuniversity.com/screencast/symfony-security) to understand guard features.
This tutorial explains how to generate a standard authentication using **guard** and a **login form**. When you
understand it, you only have to disable the call to the login form authenticator implemented in
[the chapter 5](https://knpuniversity.com/screencast/symfony-security/login-form-authenticator) and replace it by
the `phpcasguard.cas_authenticator` declared inside this bundle.
Step 4: Configure the Bundle
----------------------------
Create a `config\packages\cas_guard.yaml` file:
```yaml
cas_guard:
hostname: '%env(CAS_HOSTNAME)%'
# ...
```
Have a look on the [complete configuration](./Resources/doc/configuration.md) file to complete and
connect it with your CAS server.