Spec-Zone.ru › Symfony 3.4

RememberMeServicesInterface

интерфейс RememberMeServicesInterface

Интерфейс, который необходимо реализовать классам, предоставляющим возможности «запомнить меня».

Мы предоставляем две реализации «из коробки»: - TokenBasedRememberMeServices (не требует TokenProvider) - PersistentTokenBasedRememberMeServices (требует TokenProvider)

Константы

COOKIE_ATTR_NAME

Это имя атрибута может использоваться реализацией, если ей необходимо установить cookie в запросе, когда фактического ответа еще нет.

Методы

TokenInterface autoLogin(Request $request)

Этот метод вызывается всякий раз, когда объект TokenStorage не содержит объект TokenInterface, и фреймворк хочет предоставить реализацию с возможностью аутентификации запроса с использованием возможностей «запомнить меня».

loginFail(Request $request, Exception $exception = null)

Вызывается всякий раз, когда была предпринята попытка интерактивной аутентификации, но предоставленные пользователем учетные данные отсутствовали или были недействительными.

loginSuccess(Request $request, Response $response, TokenInterface $token)

Вызывается всякий раз, когда попытка интерактивной аутентификации успешна (например, при входе в систему через форму).

Подробности

TokenInterface autoLogin(Request $request)

Этот метод будет вызван всякий раз, когда объект TokenStorage не содержит объект TokenInterface, и фреймворк желает предоставить реализацию с возможностью аутентификации запроса с использованием возможностей «запомнить меня».

Никаких попыток определить, запросил ли браузер услуги «запомнить меня» или представил действительный cookie, не предпринимается. Все такие определения оставляются на усмотрение реализации этого метода.

Если браузер представил несанкционированный cookie по какой-либо причине, убедитесь, что выбросили исключение AuthenticationException, так как это в конечном итоге приведет к вызову loginFail() и, следовательно, к аннулированию cookie.

Параметры

Request $request

Возвращаемое значение

TokenInterface

loginFail(Request $request, Exception $exception = null)

Вызывается всякий раз, когда была предпринята попытка интерактивной аутентификации, но предоставленные пользователем учетные данные отсутствовали или были недействительными.

Этот метод должен позаботиться об аннулировании cookie.

Параметры

Request $request
Exception $exception

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/3.4/Symfony/Component/Security/Http/RememberMe/RememberMeServicesInterface.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API