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

    • 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 ...
    • Installing Umango Silently Using Command Line Properties

      This article explains how to install Umango without user interaction by running the installer from the command line and supplying MSI properties. The Umango installer is distributed as an EXE bootstrapper that contains an MSI package. For silent ...
    • How to Change the Temporary Working Folder in Umango

      Overview Umango uses a temporary working folder to store files during processing. This folder is separate from the batch folder and is used internally by the system while documents are being processed. In some environments, you may want to move this ...
    • Network Folder Source Connector – XML Data File Not Found

      Overview When using Umango's Network Folders Source Connector with the option "Expect an XML data file with the same name as the importing file. If one exists, import the XML data", you may encounter import failures, particularly when larger files ...