Always require MFA to edit contact numbers

Summary:
Depends on D20023. Ref T13222. Although I think this isn't strictly necessary from a pure security perspective (since you can't modify the primary number while you have MFA SMS), it seems like a generally good idea.

This adds a slightly new MFA mode, where we want MFA if it's available but don't strictly require it.

Test Plan: Disabled, enabled, primaried, unprimaried, and edited contact numbers. With MFA enabled, got prompted for MFA. With no MFA, no prompts.

Reviewers: amckinley

Reviewed By: amckinley

Maniphest Tasks: T13222

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

src/__phutil_library_map__.php

···
     'PhabricatorAuthContactNumberEditController' => 'applications/auth/controller/contact/PhabricatorAuthContactNumberEditController.php',
     'PhabricatorAuthContactNumberEditEngine' => 'applications/auth/editor/PhabricatorAuthContactNumberEditEngine.php',
     'PhabricatorAuthContactNumberEditor' => 'applications/auth/editor/PhabricatorAuthContactNumberEditor.php',
+    'PhabricatorAuthContactNumberMFAEngine' => 'applications/auth/engine/PhabricatorAuthContactNumberMFAEngine.php',
     'PhabricatorAuthContactNumberNumberTransaction' => 'applications/auth/xaction/PhabricatorAuthContactNumberNumberTransaction.php',
     'PhabricatorAuthContactNumberPHIDType' => 'applications/auth/phid/PhabricatorAuthContactNumberPHIDType.php',
     'PhabricatorAuthContactNumberPrimaryController' => 'applications/auth/controller/contact/PhabricatorAuthContactNumberPrimaryController.php',
···
       'PhabricatorApplicationTransactionInterface',
       'PhabricatorPolicyInterface',
       'PhabricatorDestructibleInterface',
+      'PhabricatorEditEngineMFAInterface',
     ),
     'PhabricatorAuthContactNumberController' => 'PhabricatorAuthController',
     'PhabricatorAuthContactNumberDisableController' => 'PhabricatorAuthContactNumberController',
     'PhabricatorAuthContactNumberEditController' => 'PhabricatorAuthContactNumberController',
     'PhabricatorAuthContactNumberEditEngine' => 'PhabricatorEditEngine',
     'PhabricatorAuthContactNumberEditor' => 'PhabricatorApplicationTransactionEditor',
+    'PhabricatorAuthContactNumberMFAEngine' => 'PhabricatorEditEngineMFAEngine',
     'PhabricatorAuthContactNumberNumberTransaction' => 'PhabricatorAuthContactNumberTransactionType',
     'PhabricatorAuthContactNumberPHIDType' => 'PhabricatorPHIDType',
     'PhabricatorAuthContactNumberPrimaryController' => 'PhabricatorAuthContactNumberController',

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

···
     $id = $number->getID();
     $cancel_uri = $number->getURI();
 
-    if ($request->isFormPost()) {
+    if ($request->isFormOrHisecPost()) {
       $xactions = array();
 
       if ($is_disable) {
···
         ->setActor($viewer)
         ->setContentSourceFromRequest($request)
         ->setContinueOnNoEffect(true)
-        ->setContinueOnMissingFields(true);
+        ->setContinueOnMissingFields(true)
+        ->setCancelURI($cancel_uri);
 
       try {
         $editor->applyTransactions($number, $xactions);

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

···
         ->addCancelButton($cancel_uri);
     }
 
-    if ($request->isFormPost()) {
+    if ($request->isFormOrHisecPost()) {
       $xactions = array();
 
       $xactions[] = id(new PhabricatorAuthContactNumberTransaction())
···
         ->setActor($viewer)
         ->setContentSourceFromRequest($request)
         ->setContinueOnNoEffect(true)
-        ->setContinueOnMissingFields(true);
+        ->setContinueOnMissingFields(true)
+        ->setCancelURI($cancel_uri);
 
       try {
         $editor->applyTransactions($number, $xactions);

src/applications/auth/engine/PhabricatorAuthContactNumberMFAEngine.php

···
+<?php
+
+final class PhabricatorAuthContactNumberMFAEngine
+  extends PhabricatorEditEngineMFAEngine {
+
+  public function shouldTryMFA() {
+    return true;
+  }
+
+}

src/applications/auth/storage/PhabricatorAuthContactNumber.php

···
   implements
     PhabricatorApplicationTransactionInterface,
     PhabricatorPolicyInterface,
-    PhabricatorDestructibleInterface {
+    PhabricatorDestructibleInterface,
+    PhabricatorEditEngineMFAInterface {
 
   protected $objectPHID;
   protected $contactNumber;
···
     return new PhabricatorAuthContactNumberTransaction();
   }
 
+
+/* -(  PhabricatorEditEngineMFAInterface  )---------------------------------- */
+
+
+  public function newEditEngineMFAEngine() {
+    return new PhabricatorAuthContactNumberMFAEngine();
+  }
 
 }

src/applications/transactions/editengine/PhabricatorEditEngineMFAEngine.php

···
       ->setObject($object);
   }
 
-  abstract public function shouldRequireMFA();
+  /**
+   * Do edits to this object REQUIRE that the user submit MFA?
+   *
+   * This is a strict requirement: users will need to add MFA to their accounts
+   * if they don't already have it.
+   *
+   * @return bool True to strictly require MFA.
+   */
+  public function shouldRequireMFA() {
+    return false;
+  }
+
+  /**
+   * Should edits to this object prompt for MFA if it's available?
+   *
+   * This is advisory: users without MFA on their accounts will be able to
+   * perform edits without being required to add MFA.
+   *
+   * @return bool True to prompt for MFA if available.
+   */
+  public function shouldTryMFA() {
+    return false;
+  }
 
 }

src/applications/transactions/editor/PhabricatorApplicationTransactionEditor.php

···
     $require_mfa = $engine->shouldRequireMFA();
 
     if (!$require_mfa) {
+      $try_mfa = $engine->shouldTryMFA();
+      if ($try_mfa) {
+        $this->setShouldRequireMFA(true);
+      }
       return $xactions;
     }