class SamlController in SAML Authentication 4.x
Same name and namespace in other branches
- 8.3 src/Controller/SamlController.php \Drupal\samlauth\Controller\SamlController
- 8 src/Controller/SamlController.php \Drupal\samlauth\Controller\SamlController
- 8.2 src/Controller/SamlController.php \Drupal\samlauth\Controller\SamlController
Returns responses for samlauth module routes.
Hierarchy
- class \Drupal\Core\Controller\ControllerBase implements ContainerInjectionInterface uses LoggerChannelTrait, MessengerTrait, RedirectDestinationTrait, StringTranslationTrait
- class \Drupal\samlauth\Controller\SamlController uses ExecuteInRenderContextTrait
Expanded class hierarchy of SamlController
7 files declare their use of SamlController
- samlauth.install in ./
samlauth.install - Update and uninstall functions for the samlauth module.
- samlauth.module in ./
samlauth.module - Allows users to authenticate against an external SAML identity provider.
- SamlauthConfigureForm.php in src/
Form/ SamlauthConfigureForm.php - SamlauthMappingEditForm.php in modules/
samlauth_user_fields/ src/ Form/ SamlauthMappingEditForm.php - SamlauthMappingListForm.php in modules/
samlauth_user_fields/ src/ Form/ SamlauthMappingListForm.php
File
- src/
Controller/ SamlController.php, line 28
Namespace
Drupal\samlauth\ControllerView source
class SamlController extends ControllerBase {
use ExecuteInRenderContextTrait;
/**
* Name of the configuration object containing the setting used by this class.
*/
const CONFIG_OBJECT_NAME = 'samlauth.authentication';
/**
* The samlauth SAML service.
*
* @var \Drupal\samlauth\SamlService
*/
protected $saml;
/**
* The request stack.
*
* @var \Symfony\Component\HttpFoundation\RequestStack
*/
protected $requestStack;
/**
* The PathValidator service.
*
* @var \Drupal\Core\Path\PathValidatorInterface
*/
protected $pathValidator;
/**
* The renderer service.
*
* @var \Drupal\Core\Render\RendererInterface
*/
protected $renderer;
/**
* The token service.
*
* @var \Drupal\Core\Utility\Token
*/
protected $token;
/**
* The messenger service.
*
* @var \Drupal\Core\Messenger\MessengerInterface
*/
protected $messenger;
/**
* A logger instance.
*
* @var \Psr\Log\LoggerInterface
*/
protected $logger;
/**
* SamlController constructor.
*
* @param \Drupal\samlauth\SamlService $saml
* The samlauth SAML service.
* @param \Symfony\Component\HttpFoundation\RequestStack $request_stack
* The request stack.
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The config factory.
* @param \Drupal\Core\Path\PathValidatorInterface $path_validator
* The PathValidator service.
* @param \Drupal\Core\Render\RendererInterface $renderer
* The Renderer service.
* @param \Drupal\Core\Utility\Token $token
* The token service.
* @param \Drupal\Core\Messenger\MessengerInterface $messenger
* The messenger service.
* @param \Psr\Log\LoggerInterface $logger
* A logger instance.
*/
public function __construct(SamlService $saml, RequestStack $request_stack, ConfigFactoryInterface $config_factory, PathValidatorInterface $path_validator, RendererInterface $renderer, Token $token, MessengerInterface $messenger, LoggerInterface $logger) {
$this->saml = $saml;
$this->requestStack = $request_stack;
$this->configFactory = $config_factory;
$this->pathValidator = $path_validator;
$this->renderer = $renderer;
$this->token = $token;
$this->messenger = $messenger;
$this->logger = $logger;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container) {
return new static($container
->get('samlauth.saml'), $container
->get('request_stack'), $container
->get('config.factory'), $container
->get('path.validator'), $container
->get('renderer'), $container
->get('token'), $container
->get('messenger'), $container
->get('logger.channel.samlauth'));
}
/**
* Initiates a SAML2 authentication flow.
*
* This route does not log us in (yet); it should redirect to the Login
* service on the IdP, which should be redirecting back to our ACS endpoint
* after authenticating the user.
*
* @return \Drupal\Core\Routing\TrustedRedirectResponse
* The HTTP response to send back.
*/
public function login() {
// $function returns a string and supposedly never calls 'external' Drupal
// code... so it wouldn't need to be executed inside a render context. The
// standard exception handling does, though.
$function = function () {
return $this->saml
->login($this
->getUrlFromDestination());
};
// This response redirects to an external URL in all/common cases. We count
// on the routing.yml to specify that it's not cacheable.
return $this
->getShortenedRedirectResponse($function, 'initiating SAML login', '<front>');
}
/**
* Initiates a SAML2 logout flow.
*
* According to the SAML spec, this route does not log us out (yet); it
* should redirect to the SLS service on the IdP, which should be redirecting
* back to our SLS endpoint (possibly first logging out from other systems
* first). We do usually log out before redirecting, though.
*
* @return \Drupal\Core\Routing\TrustedRedirectResponse
* The HTTP response to send back.
*/
public function logout() {
// $function returns a string and supposedly never calls 'external' Drupal
// code... so it wouldn't need to be executed inside a render context. The
// standard exception handling does, though.
$function = function () {
return $this->saml
->logout($this
->getUrlFromDestination());
};
// This response redirects to an external URL in all/common cases. We count
// on the routing.yml to specify that it's not cacheable.
return $this
->getShortenedRedirectResponse($function, 'initiating SAML logout', '<front>');
}
/**
* Displays service provider metadata XML for iDP autoconfiguration.
*
* @return \Symfony\Component\HttpFoundation\Response
* The HTTP response to send back.
*/
public function metadata() {
$config = $this
->config(self::CONFIG_OBJECT_NAME);
try {
// Things we need to take into account:
// - The validUntil and cacheDuration properties are optional in the
// SAML spec, but the SAML PHP Toolkit always assigns values. (At the
// time of checking: "2 days into the future" and "1 week",
// respectively. No reason provided for these figures.)
// - The only info we can find so far is one hint at wiki.shibboleth.net
// MetadataManagementBestPractices: "[cacheDuration] is merely a hint
// but metadata expiration [validUntil] is absolute". This matches bug
// reports: if we send a validUntil in the past, logins stop working.
// - We want the HTTP response (with XML contents) to be cacheable
// (which, hand-wavy, means 2 things: the Drupal render cache which is
// controlled by CacheableResponse, and whatever other HTTP proxies
// there may be which are controlled by HTTP headers.) Unlike the
// SAML validUntil, we can turn this off for testing.
// - Once a cacheable response is sent, (we'll assume) we cannot purge it.
// Once any response is sent, we cannot purge data from the requester
// (IdP).
// So:
// - We must make sure no validUntil date in a cached response is ever in
// the past - i.e. it must be equal/larger than the response 'expires'
// value.
// - For configuration values, let's make the 'validUntil period'
// configurable, plus a checkbox for response caching. Let's set the
// response expiry to (validUntil - 10 seconds) to sidestep weird
// response delays.
// - For the cacheDuration value, we don't have much of an idea what is a
// good value - except, given the above defaults, it apparently doesn't
// matter much if it is a lot higher than validUntil. A cached response
// on our side could in extreme circumstances indicate a 'validUntil'
// of 10 seconds from now, and a 'cacheDuration' of a week. Is that
// bad? Apparently not, if "validUntil is absolute".
$metadata_valid = $config
->get('metadata_valid_secs') ?: Metadata::TIME_VALID;
$metadata = $this->saml
->getMetadata(time() + $metadata_valid);
// Default is TRUE for existing installs.
if ($config
->get('metadata_cache_http') ?? TRUE) {
$response = new CacheableResponse($metadata, 200, [
'Content-Type' => 'text/xml',
]);
$response
->setMaxAge($metadata_valid > 10 ? $metadata_valid - 10 : $metadata_valid);
}
else {
$response = new Response($metadata, 200, [
'Content-Type' => 'text/xml',
]);
}
} catch (\Exception $e) {
// This (invoking the exception handling that executes inside a render
// context) is an awfully convoluted way of handling the exception - but
// it reuses code and generates the redirect response in a 'protected'
// way. (Is it even useful to redirect to the front page with an error
// message? It will not help non-humans requesting the XML document. But
// humans checking this path will at least see a better hint of what's
// going on, than if we just return Drupal's plain general exception
// response. And rendering an error page without redirecting... seems too
// much effort.)
$function = function () use ($e) {
throw $e;
};
$response = $this
->getTrustedRedirectResponse($function, 'processing SAML SP metadata', '<front>');
}
return $response;
}
/**
* Performs the Attribute Consumer Service.
*
* This is usually the second step in the authentication flow; the Login
* service on the IdP should redirect (or: execute a POST request to) here.
*
* @return \Symfony\Component\HttpFoundation\Response
* The HTTP response to send back.
*/
public function acs() {
// We don't necessarily need to wrap our code in a render context: because
// our redirect is always internal, we could work with a plain
// non-cacheable RedirectResponse which will not cause a "leaked metadata"
// exception even if some code leaks metadata. But we'll use the same
// pattern as our other routes, for consistency/code reuse, and to log more
// possible 'leaky' code. We count on the routing.yml to specify the
// response is not cacheable.
$function = function () {
$ok = $this->saml
->acs();
return $this
->getRedirectUrlAfterProcessing(TRUE, !$ok);
};
return $this
->getTrustedRedirectResponse($function, 'processing SAML authentication response', '<front>');
}
/**
* Performs the Single Logout Service.
*
* This is usually the second step in the logout flow; the SLS service on the
* IdP should redirect here.
*
* @return \Symfony\Component\HttpFoundation\Response
* The HTTP response to send back.
*/
public function sls() {
$function = function () {
return $this->saml
->sls() ?: $this
->getRedirectUrlAfterProcessing();
};
// This response redirects to an external URL in most cases. (Except for
// SP-initiated logout that was initially started from this SP, i.e.
// through the logout() route). We count on the routing.yml to specify that
// it's not cacheable.
return $this
->getShortenedRedirectResponse($function, 'processing SAML single-logout response', '<front>');
}
/**
* Redirects to the 'Change Password' service.
*
* @return \Symfony\Component\HttpFoundation\RedirectResponse
* The HTTP response to send back.
*/
public function changepw() {
$function = function () {
$url = $this
->config(self::CONFIG_OBJECT_NAME)
->get('idp_change_password_service');
if (!$url) {
throw new UserVisibleException("Change password service is not available.");
}
return $url;
};
// This response is cached. (We should probably clear it from the cache
// when the configuration is changed. On a half related note: we should
// probably also have at least one 'user story' or other note about this
// endpoint. The current reason for this only being available for logged-in
// users is "v1 did it this way and there has been no reason/request to
// change it" but we don't know if this is generally applicable for IdPs.)
return $this
->getTrustedRedirectResponse($function, '', '<front>');
}
/**
* Constructs a full URL from the 'destination' parameter.
*
* Also unsets the destination parameter. This is only considered suitable
* for feeding a URL string into php-saml's login() / logout() methods.
*
* @return string|null
* The full absolute URL (i.e. our hostname plus the path in the destination
* parameter), or NULL if no destination parameter was given. This value is
* tuned to what login() / logout() expect for an input argument.
*
* @throws \Drupal\samlauth\UserVisibleException
* If the destination is disallowed.
*/
protected function getUrlFromDestination() {
$destination_url = NULL;
$request_query_parameters = $this->requestStack
->getCurrentRequest()->query;
$destination = $request_query_parameters
->get('destination');
if ($destination) {
if (UrlHelper::isExternal($destination)) {
// Disallow redirecting to an external URL after we log in.
throw new UserVisibleException("Destination URL query parameter must not be external: {$destination}");
}
$destination_url = $GLOBALS['base_url'] . '/' . $destination;
// After we return from this controller, Drupal immediately redirects to
// the path set in the 'destination' parameter (for the current URL being
// handled). We want to always redirect to the IdP instead (and only use
// $destination_url after the user gets redirected back here), so remove
// the parameter.
$request_query_parameters
->remove('destination');
}
return $destination_url;
}
/**
* Returns a URL to redirect to.
*
* This should be called only after processing an ACS/logout response.
*
* @param bool $after_acs
* (Optional) TRUE if an ACS request was just processed.
* @param bool $ignore_relay_state
* (Optional) TRUE if the RelayState parameter in the current request
* should not be used.
*
* @return \Drupal\Core\Url
* The URL to redirect to.
*/
protected function getRedirectUrlAfterProcessing($after_acs = FALSE, $ignore_relay_state = FALSE) {
if (!$ignore_relay_state) {
$relay_state = $this->requestStack
->getCurrentRequest()
->get('RelayState');
if ($relay_state) {
// We should be able to trust the RelayState parameter at this point
// because the response from the IdP was verified. Only validate general
// syntax.
if (!UrlHelper::isValid($relay_state, TRUE)) {
$this->logger
->error('Invalid RelayState parameter found in request: @relaystate', [
'@relaystate' => $relay_state,
]);
}
elseif (!preg_match('|//[^/]+/saml/log|', $relay_state)) {
$url = $relay_state;
}
}
}
if (empty($url)) {
// If no url was specified, we check if it was configured.
$url = $this
->config(self::CONFIG_OBJECT_NAME)
->get($after_acs ? 'login_redirect_url' : 'logout_redirect_url');
$url = $this->token
->replace($url);
}
if ($url) {
// We don't check access here. If a URL was explicitly specified, we
// prefer returning a 403 over silently redirecting somewhere else.
$url_object = $this->pathValidator
->getUrlIfValidWithoutAccessCheck($url);
if (empty($url_object)) {
$type = $after_acs ? 'Login' : 'Logout';
$this->logger
->warning("The {$type} Redirect URL is not a valid path; falling back to default.");
}
}
if (empty($url_object)) {
// If no url was configured, fall back to a hardcoded route.
if ($this
->currentUser()
->isAuthenticated()) {
$url_object = Url::fromRoute('entity.user.canonical', [
'user' => $this
->currentUser()
->id(),
]);
}
else {
$url_object = Url::fromRoute('<front>');
}
}
return $url_object;
}
/**
* Gets a redirect response and modifies it a bit.
*
* Split off from getTrustedRedirectResponse() because that's in a trait.
*
* @param callable $callable
* Callable.
* @param string $while
* Description of when we're doing this, for error logging.
* @param string $redirect_route_on_exception
* Drupal route name to redirect to on exception.
*/
protected function getShortenedRedirectResponse(callable $callable, $while, $redirect_route_on_exception) {
$response = $this
->getTrustedRedirectResponse($callable, $while, $redirect_route_on_exception);
// Symfony RedirectResponses set a HTML document as content, which is going
// to be ugly with our long URLs. Almost noone sees this content for a
// HTTP redirect, but still: overwrite it with a similar HTML document that
// doesn't include the URL parameter blurb in the rendered parts.
$url = $response
->getTargetUrl();
$pos = strpos($url, '?');
$shortened_url = $pos ? substr($url, 0, $pos) : $url;
// Almost literal copy from RedirectResponse::setTargetUrl():
$response
->setContent(sprintf('<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<meta http-equiv="refresh" content="0;url=%1$s" />
<title>Redirecting to %2$s</title>
</head>
<body>
Redirecting to <a href="%1$s">%2$s</a>.
</body>
</html>', htmlspecialchars($url, ENT_QUOTES, 'UTF-8'), $shortened_url));
return $response;
}
/**
* {@inheritdoc}
*
* @todo in 4.x, always throw; move our own error handling into
* AccessDeniedSubscriber. This means the situation of error_throw=TRUE
* will become standard.
* It would be nice to first do some investigation if contrib modules doing
* error redirection (customerror / error_redirect?) are mature / have good
* code, before doing this. If so, we can safely get rid of the
* 'error_redirect_url' setting and recommend installing a module if this
* functionality is needed.
*/
protected function handleExceptionInRenderContext(\Exception $exception, $default_redirect_route, $while = '') {
if ($exception instanceof TooManyRequestsHttpException) {
// If this ever happens, don't spend time on a RedirectResponse (when the
// redirected page will need to spend time rendering the page that
// includes an error message. Throwing an exception here will fall
// through to the Symfony HttpKernel - and unfortunately for us, Drupal's
// CustomPageExceptionHtmlSubscriber will intercept the response handling
// and redirect anyway, unless we intercept it first in our own
// AccessDeniedSubscriber.)
throw $exception;
}
$config = $this
->config(self::CONFIG_OBJECT_NAME);
// This config value (possibly together with 'error_redirect_url') will
// likely be removed in the 4.x version of the module - and we'll always
// throw an exception for errors. (This module's default error handling
// will then be in an event subscriber which can more easily be
// overridden. For now, explicitly set 'error_throw' if you want to
// have your own event subscriber catch handle the error on a
// KernelEvents::EXCEPTION event - see AccessDeniedSubscriber for example.)
if ($config
->get('error_throw')) {
throw new AccessDeniedHttpException($exception
->getMessage(), $exception);
}
if ($exception instanceof UserVisibleException || $config
->get('debug_display_error_details')) {
// Show the full error on screen; also log, but with lowered severity.
// Assume we don't need the "while" part for a user visible error because
// it's likely not fully correct.
$this->messenger
->addError($exception
->getMessage());
$this->logger
->warning($exception
->getMessage());
}
else {
// Use the same format for logging as Drupal's ExceptionLoggingSubscriber
// except also specify where the error was encountered. (The options for
// the "while" part are limited, so we make this part of the message
// rather than a context parameter.)
if ($while) {
$while = " while {$while}";
}
$error = Error::decodeException($exception);
unset($error['severity_level']);
$this->logger
->critical("%type encountered{$while}: @message in %function (line %line of %file).", $error);
// Don't expose the error to prevent information leakage; the user likely
// can't do much with it anyway. But hint that more details are available.
$this->messenger
->addError("Error encountered{$while}; details have been logged.");
}
// Get error URL.
$url = $config
->get('error_redirect_url');
$url_object = NULL;
if ($url) {
$url = $this->token
->replace($url);
$url_object = $this->pathValidator
->getUrlIfValidWithoutAccessCheck($url);
if (empty($url_object)) {
$this
->getLogger('samlauth')
->warning("The Error Redirect URL is not a valid path; falling back to provided route @route.", [
'@route' => $default_redirect_route,
]);
}
}
if (empty($url_object)) {
$url_object = Url::fromRoute($default_redirect_route);
}
return $url_object;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
ControllerBase:: |
protected | property | The configuration factory. | |
ControllerBase:: |
protected | property | The current user service. | 1 |
ControllerBase:: |
protected | property | The entity form builder. | |
ControllerBase:: |
protected | property | The entity type manager. | |
ControllerBase:: |
protected | property | The form builder. | 2 |
ControllerBase:: |
protected | property | The key-value storage. | 1 |
ControllerBase:: |
protected | property | The language manager. | 1 |
ControllerBase:: |
protected | property | The module handler. | 2 |
ControllerBase:: |
protected | property | The state service. | |
ControllerBase:: |
protected | function | Returns the requested cache bin. | |
ControllerBase:: |
protected | function | Retrieves a configuration object. | |
ControllerBase:: |
private | function | Returns the service container. | |
ControllerBase:: |
protected | function | Returns the current user. | 1 |
ControllerBase:: |
protected | function | Retrieves the entity form builder. | |
ControllerBase:: |
protected | function | Retrieves the entity type manager. | |
ControllerBase:: |
protected | function | Returns the form builder service. | 2 |
ControllerBase:: |
protected | function | Returns a key/value storage collection. | 1 |
ControllerBase:: |
protected | function | Returns the language manager service. | 1 |
ControllerBase:: |
protected | function | Returns the module handler. | 2 |
ControllerBase:: |
protected | function | Returns a redirect response object for the specified route. | |
ControllerBase:: |
protected | function | Returns the state storage service. | |
ExecuteInRenderContextTrait:: |
protected | function | Executes code within a render context; logs if leaked metadata is found. | |
ExecuteInRenderContextTrait:: |
protected | function | Executes code in a render context; generates a TrustedRedirectResponse. | |
LoggerChannelTrait:: |
protected | property | The logger channel factory service. | |
LoggerChannelTrait:: |
protected | function | Gets the logger for a specific channel. | |
LoggerChannelTrait:: |
public | function | Injects the logger channel factory. | |
MessengerTrait:: |
public | function | Gets the messenger. | 27 |
MessengerTrait:: |
public | function | Sets the messenger. | |
RedirectDestinationTrait:: |
protected | property | The redirect destination service. | 1 |
RedirectDestinationTrait:: |
protected | function | Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url. | |
RedirectDestinationTrait:: |
protected | function | Returns the redirect destination service. | |
RedirectDestinationTrait:: |
public | function | Sets the redirect destination service. | |
SamlController:: |
protected | property | A logger instance. | |
SamlController:: |
protected | property |
The messenger service. Overrides MessengerTrait:: |
|
SamlController:: |
protected | property | The PathValidator service. | |
SamlController:: |
protected | property | The renderer service. | |
SamlController:: |
protected | property | The request stack. | |
SamlController:: |
protected | property | The samlauth SAML service. | |
SamlController:: |
protected | property | The token service. | |
SamlController:: |
public | function | Performs the Attribute Consumer Service. | |
SamlController:: |
public | function | Redirects to the 'Change Password' service. | |
SamlController:: |
constant | Name of the configuration object containing the setting used by this class. | ||
SamlController:: |
public static | function |
Instantiates a new instance of this class. Overrides ControllerBase:: |
|
SamlController:: |
protected | function | Returns a URL to redirect to. | |
SamlController:: |
protected | function | Gets a redirect response and modifies it a bit. | |
SamlController:: |
protected | function | Constructs a full URL from the 'destination' parameter. | |
SamlController:: |
protected | function |
@todo in 4.x, always throw; move our own error handling into
AccessDeniedSubscriber. This means the situation of error_throw=TRUE
will become standard.
It would be nice to first do some investigation if contrib modules doing
error redirection… Overrides ExecuteInRenderContextTrait:: |
|
SamlController:: |
public | function | Initiates a SAML2 authentication flow. | |
SamlController:: |
public | function | Initiates a SAML2 logout flow. | |
SamlController:: |
public | function | Displays service provider metadata XML for iDP autoconfiguration. | |
SamlController:: |
public | function | Performs the Single Logout Service. | |
SamlController:: |
public | function | SamlController constructor. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 4 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |