dcs/security-auth-form-bundle

The DCSSecurityAuthFormBundle provides an authentication system using the login form

dev-master / 1.0.x-dev 2016-12-03 08:02 UTC

Requires

• php: >=5.3.9
• symfony/form: ~2.8|~3
• symfony/security-bundle: ~2.8|~3

Requires (Dev)

• dcs/security-core-bundle: ~1.0@dev
• phpunit/phpcov: 3.*
• phpunit/phpunit: ^5
• satooshi/php-coveralls: ~1.0
• symfony/framework-bundle: ~2.8|~3

MIT

• Damiano Ciarla

• security
• form
• login
• DCS

README

DCSSecurityAuthFormBundle

This bundle provides a login form for the DCSSecurityCoreBundle.

The DCSSecurityAuthFormBundle uses the dcs_security.core.authentication.provider service to implement a custom security firewall called dcs_form.

Installation

Prerequisites

This bundle requires DCSSecurityCoreBundle.

Require the bundle

Run the following command:

$ composer require dcs/security-auth-form-bundle "~1.0@dev"

Composer will install the bundle to your project's vendor/dcs/security-auth-form-bundle directory.

Enable the bundle

Enable the bundle in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
	$bundles = array(
		// ...
		new DCS\Security\Auth\FormBundle\DCSSecurityAuthFormBundle(),
		// ...
	);
}

Configure your application's security.yml

In order for Symfony's security component to use the DCSSecurityAuthFormBundle, you must tell it to do so in the security.yml file. Below is a minimal example of the configuration necessary to use this bundle in your application:

security:
    encoders:
        DCS\User\CoreBundle\Model\User: bcrypt

    role_hierarchy:
        ROLE_ADMIN: ROLE_USER

    providers:
        dcs_user:
            id: dcs_security.core.provider.user

    firewalls:
        main:
            pattern: ^/
            dcs_form:
                provider: dcs_user
                csrf_token_generator: security.csrf.token_manager
                login_path: dcs_security_login
                check_path: dcs_security_login_check
            logout:
                path: dcs_security_logout
                target: /
            anonymous: ~

    access_control:
        - { path: ^/login, roles: IS_AUTHENTICATED_ANONYMOUSLY }

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.