Skip to main content
The TruU Account Management Service (TAMS) is a Windows Service installed in your on-premises environment. It exposes a lightweight HTTPS REST API that allows the TruU Windows Authenticator to trigger Active Directory (AD) account operations — currently, unlocking a locked-out user account. TAMS acts as a secure bridge between the TruU platform and your Active Directory infrastructure. All account operations run under a dedicated Windows service account, and no AD credentials are ever stored in the application.
TAMS does not connect to any password store or hold AD credentials. It performs AD operations using the Windows service account identity it runs as, and it trusts the TruU Identity Server as the authoritative source of user identity.

Architecture

Component Overview

A TAMS deployment is made up of the following logical components:
  • Web server — hosts the REST API (ASP.NET Core) that the Windows Authenticator calls to request an account unlock.
  • Token validation layer — validates the OAuth2 Bearer token on every request against the TruU Identity Server.
  • Active Directory integration layer — locates the user by UPN and performs the unlock via System.DirectoryServices and System.DirectoryServices.AccountManagement.
  • Configuration store — settings are read from the Windows Registry under HKLM\SOFTWARE\TruU\AccountManagement.
  • Observability — health checks, structured logging (NLog), and event reporting (Sentry).

Deployment Model

  • Installed as a native Windows Service via an MSI installer.
  • Runs on a Windows Server joined to, or with access to, your Active Directory domain/forest.
  • Configuration is stored in the Windows Registry under HKLM\SOFTWARE\TruU\AccountManagement.
  • The service process identity is a Windows service account with the minimum AD permissions required.
  • Compiled for x64 only — ARM64 and x86 hosts are not supported.
TAMS is stateless — no session or in-memory state is shared between instances. This makes it straightforward to run multiple instances for high availability. See High Availability & Load Balancing.
Image (9) 1

Technology Stack

ComponentTechnology
Runtime.NET 10 (Windows)
Web serverASP.NET Core on Kestrel
AD integrationSystem.DirectoryServices & System.DirectoryServices.AccountManagement
InstallerWiX Toolset (MSI)
MonitoringSentry, NLog
ConfigurationWindows Registry