2FA: Difference between revisions

From VoIPmonitor.org
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by one other user not shown)
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.


Be sure you have synchronized time on your GUI's server because 2FA pins(codes) are time limited.
=== Prerequisites ===


=== Settings in the GUI ===
Ensure server time is synchronized (install NTP service) as 2FA codes are time-sensitive.


* user with admin permissions can activate 2FA's requirement for any user (in GUI->Users & Audit). When its enabled, the 2fa setup is required.
=== GUI Settings ===
* admin user can delete actual 2FA secret from user's account (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.
** follow the setup dialog


=== Setting of the 2FA code generator ===
* 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.


you can use various 2FA applications:
=== 2FA Code Generator Setup ===


* Google Authenticator for Android https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2
Use apps like:
* 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
* Authenticator plugin for Firefox 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.
* 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 Chrome extension: https://chrome.google.com/webstore/detail/google-authenticator/njkhnbmlaefgkjpaghgphiceaocdblgl
* Authenticator Firefox addon: https://addons.mozilla.org/en-US/firefox/addon/auth-helper/?src=search


=== Problem solving ===
Scan QR code to import account and generate codes.
 
=== 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?