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

From the Authentication page in NodeWorx, Server Administrators and NodeWorx Users
are able to set up Two-Factor Authentication (2FA) for their user accounts. 

.. 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
#. Using the authenticator app of choice, scan the **QR Code**
#. Update the Authentication Code field with the corresponding **code** generated by the 
   authenticator app

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

#. 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**
#. 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