Password agent

From UmsWiki
Jump to: navigation, search

The Password module handles the password synchronization between the domain controllers. It must be installed on all domain controllers. 

Prerequisites

Module requirements

UMS

Files that are required

  • UserManagement.ini
  • Setup PasswordFilter x64.msi / Setup PasswordFilter x86.msi
  • Vcredist_x64.exe / Vcredist_x86.exe

What is not required

  • UMS License file for the DC

Where can I find the files?

(Depending on software architecture, use the 64/32-bit version)

- [C:\Program Files\UserManagement]

  • UserManagement.ini
  • Setup PasswordFilter x64.msi

Installation

  1. Update all DC’s to full .Net framework 4.6.2
  2. Install Visual C++ 2017 (x86) or Visual C++ 2017 (x64) depending on architecture.
  3. Use Microsoft Update to make sure that all updates are applied to the framework and Visual C++
  4. Copy UserManagement.ini to [C:\Windows]
  5. Install "Setup PasswordFilter x64.msi" or "Setup PasswordFilter x86.msi" depending on architecture.
  6. Restart Server (required for PasswordFilter to be loaded)

Update

If you are updating, please start with uninstalling the old password agents and restarting the DC.

Verification

Run as Administrator: “msinfo32.exe” (from windows start menu -- > "run")

  • Click on Software Environment
  • Loaded Modules
  • Look for PasswordFilter where Manufacturer is inLogic A/S
PasswordAgent Loaded modules.jpg

FAQ

Which Domain Controllers must the agent be installed on

It must be installed on all Domain Controllers that the is used for password change operations.

How does the agent work

When you change the password the agent on the domain controller grabs the cleartext password from the password chain on the server and encrypts it.

Then it sends the password to the SQL server. If the SQL server cannot be reached the password change will be denied and the Domain Controller will send a complexity warning.

Cannot change password

If you cannot change password look in c:\ for a file name PasswordFilter.Log

This file contains the error message that UMS created (if it was a UMS error). E.g. (cannot reach SQL server)

UMS cannot throw an error text. It will always be something with about the complexity rules not met.

When you have resolved the error best practice would be to delete the PasswordFilter.Log from the server (maybe take a backup for historical use).