mirror of
https://github.com/elyby/oauth2-server.git
synced 2024-12-23 05:29:52 +05:30
47 lines
1.5 KiB
Markdown
Executable File
47 lines
1.5 KiB
Markdown
Executable File
---
|
|
layout: default
|
|
title: Authorization server events
|
|
permalink: /authorization-server/events/
|
|
---
|
|
|
|
# Authorization server events
|
|
|
|
During the lifecycle of a request passing through the authorization server a number of events may be emitted.
|
|
|
|
You can subscribe to these events by attaching listeners to the authorization server.
|
|
|
|
To access the emitter call this method:
|
|
|
|
~~~ php
|
|
$server->getEmitter(); // returns instance of \League\Event\EmitterInterface
|
|
~~~
|
|
|
|
## client.authentication.failed
|
|
|
|
~~~ php
|
|
$server->getEmitter()->addListener(
|
|
'client.authentication.failed',
|
|
function (\League\OAuth2\Server\RequestEvent $event) {
|
|
// do something
|
|
}
|
|
);
|
|
~~~
|
|
|
|
This event is emitted when a client fails to authenticate. You might wish to listen to this event in order to ban clients that fail to authenticate after `n` number of attempts.
|
|
|
|
You can retrieve the request object that was used by calling `getRequest()` on the event object passed into your callable.
|
|
|
|
## user.authentication.failed
|
|
|
|
~~~ php
|
|
$server->getEmitter()->addListener(
|
|
'user.authentication.failed',
|
|
function (\League\OAuth2\Server\RequestEvent $event) {
|
|
// do something
|
|
}
|
|
);
|
|
~~~
|
|
|
|
This event is emitted when a user fails to authenticate. You might wish to listen to this event in order to reset passwords or ban users that fail to authenticate after `n` number of attempts.
|
|
|
|
You can retrieve the request object that was used by calling `getRequest()` on the event object passed into your callable. |