Surfnet\StepupSelfService\SelfServiceBundle\Controller\SelfAssertedTokensController

Complexity

Total Complexity

35

Size/Duplication

Total Lines	384
Duplicated Lines	0 %

Importance

Changes	2
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	registerCreateRecoveryTokenSafeStore()	0	35	4
B	selfAssertedTokenRecoveryTokenSmsAuthentication()	0	63	9
A	registerRecoveryTokenSms()	0	12	1
A	selfAssertedTokenRegistration()	0	43	4
A	registerRecoveryTokenSmsProofOfPossession()	0	12	1
A	newRecoveryToken()	0	24	3
C	selfAssertedTokenRegistrationRecoveryToken()	0	78	11
A	__construct()	0	12	1
A	invokeSelfAssertedTokenRegistrationCommand()	0	8	1

<?php

declare(strict_types = 1);

/**
 * Copyright 2022 SURFnet B.V.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

PHP version not specified

Missing @category tag in file comment

Missing @package tag in file comment

Missing @author tag in file comment

Missing @license tag in file comment

Missing @link tag in file comment

namespace Surfnet\StepupSelfService\SelfServiceBundle\Controller;

use Psr\Log\LoggerInterface;
use Surfnet\StepupBundle\Service\LoaResolutionService;
use Surfnet\StepupBundle\Value\PhoneNumber\InternationalPhoneNumber;
use Surfnet\StepupSelfService\SelfServiceBundle\Command\PromiseSafeStorePossessionCommand;
use Surfnet\StepupSelfService\SelfServiceBundle\Command\SafeStoreAuthenticationCommand;
use Surfnet\StepupSelfService\SelfServiceBundle\Command\SelfAssertedTokenRegistrationCommand;
use Surfnet\StepupSelfService\SelfServiceBundle\Command\SendRecoveryTokenSmsAuthenticationChallengeCommand;
use Surfnet\StepupSelfService\SelfServiceBundle\Command\VerifySmsRecoveryTokenChallengeCommand;
use Surfnet\StepupSelfService\SelfServiceBundle\Form\Type\AuthenticateSafeStoreType;
use Surfnet\StepupSelfService\SelfServiceBundle\Form\Type\PromiseSafeStorePossessionType;
use Surfnet\StepupSelfService\SelfServiceBundle\Form\Type\VerifySmsChallengeType;
use Surfnet\StepupSelfService\SelfServiceBundle\Service\SecondFactorService;
use Surfnet\StepupSelfService\SelfServiceBundle\Service\SelfAssertedTokens\AuthenticationRequestFactory;
use Surfnet\StepupSelfService\SelfServiceBundle\Service\SelfAssertedTokens\RecoveryTokenService;
use Surfnet\StepupSelfService\SelfServiceBundle\Service\SelfAssertedTokens\SafeStoreService;
use Surfnet\StepupSelfService\SelfServiceBundle\Service\SmsRecoveryTokenService;
use Symfony\Component\HttpFoundation\RedirectResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

/**

Missing short description in doc comment

 *
 * @SuppressWarnings(PHPMD.CyclomaticComplexity)
 * @SuppressWarnings(PHPMD.CouplingBetweenObjects)
 */

Missing @category tag in class comment

Missing @package tag in class comment

Missing @author tag in class comment

Missing @license tag in class comment

Missing @link tag in class comment

class SelfAssertedTokensController extends Controller
{
    use RecoveryTokenControllerTrait;

The trait Surfnet\StepupSelfService\SelfServiceBundle\Controller\RecoveryTokenControllerTrait requires the property $id which is not provided by Surfnet\StepupSelfService\SelfServiceBundle\Controller\SelfAssertedTokensController.

    /**

Missing short description in doc comment

     * @var RecoveryTokenService
     */
    private $recoveryTokenService;

Private member variable "recoveryTokenService" must be prefixed with an underscore

    /**

Missing short description in doc comment

     * @var SecondFactorService
     */
    private $secondFactorService;

Private member variable "secondFactorService" must be prefixed with an underscore

    /**

Missing short description in doc comment

     * @var SmsRecoveryTokenService
     */
    private $smsService;

Private member variable "smsService" must be prefixed with an underscore

    public function __construct(

Missing doc comment for function __construct()

        RecoveryTokenService $recoveryTokenService,
        private readonly SafeStoreService $safeStoreService,
        SecondFactorService $secondFactorService,
        SmsRecoveryTokenService $smsService,
        private readonly LoaResolutionService $loaResolutionService,
        private readonly AuthenticationRequestFactory $authnRequestFactory,
        private readonly LoggerInterface $logger
    ) {
        $this->recoveryTokenService = $recoveryTokenService;
        $this->secondFactorService = $secondFactorService;
        $this->smsService = $smsService;
    }

    /**

Parameter $secondFactorId should have a doc-comment as per coding-style.

     * Self-asserted token registration: Registration entrypoint
     *
     * Select(s) the recovery token to perform the self-asserted second factor
     * token registration with.
     *
     * Possible outcomes:
     * 1. Shows a recovery token selection screen when more than one token are available
     * 2. Selects the one and only available recovery token and redirects to the recovery token authentication route
     * 3. Starts registration of a recovery token if non are in possession
     */

Missing @return tag in function comment

    #[Route(
        path: '/second-factor/{secondFactorId}/self-asserted-token-registration',
        name: 'ss_second_factor_self_asserted_tokens',
        methods: ['GET'],
    )]
    public function selfAssertedTokenRegistration(string $secondFactorId): Response
    {
        $this->logger->info('Checking if Identity has a recovery token');
        $identity = $this->getIdentity();
        $this->assertSecondFactorInPossession($secondFactorId, $identity);
        $secondFactor = $this->secondFactorService->findOneVerified($secondFactorId);
        if ($this->recoveryTokenService->hasRecoveryToken($identity)) {
            $tokens = $this->recoveryTokenService->getAvailableTokens($identity, $secondFactor);

It seems like $secondFactor can also be of type null; however, parameter $secondFactor of Surfnet\StepupSelfService\SelfServiceBundle\Service\SelfAssertedTokens\RecoveryTokenService::getAvailableTokens() does only seem to accept Surfnet\StepupMiddlewareClientBundle\Identity\Dto\VerifiedSecondFactor, maybe add an additional type check?

            if ($tokens === []) {
                // User is in possession of a recovery token, but it is not safe to use here (for example sms recovery
                // token is not available while activating a SMS second factor)
                $this->addFlash('error', 'ss.self_asserted_tokens.second_factor.no_available_recovery_token.alert.failed');
                return $this->redirectToRoute('ss_second_factor_list');
            }
            if (count($tokens) > 1) {
                $this->logger->info('Show recovery token selection screen');
                return $this->render(
                    'registration/self_asserted_tokens/select_available_recovery_token.html.twig',
                    [
                        'secondFactorId' => $secondFactorId,
                        'showAvailable' => true,
                        'availableRecoveryTokens' => $tokens,
                    ]
                );
            }
            $this->logger->info('Continue to recovery token authentication screen for the one available recovery token');
            $token = reset($tokens);
            return $this->redirect($this->generateUrl(

The opening parenthesis of a multi-line function call should be the last content on the line.

                'ss_second_factor_self_asserted_tokens_recovery_token',
                [
                    'secondFactorId' => $secondFactorId,
                    'recoveryTokenId' => $token->recoveryTokenId
                ]
            ));

For multi-line function calls, the closing parenthesis should be on a new line.

        }
        $this->logger->info('Start registration of a recovery token (none are available yet)');
        return $this->redirect(
            $this->generateUrl('ss_second_factor_new_recovery_token', ['secondFactorId' => $secondFactorId])
        );
    }

    /**

Parameter $request should have a doc-comment as per coding-style.

Parameter $secondFactorId should have a doc-comment as per coding-style.

Parameter $recoveryTokenId should have a doc-comment as per coding-style.

     * Self-asserted token registration: Authenticate recovery token
     *
     * Identity must authenticate the recovery token in order to perform a
     * self-asserted token registration. But only when this action is
     * performed while recovering a Second Factor token. During initial
     * registration of a recovery token in the self-asserted token registration
     * flow, authentication is not required.
     */

Missing @return tag in function comment

    #[Route(
        path: '/second-factor/{secondFactorId}/self-asserted-token-registration/{recoveryTokenId}',
        name: 'ss_second_factor_self_asserted_tokens_recovery_token',
        methods: ['GET','POST']
    )]
    public function selfAssertedTokenRegistrationRecoveryToken(
        Request $request,
        string $secondFactorId,
        string $recoveryTokenId
    ): Response {
        $this->logger->info('Start authentication of recovery token to perform self-asserted token registration');
        $identity = $this->getIdentity();
        $this->assertSecondFactorInPossession($secondFactorId, $identity);
        $this->assertRecoveryTokenInPossession($recoveryTokenId, $identity);
        $token = $this->recoveryTokenService->getRecoveryToken($recoveryTokenId);

        switch ($token->type) {
            case "sms":

Line indented incorrectly; expected 8 spaces, found 12

                if ($this->smsService->wasTokenCreatedDuringSecondFactorRegistration()) {

Line indented incorrectly; expected 12 spaces, found 16

                    // Forget we created the recovery token during token registration. Next time Identity
                    // must fill its password.
                    $this->smsService->forgetTokenCreatedDuringSecondFactorRegistration();
                    $secondFactor = $this->secondFactorService->findOneVerified($secondFactorId);

                    $command = new SelfAssertedTokenRegistrationCommand();
                    $command->identity = $this->getIdentity();
                    $command->secondFactor = $secondFactor;
                    $command->recoveryTokenId = $recoveryTokenId;

                    if ($this->secondFactorService->registerSelfAssertedToken($command)) {

Line indented incorrectly; expected 16 spaces, found 20

                        $this->addFlash('success', 'ss.self_asserted_tokens.second_factor.alert.successful');
                    } else {

Line indented incorrectly; expected 16 spaces, found 20

                        $this->addFlash('error', 'ss.self_asserted_tokens.second_factor.alert.failed');
                    }

Line indented incorrectly; expected 16 spaces, found 20

                    return $this->redirectToRoute('ss_second_factor_list');
                }

Line indented incorrectly; expected 12 spaces, found 16

                $number = InternationalPhoneNumber::fromStringFormat($token->identifier);
                $command = new SendRecoveryTokenSmsAuthenticationChallengeCommand();
                $command->identifier = $number;
                $command->institution = $identity->institution;
                $command->recoveryTokenId = $recoveryTokenId;
                $command->identity = $identity->id;
                $this->smsService->authenticate($command);
                return $this->redirectToRoute(
                    'ss_second_factor_self_asserted_tokens_recovery_token_sms',
                    ['secondFactorId' => $secondFactorId, 'recoveryTokenId' => $recoveryTokenId]
                );
            case "safe-store":

Line indented incorrectly; expected 8 spaces, found 12

                // No authentication of the safe store token is required if created during SF token registration
                if ($this->safeStoreService->wasSafeStoreTokenCreatedDuringSecondFactorRegistration()) {

Line indented incorrectly; expected 12 spaces, found 16

                    // Forget we created the safe-store recovery token during token registration. Next time Identity
                    // must fill its password.
                    $this->safeStoreService->forgetSafeStoreTokenCreatedDuringSecondFactorRegistration();
                    if ($this->invokeSelfAssertedTokenRegistrationCommand($secondFactorId, $recoveryTokenId)) {

Line indented incorrectly; expected 16 spaces, found 20

                        $this->addFlash('success', 'ss.self_asserted_tokens.second_factor.vetting.alert.successful');
                    } else {

Line indented incorrectly; expected 16 spaces, found 20

                        $this->addFlash('error', 'ss.self_asserted_tokens.second_factor.vetting.alert.failed');
                    }

Line indented incorrectly; expected 16 spaces, found 20

                    return $this->redirectToRoute('ss_second_factor_list');
                }

Line indented incorrectly; expected 12 spaces, found 16

                $command = new SafeStoreAuthenticationCommand();
                $command->recoveryToken = $token;
                $command->identity = $identity->id;
                $form = $this->createForm(AuthenticateSafeStoreType::class, $command)->handleRequest($request);
                if ($form->isSubmitted() && $form->isValid()) {

Line indented incorrectly; expected 12 spaces, found 16

                    if ($this->recoveryTokenService->authenticateSafeStore($command)) {

Line indented incorrectly; expected 16 spaces, found 20

                        if ($this->invokeSelfAssertedTokenRegistrationCommand($secondFactorId, $recoveryTokenId)) {

Line indented incorrectly; expected 20 spaces, found 24

                            $this->addFlash('success', 'ss.self_asserted_tokens.second_factor.vetting.alert.successful');
                            return $this->redirectToRoute('ss_second_factor_list');
                        }

Line indented incorrectly; expected 20 spaces, found 24

                        $this->addFlash('error', 'ss.self_asserted_tokens.second_factor.vetting.alert.failed');
                    } else {

Line indented incorrectly; expected 16 spaces, found 20

                        $this->addFlash('error', 'ss.self_asserted_tokens.safe_store.authentication.alert.failed');
                    }

Line indented incorrectly; expected 16 spaces, found 20

                }

Line indented incorrectly; expected 12 spaces, found 16

                return $this->render(
                    'registration/self_asserted_tokens/authenticate_safe_store.html.twig',
                    ['form' => $form->createView()]
                );
        }
    }

    /**

Parameter $secondFactorId should have a doc-comment as per coding-style.

     * Self-asserted token registration: choose recovery token type
     *
     * The user can select which recovery token to add. Some limitations may
     * apply. For example, using a SMS Recovery Token for registration of an
     * SMS Second Factor is only allowed when different phone numbers are used.
     */

Missing @return tag in function comment

    #[Route(
        path: '/second-factor/{secondFactorId}/new-recovery-token',
        name: 'ss_second_factor_new_recovery_token',
        methods: ['GET']
    )]
    public function newRecoveryToken(string $secondFactorId): Response
    {
        $this->logger->info('Determining which recovery token are available');
        $identity = $this->getIdentity();
        $this->assertSecondFactorInPossession($secondFactorId, $identity);
        $this->assertNoRecoveryTokens($identity);

        $secondFactor = $this->secondFactorService->findOneVerified($secondFactorId);
        $availableRecoveryTokens = $this->recoveryTokenService->getRemainingTokenTypes($identity);
        if ($secondFactor && $secondFactor->type === 'sms') {
            $this->logger->notice('SMS recovery token type is not allowed as we are vetting a SMS second factor');
            unset($availableRecoveryTokens['sms']);
        }

        return $this->render(
            'registration/self_asserted_tokens/new_recovery_token.html.twig',
            [
                'secondFactorId' => $secondFactorId,
                'availableRecoveryTokens' => $availableRecoveryTokens
            ]
        );
    }

    /**

Parameter $request should have a doc-comment as per coding-style.

Parameter $secondFactorId should have a doc-comment as per coding-style.

Parameter $recoveryTokenId should have a doc-comment as per coding-style.

     * Self-asserted token registration: Authenticate a SMS recovery token
     *
     * The previous action (selfAssertedTokenRegistrationRecoveryTokenAction)
     * sent the Identity a OTP via SMS. The Identity must reproduce that OTP
     * in this action. Proving possession of the recovery token.
     */

Missing @return tag in function comment

    #[Route(
        path: '/second-factor/{secondFactorId}/self-asserted-token-registration/{recoveryTokenId}/authenticate',
        name: 'ss_second_factor_self_asserted_tokens_recovery_token_sms',
        methods: ['GET','POST']
    )]
    public function selfAssertedTokenRecoveryTokenSmsAuthentication(
        Request $request,
        string $secondFactorId,
        string $recoveryTokenId
    ): Response {
        $identity = $this->getIdentity();
        $this->assertSecondFactorInPossession($secondFactorId, $identity);
        $this->assertRecoveryTokenInPossession($recoveryTokenId, $identity);

        // Then render the authentication (proof of possession screen
        if (!$this->smsService->hasSmsVerificationState($recoveryTokenId)) {
            $this->get('session')->getFlashBag()->add('notice', 'ss.registration.sms.alert.no_verification_state');

The method get() does not exist on Surfnet\StepupSelfService\SelfServiceBundle\Controller\SelfAssertedTokensController.

            return $this->redirectToRoute(
                'ss_second_factor_self_asserted_tokens',
                ['secondFactorId' => $secondFactorId]
            );
        }

        $secondFactor = $this->secondFactorService->findOneVerified($secondFactorId);

        $command = new VerifySmsRecoveryTokenChallengeCommand();
        $command->identity = $identity->id;
        $command->resendRouteParameters = ['secondFactorId' => $secondFactorId, 'recoveryTokenId' => $recoveryTokenId];

        $form = $this->createForm(VerifySmsChallengeType::class, $command)->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            $command->recoveryTokenId = $recoveryTokenId;
            $result = $this->smsService->verifyAuthentication($command);
            if ($result->authenticated()) {
                $this->smsService->clearSmsVerificationState($recoveryTokenId);

                $command = new SelfAssertedTokenRegistrationCommand();
                $command->identity = $this->getIdentity();
                $command->secondFactor = $secondFactor;
                $command->recoveryTokenId = $recoveryTokenId;

                if ($this->secondFactorService->registerSelfAssertedToken($command)) {
                    $this->addFlash('success', 'ss.self_asserted_tokens.second_factor.alert.successful');
                } else {
                    $this->addFlash('error', 'ss.self_asserted_tokens.second_factor.alert.failed');
                }

                return $this->redirectToRoute('ss_second_factor_list');
            } elseif ($result->wasIncorrectChallengeResponseGiven()) {
                $this->addFlash('error', 'ss.prove_phone_possession.incorrect_challenge_response');
            } elseif ($result->hasChallengeExpired()) {
                $this->addFlash('error', 'ss.prove_phone_possession.challenge_expired');
            } elseif ($result->wereTooManyAttemptsMade()) {
                $this->addFlash('error', 'ss.prove_phone_possession.too_many_attempts');
            } else {
                $this->addFlash('error', 'ss.prove_phone_possession.proof_of_possession_failed');
            }
        }
        return $this->render(
            'registration/self_asserted_tokens/registration_sms_prove_possession.html.twig',
            [
                'form' => $form->createView(),
            ]
        );
    }

    /**

Parameter $request should have a doc-comment as per coding-style.

Parameter $secondFactorId should have a doc-comment as per coding-style.

     * Self-asserted token registration: Create Recovery Token (safe-store)
     *
     * Shows the one-time secret and asks the Identity to store the
     * password in a safe location.
     */

Missing @return tag in function comment

    #[Route(
        path: '/second-factor/{secondFactorId}/safe-store',
        name: 'ss_registration_recovery_token_safe_store',
        methods: ['GET','POST']
    )]
    public function registerCreateRecoveryTokenSafeStore(Request $request, string $secondFactorId): Response
    {
        $identity = $this->getIdentity();
        $this->assertSecondFactorInPossession($secondFactorId, $identity);
        $this->assertNoRecoveryTokenOfType('safe-store', $identity);

        $secret = $this->safeStoreService->produceSecret();
        $command = new PromiseSafeStorePossessionCommand();

        $form = $this->createForm(PromiseSafeStorePossessionType::class, $command)->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            $command->secret = $secret;
            $command->identity = $this->getIdentity();

            $executionResult = $this->safeStoreService->promisePossession($command);
            if (!$executionResult->getErrors()) {
                return $this->redirect(
                    $this->generateUrl('ss_second_factor_self_asserted_tokens', ['secondFactorId' => $secondFactorId])
                );
            }
            $this->addFlash('error', 'ss.form.recovery_token.error.error_message');
        }

        return $this->render(
            'registration/self_asserted_tokens/recovery_token_safe_store.html.twig',
            [
                'form' => $form->createView(),
                'secondFactorId' => $secondFactorId,
                'secret' => $secret,
            ]
        );
    }

    /**

Parameter $request should have a doc-comment as per coding-style.

Parameter $secondFactorId should have a doc-comment as per coding-style.

     * Self-asserted token registration: Create the SMS recovery token
     * Step 1: Send an OTP to phone of Identity
     *
     * Note: Shares logic with the recovery token SMS send challenge action
     */

Missing @return tag in function comment

    #[Route(
        path: '/second-factor/{secondFactorId}/sms',
        name: 'ss_registration_recovery_token_sms',
        methods: ['GET','POST'],
    )]
    public function registerRecoveryTokenSms(Request $request, string $secondFactorId): Response
    {
        return $this->handleSmsChallenge(
            $request,
            'registration/self_asserted_tokens/recovery_token_sms.html.twig',
            'ss_registration_recovery_token_sms_proof_of_possession',
            $secondFactorId
        );
    }

    /**

Parameter $request should have a doc-comment as per coding-style.

Parameter $secondFactorId should have a doc-comment as per coding-style.

     * Self-asserted token registration: Create the SMS recovery token
     * Step 2: Process proof of phone possession of Identity
     *
     * Note: Shares logic with the recovery token SMS send challenge action
     */

Missing @return tag in function comment

    #[Route(
        path: '/recovery-token/{secondFactorId}/prove-sms-possession',
        name: 'ss_registration_recovery_token_sms_proof_of_possession',
        methods: ['GET', 'POST']
    )]
    public function registerRecoveryTokenSmsProofOfPossession(Request $request, string $secondFactorId): Response
    {
        return $this->handleSmsProofOfPossession(
            $request,
            'registration/self_asserted_tokens/registration_sms_prove_possession.html.twig',
            'ss_second_factor_self_asserted_tokens',
            $secondFactorId
        );
    }

    private function invokeSelfAssertedTokenRegistrationCommand(string $secondFactorId, string $recoveryTokenId): bool

Private method name "SelfAssertedTokensController::invokeSelfAssertedTokenRegistrationCommand" must be prefixed with an underscore

Missing doc comment for function invokeSelfAssertedTokenRegistrationCommand()

    {
        $secondFactor = $this->secondFactorService->findOneVerified($secondFactorId);
        $command = new SelfAssertedTokenRegistrationCommand();
        $command->identity = $this->getIdentity();
        $command->secondFactor = $secondFactor;
        $command->recoveryTokenId = $recoveryTokenId;
        return $this->secondFactorService->registerSelfAssertedToken($command);
    }
}