vjAuthPlugin
=================

The `vjAuthPlugin` packages authentification using Active Directory and Single Sign On (SSO) with NTLM protocol if activated.

Installation
------------

  * Install the plugin

        $ symfony plugin:install vjAuthPlugin

  * Clear the cache

        $ symfony cache:clear

Secure your application
-------------

To secure a symfony application:

  * Enable the module vjAuthPlugin in settings.yml

         all:
           .settings:
             enabled_modules: [..., vjAuthPlugin]

  * Change the default login modules in settings.yml

          login_module:           vjAuthLogin
          login_action:           index

  * Secure some modules or your entire application in security.yml

          default:
            is_secure: on

  * Secure some modules or your entire application in security.yml

          all:          
            ad:
              options:   # theses options are usefull for the adldap class, the documentation is online
                account_suffix:            '@mysite.fr'
                base_dn:                   'DC=mysite,DC=fr'
                domain_controllers:        [ "myDC1.mysite.fr", "myDC2.mysite.fr" ]
                ad_username:               'username_administrator_active_directory'
                ad_password:               'password_administrator_active_directory'
                recursive_groups:          false
              group_prefix:                PREFIX_
              group_authorize:             GROUP     # the real name of the group authorize to use the application is : PREFIX_GROUP
              ntlm_active:                 true      # if ntlm activated, autologon with the windows username (there are some issues with the NTLM protocol, I'll documente how to solve them soon)

Forms
-----

  * vjAuthFormLogin: A form to authenticate the user with his Active Directory's Username and Password
  
Informations
-----

There is no test. I'll write some soon.

I don't include CSS files because mine are very linked with my application and everybody don't like pink :)

This plugin is only available in french. I won't internationalize it.

The files impacted with french are : 

  * lib/AuthUser.class.php 

          $this->setCulture('fr');

  * lib/form/doctrine/vjAuthFormLogin.class

  * modules/vjAuthLogin/actions/actions.class.php 

  * modules/vjAuthLogin/templates/indexSuccess.php 

  * modules/vjAuthLogin/config/view.yml 
  
TODO
-----

  * write tests
  
  * write more documentation
  
  * write documentation about NTLM issues
  
  * integrate CSS files
  
  * any idea, advice, other ? please email me :)