dmstr / yii2-usuario-ldap-extension
Permantent fork from yetopen/yii2-usuario-ldap
Installs: 2 988
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 6
Forks: 1
Open Issues: 0
Type:yii2-extension
Requires
- 2amigos/yii2-usuario: ~1.0
- adldap2/adldap2: ~9.1.2
- yiisoft/yii2: ~2.0.0
This package is auto-updated.
Last update: 2024-10-13 14:33:47 UTC
README
An yii2 extension to authenticate and/or syncronize users against LDAP for 2amigos/yii2-usuario.
Installation
The preferred way to install this extension is through composer.
Either run:
php composer.phar require --prefer-dist dmstr/yii2-usuario-ldap-extension "*"
or add
"dmstr/yii2-usuario-ldap-extension": "*"
to the require section of your composer.json
file.
Configuration
Add in your config (config/web.php
for the basic app):
//... 'bootstrap' => ['log', 'usuarioLdap'], //... 'components' => [ //... 'usuarioLdap' => [ 'class' => 'yetopen\usuarioLdap\UsuarioLdapComponent', 'ldapConfig' => [ 'hosts' => ['host.example.com'], 'base_dn' => 'dc=mydomain,dc=local', 'account_prefix' => 'cn=', 'account_suffix' => ',ou=Users,dc=mydomain,dc=local', 'use_ssl' => true, 'username' => 'bind_username', 'password' => 'bind_password', ], 'createLocalUsers' => TRUE, 'defaultRoles' => ['standardUser'], 'syncUsersToLdap' => TRUE, 'secondLdapConfig' => [ 'hosts' => ['host.example.com'], 'base_dn' => 'dc=mydomain,dc=local', 'account_prefix' => 'cn=', 'account_suffix' => ',ou=Users,dc=mydomain,dc=local', 'username' => 'bind_username', 'password' => 'bind_password', ], 'allowPasswordRecovery' => FALSE, 'passwordRecoveryRedirect' => ['/controller/action'] ], //... ]
adapting parameters to your setup.
Configuration options
- ldapConfig: all the parameters for connecting to LDAP server as documented in Adldap2
- createLocalUsers: if TRUE when a user successfully authenticate against the first LDAP server is created locally in Yii database. If FALSE a default users with ID specified in
defaultUserId
is used for the session - defaultRoles: if specified the role/s will be assigned to the users created by the extension. Can be set as an array. Default to FALSE
- secondLdapConfig: if specified this is used as LDAP server for sync the local users, if not specified this is equal to ldapConfig
- syncUsersToLdap: if TRUE changes to local users are synchronized to the second LDAP server. This includes creation and deletion of an user
- defaultUserId: if
createLocalUsers
is set to FALSE must contain the ID of an user to be used as local. Defaults to-1
- allowPasswordRecovery: if TRUE it will enable password recovery process, otherwise it will redirect the LDAP users to the url specified in
passwrdRecoveryRedirect
. Defaults to FALSE. - passwordRecoveryRedirect: when
allowPasswordRecovery
is set to FALSE specifies the URL where the user will be redirected when trying to recover the password. This parameter will be processed by yii\helpers\Url::to().