iiifx-production/yii2-secure-remember-me

Yii2 Secure RememberMe

Yii2 Secure RememberMe

Secure RememberMe - расширение для фреймворка Yii2, реализующее безопасный способ RememberMe-аутентификации по токену в Cookie., _(*1)

Установка

Используя Composer:, _(*2)

``` bash $ composer require "iiifx-production/yii2-secure-remember-me", <sub>(*3)</sub>

## Миграции

Выполнить в консоли:

``` bash
$ php yii migrate --migrationPath=@vendor/iiifx-production/yii2-secure-remember-me/source/migrations

Настройка

Прописать в конфигурации config/main.php:, <sub>(*4)</sub>

``` php 'bootstrap' => [, <sub>(*5)</sub>

    /* ... */

    'rememberMe', # Добавляем к загрузочным компонентам приложения
],

'components' => [
    'rememberMe' => [ # Добавляем компонент в приложение
        'class' => 'iiifx\yii2\SecureRememberMe\components\Manager',
        # Конфигурация компонента
        'cookieKey' => 'remember-me', # Имя Cookie параметра
        'lifetime' => 2592000, # Время жизни токена, в секундах
        'userClass' => 'common\models\User', # Класс пользователя, который используется в приложении
    ],

    /* ... */

],

## Использование

### Пример подключения расширения к **[Yii2 Advanced Template](https://github.com/yiisoft/yii2-app-advanced)**.

Вносим изменения в логику входа([LoginForm::login()](https://github.com/yiisoft/yii2-app-advanced/blob/master/common/models/LoginForm.php#L56)):

``` php
    /**
     * Logs in a user using the provided username and password.
     *
     * @return boolean whether the user is logged in successfully
     */
    public function login ()
    {
        if ( $this->validate() ) {
            if ( Yii::$app->user->login( $this->getUser() ) ) {

                # Если разрешен RememberMe пользователем
                if ( $this->rememberMe ) {
                    /** @var \iiifx\yii2\SecureRememberMe\components\Manager $rememberMe */
                    $rememberMe = Yii::$app->rememberMe;
                    # Создаем токен для пользователя
                    $rememberMe->create( $this->_user->id );
                }
                return TRUE;

            }
        }
        return FALSE;
    }

И добавляем удаление токена при выходе(SiteController::actionLogout()):, <sub>(*6)</sub>

``` php /** * Logs out the current user. * * @return mixed */ public function actionLogout() { Yii::$app->user->logout();, <sub>(*7)</sub>

    /** @var \iiifx\yii2\SecureRememberMe\components\Manager $rememberMe */
    $rememberMe = Yii::$app->rememberMe;
    $rememberMe->delete();

    return $this->goHome();
}

```, <sub>(*8)</sub>

Проверка, аутентификация по токену и его регенерация происходит автоматически., <sub>(*9)</sub>

Все. Компонент готов к работе., <sub>(*10)</sub>

Тесты

@TODO, <sub>(*11)</sub>

Лицензия

, <sub>(*12)</sub>