1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
/** |
4
|
|
|
* Copyright 2014 SURFnet bv |
5
|
|
|
* |
6
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License"); |
7
|
|
|
* you may not use this file except in compliance with the License. |
8
|
|
|
* You may obtain a copy of the License at |
9
|
|
|
* |
10
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0 |
11
|
|
|
* |
12
|
|
|
* Unless required by applicable law or agreed to in writing, software |
13
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS, |
14
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
15
|
|
|
* See the License for the specific language governing permissions and |
16
|
|
|
* limitations under the License. |
17
|
|
|
*/ |
18
|
|
|
|
19
|
|
|
namespace Surfnet\StepupGateway\GatewayBundle\Controller; |
20
|
|
|
|
21
|
|
|
use SAML2\Response as SAMLResponse; |
22
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Exception\InvalidArgumentException; |
23
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Exception\RequesterFailureException; |
24
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Exception\ResponseFailureException; |
25
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Exception\RuntimeException; |
26
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Saml\ResponseContext; |
27
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Service\Gateway\ConsumeAssertionService; |
28
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Service\Gateway\FailedResponseService; |
29
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Service\Gateway\LoginService; |
30
|
|
|
use Surfnet\StepupGateway\GatewayBundle\Service\Gateway\RespondService; |
31
|
|
|
use Symfony\Bundle\FrameworkBundle\Controller\Controller; |
32
|
|
|
use Symfony\Component\HttpFoundation\Request; |
33
|
|
|
use Symfony\Component\HttpFoundation\Response; |
34
|
|
|
use Symfony\Component\HttpKernel\Exception\HttpException; |
35
|
|
|
|
36
|
|
|
/** |
37
|
|
|
* Entry point for the Stepup login flow. |
38
|
|
|
* |
39
|
|
|
* See docs/GatewayState.md for a high-level diagram on how this controller |
40
|
|
|
* interacts with outside actors and other parts of Stepup. |
41
|
|
|
* |
42
|
|
|
* @SuppressWarnings(PHPMD.CouplingBetweenObjects) |
43
|
|
|
*/ |
44
|
|
|
class GatewayController extends Controller |
|
|
|
|
45
|
|
|
{ |
46
|
|
|
const RESPONSE_CONTEXT_SERVICE_ID = 'gateway.proxy.response_context'; |
47
|
|
|
const MODE_SFO = 'sfo'; |
48
|
|
|
const MODE_SSO = 'sso'; |
49
|
|
|
|
50
|
|
|
/** |
51
|
|
|
* Receive an AuthnRequest from a service provider. |
52
|
|
|
* |
53
|
|
|
* The service provider is either a Stepup component (SelfService, RA) or |
54
|
|
|
* an external service provider. |
55
|
|
|
* |
56
|
|
|
* This single sign-on action will start a new SAML request to the remote |
57
|
|
|
* IDP configured in Stepup (most likely to be an instance of OpenConext |
58
|
|
|
* EngineBlock). |
59
|
|
|
* |
60
|
|
|
* @param Request $httpRequest |
61
|
|
|
* @return \Symfony\Component\HttpFoundation\RedirectResponse|Response |
62
|
|
|
*/ |
63
|
|
|
public function ssoAction(Request $httpRequest) |
64
|
|
|
{ |
65
|
|
|
/** @var \Psr\Log\LoggerInterface $logger */ |
66
|
|
|
$logger = $this->get('logger'); |
67
|
|
|
|
68
|
|
|
$redirectBinding = $this->get('surfnet_saml.http.redirect_binding'); |
69
|
|
|
$gatewayLoginService = $this->getGatewayLoginService(); |
70
|
|
|
|
71
|
|
|
$logger->notice('Received AuthnRequest, started processing'); |
72
|
|
|
|
73
|
|
|
try { |
74
|
|
|
$proxyRequest = $gatewayLoginService->singleSignOn($httpRequest); |
75
|
|
|
} catch (RequesterFailureException $e) { |
76
|
|
|
$response = $this->getGatewayFailedResponseService()->createRequesterFailureResponse( |
77
|
|
|
$this->getResponseContext(self::MODE_SSO) |
|
|
|
|
78
|
|
|
); |
79
|
|
|
|
80
|
|
|
return $this->renderSamlResponse('consume_assertion', $response, self::MODE_SSO); |
81
|
|
|
} |
82
|
|
|
|
83
|
|
|
return $redirectBinding->createResponseFor($proxyRequest); |
84
|
|
|
} |
85
|
|
|
|
86
|
|
|
/** |
87
|
|
|
* |
88
|
|
|
*/ |
89
|
|
|
public function proxySsoAction() |
90
|
|
|
{ |
91
|
|
|
throw new HttpException(418, 'Not Yet Implemented'); |
92
|
|
|
} |
93
|
|
|
|
94
|
|
|
/** |
95
|
|
|
* Receive an AuthnResponse from an identity provider. |
96
|
|
|
* |
97
|
|
|
* The AuthnRequest started in ssoAction() resulted in an AuthnResponse |
98
|
|
|
* from the IDP. This method handles the assertion and forwards the user |
99
|
|
|
* using an internal redirect to the SecondFactorController to start the |
100
|
|
|
* actual second factor verification. |
101
|
|
|
* |
102
|
|
|
* @param Request $request |
103
|
|
|
* @return \Symfony\Component\HttpFoundation\Response |
104
|
|
|
*/ |
105
|
|
|
public function consumeAssertionAction(Request $request) |
106
|
|
|
{ |
107
|
|
|
$responseContext = $this->getResponseContext(self::MODE_SSO); |
108
|
|
|
$gatewayLoginService = $this->getGatewayConsumeAssertionService(); |
109
|
|
|
|
110
|
|
|
try { |
111
|
|
|
$gatewayLoginService->consumeAssertion($request, $responseContext); |
|
|
|
|
112
|
|
|
} catch (ResponseFailureException $e) { |
113
|
|
|
$response = $this->getGatewayFailedResponseService()->createResponseFailureResponse($responseContext); |
114
|
|
|
|
115
|
|
|
return $this->renderSamlResponse('unprocessable_response', $response, self::MODE_SSO); |
116
|
|
|
} |
117
|
|
|
|
118
|
|
|
// Forward to the selectSecondFactorForVerificationSsoAction, this in turn will forward to the correct |
119
|
|
|
// verification action (based on authentication type sso/sfo) |
120
|
|
|
return $this->forward('SurfnetStepupGatewayGatewayBundle:SecondFactor:selectSecondFactorForVerificationSso'); |
121
|
|
|
} |
122
|
|
|
|
123
|
|
|
/** |
124
|
|
|
* Send a SAML response back to the service provider. |
125
|
|
|
* |
126
|
|
|
* Second factor verification handled by SecondFactorController is |
127
|
|
|
* finished. The user was forwarded back to this action with an internal |
128
|
|
|
* redirect. This method sends a AuthnResponse back to the service |
129
|
|
|
* provider in response to the AuthnRequest received in ssoAction(). |
130
|
|
|
*/ |
131
|
|
|
public function respondAction() |
132
|
|
|
{ |
133
|
|
|
$responseContext = $this->getResponseContext(self::MODE_SSO); |
134
|
|
|
$gatewayLoginService = $this->getGatewayRespondService(); |
135
|
|
|
|
136
|
|
|
$response = $gatewayLoginService->respond($responseContext); |
|
|
|
|
137
|
|
|
$gatewayLoginService->resetRespondState($responseContext); |
|
|
|
|
138
|
|
|
|
139
|
|
|
return $this->renderSamlResponse('consume_assertion', $response, self::MODE_SSO); |
140
|
|
|
} |
141
|
|
|
|
142
|
|
|
/** |
143
|
|
|
* This action is also used from the context of SecondFactorOnly authentications |
144
|
|
|
* @param $authenticationMode |
145
|
|
|
* @return Response |
146
|
|
|
*/ |
147
|
|
|
public function sendLoaCannotBeGivenAction(Request $request) |
148
|
|
|
{ |
149
|
|
|
if (!$request->get('authenticationMode', false)) { |
150
|
|
|
throw new RuntimeException('Unable to determine the authentication mode in the sendLoaCannotBeGiven action'); |
151
|
|
|
} |
152
|
|
|
$authenticationMode = $request->get('authenticationMode'); |
153
|
|
|
$this->supportsAuthenticationMode($authenticationMode); |
154
|
|
|
$responseContext = $this->getResponseContext($authenticationMode); |
155
|
|
|
$gatewayLoginService = $this->getGatewayFailedResponseService(); |
156
|
|
|
|
157
|
|
|
$response = $gatewayLoginService->sendLoaCannotBeGiven($responseContext); |
|
|
|
|
158
|
|
|
|
159
|
|
|
return $this->renderSamlResponse('consume_assertion', $response, $authenticationMode); |
160
|
|
|
} |
161
|
|
|
|
162
|
|
|
/** |
163
|
|
|
* @return Response |
164
|
|
|
*/ |
165
|
|
|
public function sendAuthenticationCancelledByUserAction() |
166
|
|
|
{ |
167
|
|
|
// The authentication mode is read from the parent request, in the meantime a forward was followed, making |
168
|
|
|
// reading the auth mode from the current request impossible. |
169
|
|
|
// @see: \Surfnet\StepupGateway\GatewayBundle\Controller\SecondFactorController::cancelAuthenticationAction |
170
|
|
|
$requestStack = $this->get('request_stack'); |
171
|
|
|
$request = $requestStack->getParentRequest(); |
172
|
|
|
if (!$request->get('authenticationMode', false)) { |
173
|
|
|
throw new RuntimeException('Unable to determine the authentication mode in the sendAuthenticationCancelledByUser action'); |
174
|
|
|
} |
175
|
|
|
$authenticationMode = $request->get('authenticationMode'); |
176
|
|
|
|
177
|
|
|
$this->supportsAuthenticationMode($authenticationMode); |
178
|
|
|
$responseContext = $this->getResponseContext($authenticationMode); |
179
|
|
|
$gatewayLoginService = $this->getGatewayFailedResponseService(); |
180
|
|
|
|
181
|
|
|
$response = $gatewayLoginService->sendAuthenticationCancelledByUser($responseContext); |
|
|
|
|
182
|
|
|
|
183
|
|
|
return $this->renderSamlResponse('consume_assertion', $response, $authenticationMode); |
184
|
|
|
} |
185
|
|
|
|
186
|
|
|
/** |
187
|
|
|
* @param string $view |
188
|
|
|
* @param SAMLResponse $response |
189
|
|
|
* @param $authenticationMode |
190
|
|
|
* @return Response |
191
|
|
|
*/ |
192
|
|
|
public function renderSamlResponse($view, SAMLResponse $response, $authenticationMode) |
193
|
|
|
{ |
194
|
|
|
$this->supportsAuthenticationMode($authenticationMode); |
195
|
|
|
$responseContext = $this->getResponseContext($authenticationMode); |
196
|
|
|
|
197
|
|
|
return $this->render($view, [ |
198
|
|
|
'acu' => $responseContext->getDestination(), |
199
|
|
|
'response' => $this->getResponseAsXML($response), |
200
|
|
|
'relayState' => $responseContext->getRelayState() |
201
|
|
|
]); |
202
|
|
|
} |
203
|
|
|
|
204
|
|
|
/** |
205
|
|
|
* @param string $view |
206
|
|
|
* @param array $parameters |
207
|
|
|
* @param Response $response |
|
|
|
|
208
|
|
|
* @return Response |
209
|
|
|
*/ |
210
|
|
|
public function render($view, array $parameters = array(), Response $response = null): Response |
211
|
|
|
{ |
212
|
|
|
return parent::render( |
213
|
|
|
'SurfnetStepupGatewayGatewayBundle:gateway:' . $view . '.html.twig', |
214
|
|
|
$parameters, |
215
|
|
|
$response |
216
|
|
|
); |
217
|
|
|
} |
218
|
|
|
|
219
|
|
|
/** |
220
|
|
|
* @return ResponseContext |
|
|
|
|
221
|
|
|
*/ |
222
|
|
View Code Duplication |
public function getResponseContext($authenticationMode) |
|
|
|
|
223
|
|
|
{ |
224
|
|
|
switch ($authenticationMode) { |
225
|
|
|
case self::MODE_SFO: |
226
|
|
|
return $this->get($this->get('gateway.proxy.sfo.state_handler')->getResponseContextServiceId()); |
227
|
|
|
break; |
|
|
|
|
228
|
|
|
case self::MODE_SSO: |
229
|
|
|
return $this->get($this->get('gateway.proxy.sso.state_handler')->getResponseContextServiceId()); |
230
|
|
|
break; |
|
|
|
|
231
|
|
|
} |
232
|
|
|
} |
233
|
|
|
|
234
|
|
|
/** |
235
|
|
|
* @param SAMLResponse $response |
236
|
|
|
* @return string |
237
|
|
|
*/ |
238
|
|
|
private function getResponseAsXML(SAMLResponse $response) |
239
|
|
|
{ |
240
|
|
|
return base64_encode($response->toUnsignedXML()->ownerDocument->saveXML()); |
241
|
|
|
} |
242
|
|
|
|
243
|
|
|
/** |
244
|
|
|
* @return LoginService |
245
|
|
|
*/ |
246
|
|
|
private function getGatewayLoginService() |
247
|
|
|
{ |
248
|
|
|
return $this->get('gateway.service.gateway.login'); |
249
|
|
|
} |
250
|
|
|
|
251
|
|
|
/** |
252
|
|
|
* @return ConsumeAssertionService |
253
|
|
|
*/ |
254
|
|
|
private function getGatewayConsumeAssertionService() |
255
|
|
|
{ |
256
|
|
|
return $this->get('gateway.service.gateway.consume_assertion'); |
257
|
|
|
} |
258
|
|
|
|
259
|
|
|
/** |
260
|
|
|
* @return RespondService |
261
|
|
|
*/ |
262
|
|
|
private function getGatewayRespondService() |
263
|
|
|
{ |
264
|
|
|
return $this->get('gateway.service.gateway.respond'); |
265
|
|
|
} |
266
|
|
|
|
267
|
|
|
/** |
268
|
|
|
* @return FailedResponseService |
269
|
|
|
*/ |
270
|
|
|
private function getGatewayFailedResponseService() |
271
|
|
|
{ |
272
|
|
|
return $this->get('gateway.service.gateway.failed_response'); |
273
|
|
|
} |
274
|
|
|
|
275
|
|
|
private function supportsAuthenticationMode($authenticationMode) |
276
|
|
|
{ |
277
|
|
|
if (!($authenticationMode === self::MODE_SSO || $authenticationMode === self::MODE_SFO)) { |
278
|
|
|
throw new InvalidArgumentException('Invalid authentication mode requested'); |
279
|
|
|
} |
280
|
|
|
} |
281
|
|
|
} |
282
|
|
|
|
This class, trait or interface has been deprecated. The supplier of the file has supplied an explanatory message.
The explanatory message should give you some clue as to whether and when the type will be removed from the class and what other constant to use instead.