How To: Manage Two-Factor Authentication for NodeWorx
=====================================================

Server Administrators and NodeWorx Users can manage Two-Factor Authentication (2FA) for their user 
accounts from the Authentication page in NodeWorx. 

.. contents::

To Enable 2FA
-------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **NodeWorx > Authentication**
#. Click **Generate**. This opens the Generate Key form

   .. image:: /images/nw-2fa-generate.png
      :alt: 2fa generate button 

#. Using the authenticator app of choice, scan the **QR Code**

   .. image:: /images/nw-2fa-form.png
      :alt: 2fa enable form 

#. Update the Authentication Code field with the corresponding **code** generated by the 
   authenticator app
#. Click **Save**

To Disable 2FA
--------------

To Disable Using the GUI 
^^^^^^^^^^^^^^^^^^^^^^^^
#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **NodeWorx > Authentication**

   .. image:: /images/nw-2fa-delete.png
      :alt: 2fa delete button

#. Click **Delete**

To Disable Using the CLI
^^^^^^^^^^^^^^^^^^^^^^^^

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. At the CLI, run the following command:

   .. code-block::
   
      nodeworx -u -n -c Twofactorauth -a delete