1 | <?php |
||
16 | class Authorization implements MiddlewareInterface |
||
17 | { |
||
18 | /** |
||
19 | * OAuth2 Server |
||
20 | * |
||
21 | * @var OAuth2\Server |
||
22 | */ |
||
23 | private $server; |
||
24 | |||
25 | /** |
||
26 | * Array of scopes required for authorization. |
||
27 | * |
||
28 | * @var array |
||
29 | */ |
||
30 | private $scopes; |
||
31 | |||
32 | /** |
||
33 | * Container for token. |
||
34 | * |
||
35 | * @var ArrayAccess|ContainerInterface |
||
36 | */ |
||
37 | private $container; |
||
38 | |||
39 | /** |
||
40 | * Create a new instance of the Authroization middleware. |
||
41 | * |
||
42 | * @param OAuth2\Server $server The configured OAuth2 server. |
||
43 | * @param ArrayAccess|ContainerInterface $container A container object in which to store the token from the |
||
44 | * request. |
||
45 | * @param array $scopes Scopes required for authorization. $scopes can be given as an |
||
46 | * array of arrays. OR logic will use with each grouping. |
||
47 | * Example: |
||
48 | * Given ['superUser', ['basicUser', 'aPermission']], the request |
||
49 | * will be verified if the request token has 'superUser' scope |
||
50 | * OR 'basicUser' and 'aPermission' as its scope. |
||
51 | * |
||
52 | * @throws \InvalidArgumentException Thrown if $container is not an instance of ArrayAccess or ContainerInterface. |
||
53 | */ |
||
54 | public function __construct(OAuth2\Server $server, $container, array $scopes = []) |
||
66 | |||
67 | /** |
||
68 | * Execute this middleware. |
||
69 | * |
||
70 | * @param ServerRequestInterface $request The PSR7 request. |
||
71 | * @param ResponseInterface $response The PSR7 response. |
||
72 | * @param callable $next The Next middleware. |
||
73 | * |
||
74 | * @return ResponseInterface |
||
75 | */ |
||
76 | public function __invoke(ServerRequestInterface $request, ResponseInterface $response, callable $next) |
||
94 | |||
95 | /** |
||
96 | * Helper method to set the token value in the container instance. |
||
97 | * |
||
98 | * @param array $token The token from the incoming request. |
||
99 | * |
||
100 | * @return void |
||
101 | */ |
||
102 | private function setToken(array $token) |
||
111 | |||
112 | /** |
||
113 | * Returns a callable function to be used as a authorization middleware with a specified scope. |
||
114 | * |
||
115 | * @param array $scopes Scopes require for authorization. |
||
116 | * |
||
117 | * @return Authorization |
||
118 | */ |
||
119 | public function withRequiredScope(array $scopes) |
||
125 | |||
126 | /** |
||
127 | * Helper method to ensure given scopes are formatted properly. |
||
128 | * |
||
129 | * @param array $scopes Scopes required for authorization. |
||
130 | * |
||
131 | * @return array The formatted scopes array. |
||
132 | */ |
||
133 | private function formatScopes(array $scopes) |
||
150 | } |
||
151 |
Let’s take a look at an example:
In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different implementation of User which does not have a getDisplayName() method, the code will break.
Available Fixes
Change the type-hint for the parameter:
Add an additional type-check:
Add the method to the interface: