Allow users to access some settings at the "Add MFA" account setup roadblock

Summary:
Depends on D20006. Ref T13222. Currently, the "MFA Is Required" gate doesn't let you do anything else, but you'll need to be able to access "Contact Numbers" if an install provides SMS MFA.

Tweak this UI to give users limited access to settings, so they can set up contact numbers and change their language.

(This is a little bit fiddly, and I'm doing it early on partly so it can get more testing as these changes move forward.)

Test Plan: {F6146136}

Reviewers: amckinley

Reviewed By: amckinley

Maniphest Tasks: T13222

Differential Revision: https://secure.phabricator.com/D20008

src/applications/auth/application/PhabricatorAuthApplication.php

···
           => 'PhabricatorAuthRevokeTokenController',
         'session/downgrade/'
           => 'PhabricatorAuthDowngradeSessionController',
-        'multifactor/'
-          => 'PhabricatorAuthNeedsMultiFactorController',
+        'enroll/' => array(
+          '(?:(?P<pageKey>[^/]+)/)?(?:(?P<formSaved>saved)/)?'
+            => 'PhabricatorAuthNeedsMultiFactorController',
+        ),
         'sshkey/' => array(
           $this->getQueryRoutePattern('for/(?P<forPHID>[^/]+)/')
             => 'PhabricatorAuthSSHKeyListController',

src/applications/auth/controller/PhabricatorAuthNeedsMultiFactorController.php

···
       return new Aphront400Response();
     }
 
-    $panel = id(new PhabricatorMultiFactorSettingsPanel())
-      ->setUser($viewer)
-      ->setViewer($viewer)
-      ->setOverrideURI($this->getApplicationURI('/multifactor/'))
-      ->processRequest($request);
+    $panels = $this->loadPanels();
+
+    $multifactor_key = id(new PhabricatorMultiFactorSettingsPanel())
+      ->getPanelKey();
+
+    $panel_key = $request->getURIData('pageKey');
+    if (!strlen($panel_key)) {
+      $panel_key = $multifactor_key;
+    }
 
-    if ($panel instanceof AphrontResponse) {
-      return $panel;
+    if (!isset($panels[$panel_key])) {
+      return new Aphront404Response();
     }
 
-    $crumbs = $this->buildApplicationCrumbs();
-    $crumbs->addTextCrumb(pht('Add Multi-Factor Auth'));
+    $nav = $this->newNavigation();
+    $nav->selectFilter($panel_key);
+
+    $panel = $panels[$panel_key];
 
     $viewer->updateMultiFactorEnrollment();
 
-    if (!$viewer->getIsEnrolledInMultiFactor()) {
-      $help = id(new PHUIInfoView())
-        ->setTitle(pht('Add Multi-Factor Authentication To Your Account'))
-        ->setSeverity(PHUIInfoView::SEVERITY_WARNING)
-        ->setErrors(
-          array(
-            pht(
-              'Before you can use Phabricator, you need to add multi-factor '.
-              'authentication to your account.'),
-            pht(
-              'Multi-factor authentication helps secure your account by '.
-              'making it more difficult for attackers to gain access or '.
-              'take sensitive actions.'),
-            pht(
-              'To learn more about multi-factor authentication, click the '.
-              '%s button below.',
-              phutil_tag('strong', array(), pht('Help'))),
-            pht(
-              'To add an authentication factor, click the %s button below.',
-              phutil_tag('strong', array(), pht('Add Authentication Factor'))),
-            pht(
-              'To continue, add at least one authentication factor to your '.
-              'account.'),
-          ));
+    if ($panel_key === $multifactor_key) {
+      $header_text = pht('Add Multi-Factor Auth');
+      $help = $this->newGuidance();
+      $panel->setIsEnrollment(true);
     } else {
-      $help = id(new PHUIInfoView())
-        ->setTitle(pht('Multi-Factor Authentication Configured'))
-        ->setSeverity(PHUIInfoView::SEVERITY_NOTICE)
-        ->setErrors(
-          array(
-            pht(
-              'You have successfully configured multi-factor authentication '.
-              'for your account.'),
-            pht(
-              'You can make adjustments from the Settings panel later.'),
-            pht(
-              'When you are ready, %s.',
-              phutil_tag(
-                'strong',
-                array(),
-                phutil_tag(
-                  'a',
-                  array(
-                    'href' => '/',
-                  ),
-                  pht('continue to Phabricator')))),
-          ));
+      $header_text = $panel->getPanelName();
+      $help = null;
+    }
+
+    $response = $panel
+      ->setController($this)
+      ->setNavigation($nav)
+      ->processRequest($request);
+
+    if (($response instanceof AphrontResponse) ||
+        ($response instanceof AphrontResponseProducerInterface)) {
+      return $response;
     }
 
-    $view = array(
-      $help,
-      $panel,
-    );
+    $crumbs = $this->buildApplicationCrumbs()
+      ->addTextCrumb(pht('Add Multi-Factor Auth'))
+      ->setBorder(true);
+
+    $header = id(new PHUIHeaderView())
+      ->setHeader($header_text);
+
+    $view = id(new PHUITwoColumnView())
+      ->setHeader($header)
+      ->setFooter(
+        array(
+          $help,
+          $response,
+        ));
 
     return $this->newPage()
       ->setTitle(pht('Add Multi-Factor Authentication'))
       ->setCrumbs($crumbs)
+      ->setNavigation($nav)
       ->appendChild($view);
 
+  }
+
+  private function loadPanels() {
+    $viewer = $this->getViewer();
+    $preferences = PhabricatorUserPreferences::loadUserPreferences($viewer);
+
+    $panels = PhabricatorSettingsPanel::getAllDisplayPanels();
+    $base_uri = $this->newEnrollBaseURI();
+
+    $result = array();
+    foreach ($panels as $key => $panel) {
+      $panel
+        ->setPreferences($preferences)
+        ->setViewer($viewer)
+        ->setUser($viewer)
+        ->setOverrideURI(urisprintf('%s%s/', $base_uri, $key));
+
+      if (!$panel->isEnabled()) {
+        continue;
+      }
+
+      if (!$panel->isUserPanel()) {
+        continue;
+      }
+
+      if (!$panel->isMultiFactorEnrollmentPanel()) {
+        continue;
+      }
+
+      if (!empty($result[$key])) {
+        throw new Exception(pht(
+          "Two settings panels share the same panel key ('%s'): %s, %s.",
+          $key,
+          get_class($panel),
+          get_class($result[$key])));
+      }
+
+      $result[$key] = $panel;
+    }
+
+    return $result;
+  }
+
+
+  private function newNavigation() {
+    $viewer = $this->getViewer();
+
+    $enroll_uri = $this->newEnrollBaseURI();
+
+    $nav = id(new AphrontSideNavFilterView())
+      ->setBaseURI(new PhutilURI($enroll_uri));
+
+    $multifactor_key = id(new PhabricatorMultiFactorSettingsPanel())
+      ->getPanelKey();
+
+    $nav->addFilter(
+      $multifactor_key,
+      pht('Enroll in MFA'),
+      null,
+      'fa-exclamation-triangle blue');
+
+    $panels = $this->loadPanels();
+
+    if ($panels) {
+      $nav->addLabel(pht('Settings'));
+    }
+
+    foreach ($panels as $panel_key => $panel) {
+      if ($panel_key === $multifactor_key) {
+        continue;
+      }
+
+      $nav->addFilter(
+        $panel->getPanelKey(),
+        $panel->getPanelName(),
+        null,
+        $panel->getPanelMenuIcon());
+    }
+
+    return $nav;
+  }
+
+  private function newEnrollBaseURI() {
+    return $this->getApplicationURI('enroll/');
+  }
+
+  private function newGuidance() {
+    $viewer = $this->getViewer();
+
+    if ($viewer->getIsEnrolledInMultiFactor()) {
+      $guidance = pht(
+        '{icon check, color="green"} **Setup Complete!**'.
+        "\n\n".
+        'You have successfully configured multi-factor authentication '.
+        'for your account.'.
+        "\n\n".
+        'You can make adjustments from the [[ /settings/ | Settings ]] panel '.
+        'later.');
+
+      return $this->newDialog()
+        ->setTitle(pht('Multi-Factor Authentication Setup Complete'))
+        ->setWidth(AphrontDialogView::WIDTH_FULL)
+        ->appendChild(new PHUIRemarkupView($viewer, $guidance))
+        ->addCancelButton('/', pht('Continue'));
+    }
+
+    $messages = array();
+
+    $messages[] = pht(
+      'Before you can use Phabricator, you need to add multi-factor '.
+      'authentication to your account. Multi-factor authentication helps '.
+      'secure your account by making it more difficult for attackers to '.
+      'gain access or take sensitive actions.');
+
+    $view = id(new PHUIInfoView())
+      ->setTitle(pht('Add Multi-Factor Authentication To Your Account'))
+      ->setSeverity(PHUIInfoView::SEVERITY_WARNING)
+      ->setErrors($messages);
+
+    return $view;
   }
 
 }

src/applications/auth/controller/contact/PhabricatorAuthContactNumberController.php

···
 abstract class PhabricatorAuthContactNumberController
   extends PhabricatorAuthController {
 
+  // Users may need to access these controllers to enroll in SMS MFA during
+  // account setup.
+
+  public function shouldRequireMultiFactorEnrollment() {
+    return false;
+  }
+
+  public function shouldRequireEnabledUser() {
+    return false;
+  }
+
+  public function shouldRequireEmailVerification() {
+    return false;
+  }
+
   protected function buildApplicationCrumbs() {
     $crumbs = parent::buildApplicationCrumbs();
 

src/applications/settings/panel/PhabricatorContactNumbersSettingsPanel.php

···
     return PhabricatorSettingsAuthenticationPanelGroup::PANELGROUPKEY;
   }
 
+  public function isMultiFactorEnrollmentPanel() {
+    return true;
+  }
+
   public function processRequest(AphrontRequest $request) {
     $user = $this->getUser();
     $viewer = $request->getUser();

src/applications/settings/panel/PhabricatorLanguageSettingsPanel.php

···
     return true;
   }
 
+  public function isMultiFactorEnrollmentPanel() {
+    return true;
+  }
+
 }

src/applications/settings/panel/PhabricatorMultiFactorSettingsPanel.php

···
 final class PhabricatorMultiFactorSettingsPanel
   extends PhabricatorSettingsPanel {
 
+  private $isEnrollment;
+
   public function getPanelKey() {
     return 'multifactor';
   }
···
 
   public function getPanelGroupKey() {
     return PhabricatorSettingsAuthenticationPanelGroup::PANELGROUPKEY;
+  }
+
+  public function isMultiFactorEnrollmentPanel() {
+    return true;
+  }
+
+  public function setIsEnrollment($is_enrollment) {
+    $this->isEnrollment = $is_enrollment;
+    return $this;
+  }
+
+  public function getIsEnrollment() {
+    return $this->isEnrollment;
   }
 
   public function processRequest(AphrontRequest $request) {
···
 
     $buttons = array();
 
+    // If we're enrolling a new account in MFA, provide a small visual hint
+    // that this is the button they want to click.
+    if ($this->getIsEnrollment()) {
+      $add_color = PHUIButtonView::BLUE;
+    } else {
+      $add_color = PHUIButtonView::GREY;
+    }
+
     $buttons[] = id(new PHUIButtonView())
       ->setTag('a')
       ->setIcon('fa-plus')
       ->setText(pht('Add Auth Factor'))
       ->setHref($this->getPanelURI('?new=true'))
       ->setWorkflow(true)
-      ->setColor(PHUIButtonView::GREY);
+      ->setColor($add_color);
 
     $buttons[] = id(new PHUIButtonView())
       ->setTag('a')

src/applications/settings/panel/PhabricatorSettingsPanel.php

···
     return false;
   }
 
+  /**
+   * Return true if this panel should be available when enrolling in MFA on
+   * a new account with MFA requiredd.
+   *
+   * @return bool True to allow configuration during MFA enrollment.
+   * @task config
+   */
+  public function isMultiFactorEnrollmentPanel() {
+    return false;
+  }
+
 
 /* -(  Panel Implementation  )----------------------------------------------- */