RememberMeServicesInterface
интерфейс RememberMeServicesInterface
Интерфейс, который нужно реализовать классам, предоставляющим возможности сохранения состояния входа в систему.
Мы предоставляем две реализации из коробки: - TokenBasedRememberMeServices (не требует TokenProvider) - PersistentTokenBasedRememberMeServices (требует TokenProvider)
Постоянные значения
| COOKIE_ATTR_NAME | Это имя атрибута может быть использовано реализацией, если ей нужно установить cookie в запросе, когда еще нет ответа. |
Методы
| TokenInterface | autoLogin(Request $request) Этот метод будет вызываться всякий раз, когда объект TokenStorage не содержит объект TokenInterface, и фреймворк хочет предоставить реализацию возможности аутентификации запроса с использованием возможностей сохранения состояния входа в систему. | |
| loginFail(Request $request) Вызывается всякий раз, когда была предпринята попытка интерактивной аутентификации, но предоставленные пользователем учетные данные отсутствовали или были недействительными. | ||
| loginSuccess(Request $request, Response $response, TokenInterface $token) Вызывается всякий раз, когда попытка интерактивной аутентификации завершается успешно (например, вход в систему через форму). |
Подробности
TokenInterface autoLogin(Request $request)
Этот метод будет вызываться всякий раз, когда объект TokenStorage не содержит объект TokenInterface, и фреймворк хочет предоставить реализацию возможности аутентификации запроса с использованием возможностей сохранения состояния входа в систему.
Никаких попыток определить, запросил ли браузер службы сохранения состояния входа в систему или представил действительный cookie, не делается. Все такие определения оставляются на усмотрение реализации этого метода.
Если браузер представил несанкционированный cookie по какой-либо причине, убедитесь, что выбросите исключение AuthenticationException, так как это приведет к вызову loginFail() и, следовательно, к аннулированию cookie.
Параметры
| Request | $request |
Возвращаемое значение
| TokenInterface |
loginFail(Request $request)
Вызывается всякий раз, когда была предпринята попытка интерактивной аутентификации, но предоставленные пользователем учетные данные отсутствовали или были недействительными.
Этот метод должен позаботиться об аннулировании cookie.
Параметры
| Request | $request |
loginSuccess(Request $request, Response $response, TokenInterface $token)
Вызывается всякий раз, когда попытка интерактивной аутентификации завершается успешно (например, вход в систему через форму).
Реализация может всегда установить cookie сохранения состояния входа в систему в ответе, хотя это не рекомендуется.
Вместо этого, реализации обычно должны искать параметр запроса (например, параметр HTTP POST), который указывает, что браузер явно запросил сохранение аутентификации.
Параметры
| Request | $request | |
| Response | $response | |
| TokenInterface | $token |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Security/Http/RememberMe/RememberMeServicesInterface.html