killbond/yii2-auth

Yii 2 User Authentication & Role Based Access Control (RBAC) Module

Auth Module

Auth Module is a flexible user registration, authentication & RBAC module for Yii2. It provides user authentication, registration and RBAC support to your Yii2 site., _(*1)

Installation

The preferred way to install this extension is through composer., _(*2)

Either run, _(*3)

$ php composer.phar require killbond/yii2-auth "*"

or add, _(*4)

"killbond/yii2-auth": "*"

to the require section of your composer.json file., _(*5)

Usage

Once the extension is installed, modify your application configuration to include:, _(*6)

return [
    'modules' => [
        ...
            'auth' => [
                'class' => 'auth\Module',
                'layout' => '//homepage', // Layout when not logged in yet
                'layoutLogged' => '//main', // Layout for logged in users
                'attemptsBeforeCaptcha' => 3, // Optional
                'supportEmail' => 'support@mydomain.com', // Email for notifications
                'passwordResetTokenExpire' => 3600, // Seconds for token expiration
                'superAdmins' => ['admin'], // SuperAdmin users
                'tableMap' => [ // Optional, but if defined, all must be declared
                    'User' => 'user',
                    'UserStatus' => 'user_status',
                    'ProfileFieldValue' => 'profile_field_value',
                    'ProfileField' => 'profile_field',
                    'ProfileFieldType' => 'profile_field_type',
                ],
            ],
        ...
    ],
    ...
    'components' => [
        ...
        'authManager' => [
            'class' => '\yii\rbac\DbManager',
            'ruleTable' => 'AuthRule', // Optional
            'itemTable' => 'AuthItem',  // Optional
            'itemChildTable' => 'AuthItemChild',  // Optional
            'assignmentTable' => 'AuthAssignment',  // Optional
        ],
        'user' => [
            'class' => 'auth\components\User',
            'identityClass' => 'auth\models\User', // or replace to your custom identityClass
            'enableAutoLogin' => true,
        ],
        ...
    ]
];

And run migrations:, _(*7)

$ php yii migrate/up --migrationPath=@auth/migrations

License

Auth module is released under the BSD-3 License. See the bundled LICENSE.md for details., _(*8)

INSTALLATION

./yii migrate/up --migrationPath=@auth/migrations, _(*9)

URLs

• Login: yourhost/auth/default/login
• Logout: yourhost/auth/default/logout
• Sign-up: yourhost/auth/default/signup
• Reset Password: yourhost/auth/default/reset-password
• User management: yourhost/auth/user/index
• User profile: yourhost/auth/profile/view