Cas30Controller::samlValidate() - Code Metrics - Inspection of "SSP-2066_add_routes_and_controllers" - simplesamlphp/simplesamlphp-module-casserver - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — master (#45)

unknown

created 2024-12-15 07:53 UTC

Cas30Controller::samlValidate() B

↳ Parent: Cas30Controller

Complexity

Conditions	8
Paths	7

Size

Total Lines	58
Code Lines	30

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
eloc	30
c	1
b	0
f	0
dl	0
loc	58
rs	8.1954
cc	8
nc	7
nop	2

How to fix Long Method

<?php

declare(strict_types=1);

namespace SimpleSAML\Module\casserver\Controller;

use SimpleSAML\Configuration;
use SimpleSAML\Logger;
use SimpleSAML\Module\casserver\Cas\Protocol\Cas20;
use SimpleSAML\Module\casserver\Cas\Protocol\SamlValidateResponder;
use SimpleSAML\Module\casserver\Cas\TicketValidator;
use SimpleSAML\Module\casserver\Controller\Traits\UrlTrait;
use SimpleSAML\Module\casserver\Http\XmlResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Attribute\AsController;
use Symfony\Component\HttpKernel\Attribute\MapQueryParameter;

#[AsController]
class Cas30Controller
{
    use UrlTrait;


    /** @var Logger */
    protected Logger $logger;

    /** @var Configuration */
    protected Configuration $casConfig;

    /** @var Cas20 */
    protected Cas20 $cas20Protocol;

    /** @var TicketValidator */
    protected TicketValidator $ticketValidator;

    /** @var SamlValidateResponder */
    protected SamlValidateResponder $validateResponder;

    /**
     * @param   Configuration       $sspConfig
     * @param   Configuration|null  $casConfig
     *
     * @throws \Exception
     */
    public function __construct(
        private readonly Configuration $sspConfig,
        Configuration $casConfig = null,
        TicketValidator $ticketValidator = null,
    ) {
        // We are using this work around in order to bypass Symfony's autowiring for cas configuration. Since
        // the configuration class is the same, it loads the ssp configuration twice. Still, we need the constructor
        // argument in order to facilitate testin.
        $this->casConfig = ($casConfig === null || $casConfig === $sspConfig)
            ? Configuration::getConfig('module_casserver.php') : $casConfig;
        $this->cas20Protocol = new Cas20($this->casConfig);
        $this->ticketValidator   = $ticketValidator ?? new TicketValidator($this->casConfig);
        $this->validateResponder = new SamlValidateResponder();
    }


    /**
     * POST /casserver/samlValidate?TARGET=
     * Host: cas.example.com
     * Content-Length: 491
     * Content-Type: text/xml
     *
     * @param   Request  $request
     * @param   string   $TARGET  URL encoded service identifier of the back-end service.
     *
     * @throws \RuntimeException
     * @return XmlResponse
     * @link https://apereo.github.io/cas/7.1.x/protocol/CAS-Protocol-Specification.html#42-samlvalidate-cas-30
     */
    public function samlValidate(
        Request $request,
        #[MapQueryParameter] string $TARGET,
    ): XmlResponse {
        // From SAML2\SOAP::receive()
        $postBody = $request->getContent();
        if (empty($postBody)) {
            throw new \RuntimeException('samlValidate expects a soap body.');
        }

        // SAML request values
        //
        // samlp:Request
        //  - RequestID [REQUIRED] - unique identifier for the request
        //  - IssueInstant [REQUIRED] - timestamp of the request
        // samlp:AssertionArtifact [REQUIRED] - the valid CAS Service

        $ticketParser = xml_parser_create();
        xml_parser_set_option($ticketParser, XML_OPTION_CASE_FOLDING, 0);
        xml_parser_set_option($ticketParser, XML_OPTION_SKIP_WHITE, 1);
        xml_parse_into_struct($ticketParser, $postBody, $values, $tags);
        xml_parser_free($ticketParser);

        // Check for the required saml attributes
        $samlRequestAttributes = $values[ $tags['samlp:Request'][0] ]['attributes'];
        if (!isset($samlRequestAttributes['RequestID'])) {
            throw new \RuntimeException('Missing RequestID samlp:Request attribute.');
        } elseif (!isset($samlRequestAttributes['IssueInstant'])) {
            throw new \RuntimeException('Missing IssueInstant samlp:Request attribute.');
        }

        if (
            !isset($tags['samlp:AssertionArtifact'])
            || empty($values[$tags['samlp:AssertionArtifact'][0]]['value'])
        ) {
            throw new \RuntimeException('Missing ticketId in AssertionArtifact');
        }

        $ticketId = $values[$tags['samlp:AssertionArtifact'][0]]['value'];
        Logger::debug('samlvalidate: Checking ticket ' . $ticketId);

        try {
            // validateAndDeleteTicket might throw a CasException. In order to avoid third party modules
            // dependencies, we will catch and rethrow the Exception.
            $ticket = $this->ticketValidator->validateAndDeleteTicket($ticketId, $TARGET);
        } catch (\Exception $e) {
            throw new \RuntimeException($e->getMessage());
        }
        if (!\is_array($ticket)) {

            throw new \RuntimeException('Error loading ticket');
        }

        $response = $this->validateResponder->convertToSaml($ticket);
        $soap     = $this->validateResponder->wrapInSoap($response);

        return new XmlResponse(
            (string)$soap,
            Response::HTTP_OK,
        );
    }
}


1			<?php
2
3			declare(strict_types=1);
4
5			namespace SimpleSAML\Module\casserver\Controller;
6
7			use SimpleSAML\Configuration;
8			use SimpleSAML\Logger;
9			use SimpleSAML\Module\casserver\Cas\Protocol\Cas20;
10			use SimpleSAML\Module\casserver\Cas\Protocol\SamlValidateResponder;
11			use SimpleSAML\Module\casserver\Cas\TicketValidator;
12			use SimpleSAML\Module\casserver\Controller\Traits\UrlTrait;
13			use SimpleSAML\Module\casserver\Http\XmlResponse;
14			use Symfony\Component\HttpFoundation\Request;
15			use Symfony\Component\HttpFoundation\Response;
16			use Symfony\Component\HttpKernel\Attribute\AsController;
17			use Symfony\Component\HttpKernel\Attribute\MapQueryParameter;
18
19			#[AsController]
20			class Cas30Controller
21			{
22			use UrlTrait;
			0 ignored issues – show introduced 2024-12-01 09:33 UTC by Report Bug Copy Issue Report The trait `SimpleSAML\Module\casser...troller\Traits\UrlTrait` requires some properties which are not provided by `SimpleSAML\Module\casser...troller\Cas30Controller`: `$ticketFactory`, `$request`, `$ticketStore`, `$httpUtils`, `$query` Loading history...
23
24			/** @var Logger */
25			protected Logger $logger;
26
27			/** @var Configuration */
28			protected Configuration $casConfig;
29
30			/** @var Cas20 */
31			protected Cas20 $cas20Protocol;
32
33			/** @var TicketValidator */
34			protected TicketValidator $ticketValidator;
35
36			/** @var SamlValidateResponder */
37			protected SamlValidateResponder $validateResponder;
38
39			/**
40			* @param Configuration $sspConfig
41			* @param Configuration\|null $casConfig
42			*
43			* @throws \Exception
44			*/
45			public function __construct(
46			private readonly Configuration $sspConfig,
47			Configuration $casConfig = null,
48			TicketValidator $ticketValidator = null,
49			) {
50			// We are using this work around in order to bypass Symfony's autowiring for cas configuration. Since
51			// the configuration class is the same, it loads the ssp configuration twice. Still, we need the constructor
52			// argument in order to facilitate testin.
53			$this->casConfig = ($casConfig === null \|\| $casConfig === $sspConfig)
54			? Configuration::getConfig('module_casserver.php') : $casConfig;
55			$this->cas20Protocol = new Cas20($this->casConfig);
56			$this->ticketValidator = $ticketValidator ?? new TicketValidator($this->casConfig);
57			$this->validateResponder = new SamlValidateResponder();
58			}
59
60
61			/**
62			* POST /casserver/samlValidate?TARGET=
63			* Host: cas.example.com
64			* Content-Length: 491
65			* Content-Type: text/xml
66			*
67			* @param Request $request
68			* @param string $TARGET URL encoded service identifier of the back-end service.
69			*
70			* @throws \RuntimeException
71			* @return XmlResponse
72			* @link https://apereo.github.io/cas/7.1.x/protocol/CAS-Protocol-Specification.html#42-samlvalidate-cas-30
73			*/
74			public function samlValidate(
75			Request $request,
76			#[MapQueryParameter] string $TARGET,
77			): XmlResponse {
78			// From SAML2\SOAP::receive()
79			$postBody = $request->getContent();
80			if (empty($postBody)) {
81			throw new \RuntimeException('samlValidate expects a soap body.');
82			}
83
84			// SAML request values
85			//
86			// samlp:Request
87			// - RequestID [REQUIRED] - unique identifier for the request
88			// - IssueInstant [REQUIRED] - timestamp of the request
89			// samlp:AssertionArtifact [REQUIRED] - the valid CAS Service
90
91			$ticketParser = xml_parser_create();
92			xml_parser_set_option($ticketParser, XML_OPTION_CASE_FOLDING, 0);
93			xml_parser_set_option($ticketParser, XML_OPTION_SKIP_WHITE, 1);
94			xml_parse_into_struct($ticketParser, $postBody, $values, $tags);
95			xml_parser_free($ticketParser);
96
97			// Check for the required saml attributes
98			$samlRequestAttributes = $values[ $tags['samlp:Request'][0] ]['attributes'];
99			if (!isset($samlRequestAttributes['RequestID'])) {
100			throw new \RuntimeException('Missing RequestID samlp:Request attribute.');
101			} elseif (!isset($samlRequestAttributes['IssueInstant'])) {
102			throw new \RuntimeException('Missing IssueInstant samlp:Request attribute.');
103			}
104
105			if (
106			!isset($tags['samlp:AssertionArtifact'])
107			\|\| empty($values[$tags['samlp:AssertionArtifact'][0]]['value'])
108			) {
109			throw new \RuntimeException('Missing ticketId in AssertionArtifact');
110			}
111
112			$ticketId = $values[$tags['samlp:AssertionArtifact'][0]]['value'];
113			Logger::debug('samlvalidate: Checking ticket ' . $ticketId);
114
115			try {
116			// validateAndDeleteTicket might throw a CasException. In order to avoid third party modules
117			// dependencies, we will catch and rethrow the Exception.
118			$ticket = $this->ticketValidator->validateAndDeleteTicket($ticketId, $TARGET);
119			} catch (\Exception $e) {
120			throw new \RuntimeException($e->getMessage());
121			}
122			if (!\is_array($ticket)) {
			0 ignored issues – show introduced 2024-11-26 18:02 UTC by Report Bug Copy Issue Report The condition `is_array($ticket)` is always `true`. Loading history...
123			throw new \RuntimeException('Error loading ticket');
124			}
125
126			$response = $this->validateResponder->convertToSaml($ticket);
127			$soap = $this->validateResponder->wrapInSoap($response);
128
129			return new XmlResponse(
130			(string)$soap,
131			Response::HTTP_OK,
132			);
133			}
134			}
135

simplesamlphp / simplesamlphp-module-casserver

Pull Request — master (#45)

Cas30Controller::samlValidate() B

Complexity

Size

Duplication

Importance

How to fix Long Method

Long Method

Duplication Side-by-Side

Filter issues like