Documentation for #2762

doc/sources/admin/external2f.rst

@@ -30,6 +30,9 @@ All parameters are configured in "General Parameters » Portal Parameters
    / Verification to an external provider. You must also use *$code*
    which is the value entered by user; Example:
    ``/usr/local/bin/verify --uid $uid --code $code``
+-  **Re-send interval**: Set this to a non-empty value to allow the user to
+   re-send the code in case a transmission error occured. The value sets how
+   many seconds the user has to wait before each attempt
 -  **Authentication level** (Optional): if you want to overwrite the
    value sent by your authentication module, you can define here the new
    authentication level. Example: 5

doc/sources/admin/mail2f.rst

@@ -45,6 +45,9 @@ Mail second factor".
 -  **Mail body**: The plain text content of the email the user will
    receive. If you leave it blank, the ``mail_2fcode`` HTML template
    will be used. The one-time code is stored in the ``$code`` variable
+-  **Re-send interval**: Set this to a non-empty value to allow the user to
+   re-send the code in case a transmission error occured. The value sets how
+   many seconds the user has to wait before each attempt
 -  **Authentication level** (Optional): if you want to overwrite the
    value sent by your authentication module, you can define here the new
    authentication level. Example: 5

doc/sources/admin/rest2f.rst

@@ -17,6 +17,9 @@ Second Factors » REST 2nd Factor".
 -  **Init arguments**: list of arguments to send *(see below)*
 -  **Verify URL** *(required)*: REST URL to verify code
 -  **Verify arguments**: list of arguments to send *(see below)*
+-  **Re-send interval**: Set this to a non-empty value to allow the user to
+   re-send the code in case a transmission error occured. The value sets how
+   many seconds the user has to wait before each attempt
 -  **Authentication level** (Optional): if you want to overwrite the
    value sent by your authentication module, you can define here the new
    authentication level. Example: 5

doc/sources/admin/upgrade_2_0_x.rst

@@ -46,6 +46,32 @@ In order for custom Captcha modules to work, you need to modify your custom ``st
 
 If you are using the default templates from the ``bootstrap`` theme, you don't need to change anything.
 
+Re-send 2FA code
+~~~~~~~~~~~~~~~~
+
+The :doc:`mail <mail2f>`, :doc:`external <external2f>` and :doc:`REST <rest2f>` based 2FA types can now re-send the user code if delivery failed for some reason. If you use custom templates, you must update ``ext2fcheck.tpl``
+
+.. code:: diff
+
+    --- a/lemonldap-ng-portal/site/templates/bootstrap/ext2fcheck.tpl
+    +++ b/lemonldap-ng-portal/site/templates/bootstrap/ext2fcheck.tpl
+    @@ -26,6 +26,12 @@
+         </button>
+       </div>
+       <div class="buttons">
+    +    <TMPL_IF "RESENDTARGET">
+    +    <button type="submit" class="btn btn-primary" formaction="<TMPL_VAR "RESENDTARGET">">
+    +      <span class="fa fa-repeat"></span>
+    +      <span trspan="resendCode">Re-send code</span>
+    +    </button>
+    +    </TMPL_IF>
+         <a href="<TMPL_VAR NAME="PORTAL_URL">?cancel=1&skin=<TMPL_VAR NAME="SKIN">" class="btn btn-primary" role="button">
+           <span class="fa fa-home"></span>
+           <span trspan="cancel">Cancel</span>
+
+
+If you are using the default templates from the ``bootstrap`` theme, you don't need to change anything.
+
 2.0.14
 ------