Resetting The Umango Authentication Method

Resetting The Umango Authentication Method

Overview

If the Authentication Method in Umango is misconfigured (e.g., an incorrect LDAP or MFA setup), administrators may find themselves locked out of the system.

By removing the AuthenticationMethod entry from the database, Umango reverts to its default Windows/Domain Login state, allowing you to log back in and correct your settings.

Prerequisites

  • Access to SQL Server Management Studio (SSMS).

  • Connectivity to the Umango database instance (e.g., .\SQLUMANGO).

  • Administrative permissions on the SQL instance.


This is the fastest and safest way to reset the setting without manually searching through table rows.

  1. Open SQL Server Management Studio.

  2. Click the New Query button in the top toolbar.

  3. Copy and paste the following script into the query window:

SQL
  1. /* Umango Authentication Reset Script
  2. Target: dbo.tbl_org_settings
  3. */

  4. USE [Umango]; -- Ensure this matches your database name
  5. GO

  6. BEGIN TRANSACTION;

  7. -- 1. Identify and delete the AuthenticationMethod row
  8. DELETE FROM [dbo].[tbl_org_settings]
  9. WHERE [name] = 'AuthenticationMethod';

  10. -- 2. Verify the deletion
  11. IF @@ROWCOUNT = 1
  12. BEGIN
  13. PRINT 'Success: AuthenticationMethod has been reset to default.';
  14. COMMIT TRANSACTION;
  15. END
  16. ELSE
  17. BEGIN
  18. PRINT 'Notice: AuthenticationMethod row not found or already deleted.';
  19. ROLLBACK TRANSACTION;
  20. END
  21. GO
  1. Press F5 or click Execute.

  2. Restart the Umango Service (via services.msc) to apply the changes.


Option 2: Manual Deletion (UI Method)

If you prefer to navigate the database manually:

  1. In the Object Explorer, expand Databases > Umango > Tables.

  2. Right-click dbo.tbl_org_settings and select Edit Top 200 Rows.

  3. Locate the row where the name column is AuthenticationMethod.

  4. Right-click the gray box at the far left of that row and select Delete.

  5. Confirm the deletion and Restart the Umango Service.


Info
After performing these steps, Umango will treat the next login attempt as a standard Windows/Domain authentication, exactly as it did during the initial installation.

Important Safety Note

AlertBackup First: Before running any scripts or deleting rows, right-click your database and select Tasks > Back Up... to create a restore point.



    • Related Articles

    • Troubleshooting Windows/Domain Authentication

      Umango utilizes standard Windows Interactive Logon protocols to verify user credentials. If you encounter "Access Denied" or "Logon Failure" errors, it is often due to restrictive security policies on the host server or within your Active Directory ...
    • Restricting User Access to Umango in Azure

      By default, when you create an Azure App Registration for use with Umango authentication, any user within your Microsoft Entra ID (formerly Azure AD) tenant can authenticate. To restrict access to specific departments, teams, or individuals, you must ...
    • Umango Scan Actuator Troubleshooting

      This article walks you through diagnosing connection problems between the Umango Scan Actuator (the small desktop app that talks to your scanner) and the Umango web application running in your browser. If you're on a personal or home computer, start ...
    • Changing SNMP Settings in Umango

      Umango uses SNMP (Simple Network Management Protocol) to discover and interact with supported multifunction devices (MFDs) on the network. These settings can be customized via the Advanced Configuration Screen. Default SNMP Settings By default, ...
    • Umango Installation Issue - SQL Server 2017 Compatibility

      Overview Umango installations include Microsoft SQL Server 2017 Express as a prerequisite for database functionality. In some environments, the installation of SQL Server 2017 Express may fail, preventing Umango from installing successfully. This ...