2FA: Difference between revisions

From VoIPmonitor.org
Jump to navigation Jump to search
No edit summary
 
Line 1: Line 1:
== Two Factor Authentication (2FA) ==
== Two Factor Authentication (2FA) ==


It's possible to use 2FA from GUI's version 20.
2FA is available from VoIPmonitor GUI version 20.


=== Prerequisites ===


=== Required ===
Ensure server time is synchronized (install NTP service) as 2FA codes are time-sensitive.
Be sure you have synchronized time on your GUI's server because 2FA pins(codes) are time limited. (install ntp service there)


=== Settings in the GUI ===
=== GUI Settings ===


* user with admin permissions can activate 2FA's requirement for any user (in GUI->Users & Audit). When its enabled, the 2fa setup is required.
* Admin users can enable 2FA requirement for any user in '''GUI > Users & Audit'''. Enabling requires setup.
* admin user can delete actual 2FA secret from user's account (in GUI->Users & Audit)
* Admins can delete a user's 2FA secret in '''GUI > Users & Audit'''.
* user can change/setup its 2FA secret in the section GUI->User settings->Change user auth. This option joins the password and the 2FA setting.
* Users can set/change 2FA (with password) in '''GUI > User Settings > Change User Auth'''. Follow the setup dialog.
** follow the setup dialog


=== Setting of the 2FA code generator ===
=== 2FA Code Generator Setup ===


you can use various 2FA applications:
Use apps like:


* Google Authenticator for Android https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2
* Google Authenticator for Android: https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2
* Google Authenticator for IOS https://itunes.apple.com/cz/app/google-authenticator/id388497605?mt=8
* Google Authenticator for iOS: https://itunes.apple.com/cz/app/google-authenticator/id388497605?mt=8
* Google Authenticator as plugin for Chrome Browser https://chrome.google.com/webstore/detail/google-authenticator/njkhnbmlaefgkjpaghgphiceaocdblgl
* Google Authenticator Chrome extension: https://chrome.google.com/webstore/detail/google-authenticator/njkhnbmlaefgkjpaghgphiceaocdblgl
* Authenticator plugin for Firefox https://addons.mozilla.org/en-US/firefox/addon/auth-helper/?src=search
* Authenticator Firefox addon: https://addons.mozilla.org/en-US/firefox/addon/auth-helper/?src=search


Import account setting from QR code into yours application and start to use it.
Scan QR code to import account and generate codes.


=== Problem solving ===
=== Troubleshooting ===
 
Disable 2FA via database query:


* You can disable 2FA authentication for any user inside database with following query
  mysql> update users set secret = null, req_2fa = 0 where username = 'USER';
  mysql> update users set secret = null, req_2fa = 0 where username = 'USER';
=== AI Summary for RAG ===
'''Summary:''' This article covers enabling and using 2FA in VoIPmonitor GUI from version 20, including prerequisites (time sync), admin/user settings, app recommendations, setup process, and disabling via database.
'''Keywords:''' 2FA, two-factor authentication, GUI settings, time synchronization, NTP, Google Authenticator, QR code, database disable
'''Key Questions:'''
* What version supports 2FA in VoIPmonitor GUI?
* Why is time synchronization required for 2FA?
* How do admins enable or disable 2FA for users?
* How do users set up 2FA?
* What apps can generate 2FA codes?
* How to disable 2FA via database?

Latest revision as of 14:24, 10 November 2025

Two Factor Authentication (2FA)

2FA is available from VoIPmonitor GUI version 20.

Prerequisites

Ensure server time is synchronized (install NTP service) as 2FA codes are time-sensitive.

GUI Settings

  • Admin users can enable 2FA requirement for any user in GUI > Users & Audit. Enabling requires setup.
  • Admins can delete a user's 2FA secret in GUI > Users & Audit.
  • Users can set/change 2FA (with password) in GUI > User Settings > Change User Auth. Follow the setup dialog.

2FA Code Generator Setup

Use apps like:

Scan QR code to import account and generate codes.

Troubleshooting

Disable 2FA via database query: 

mysql> update users set secret = null, req_2fa = 0 where username = 'USER';

AI Summary for RAG

Summary: This article covers enabling and using 2FA in VoIPmonitor GUI from version 20, including prerequisites (time sync), admin/user settings, app recommendations, setup process, and disabling via database.

Keywords: 2FA, two-factor authentication, GUI settings, time synchronization, NTP, Google Authenticator, QR code, database disable

Key Questions:

  • What version supports 2FA in VoIPmonitor GUI?
  • Why is time synchronization required for 2FA?
  • How do admins enable or disable 2FA for users?
  • How do users set up 2FA?
  • What apps can generate 2FA codes?
  • How to disable 2FA via database?
Retrieved from "https://www.voipmonitor.org//doc/index.php?title=2FA&oldid=5731"