Disco ICT - AD Compare Plugin

A plugin for Disco ICT that compares the Managed By field on Active Directory computer objects against the Assigned User in Disco, and reports mismatches.

What It Does

For every active device in Disco that has a domain computer account, this plugin:

1. Looks up the computer in AD and reads the managedBy attribute
2. Resolves the managedBy Distinguished Name back to a DOMAIN\username
3. Compares that against Disco's AssignedUserId for the device
4. Reports mismatches with clear reasons

Mismatch Categories

• Different users — Disco has one user assigned, AD managedBy points to someone else
• Assigned in Disco but AD empty — Device is assigned in Disco but managedBy is blank in AD
• Not assigned in Disco but AD set — No Disco assignment but managedBy is populated
• Computer not found in AD — The device's domain ID doesn't resolve to an AD computer object

Web Dashboard

The plugin provides an in-app dashboard accessible via the Disco plugin web handler:

• Summary stats with colour-coded counts
• Filterable results table (mismatches only by default)
• Text search across serial numbers, computer names, and user IDs
• CSV export of all mismatches

Project Structure

├── ADComparePlugin.cs                              # Main plugin class
├── ConfigurationHandler/
│   └── ADCompareConfigurationHandler.cs            # Required config handler + Razor view
├── Features/
│   └── DeviceCompareService.cs                     # Core comparison logic
├── Models/
│   └── DeviceComparisonResult.cs                   # Result models
├── WebHandler/
│   └── ADCompareWebHandler.cs                      # Dashboard, JSON API, CSV export
├── Properties/
│   └── AssemblyInfo.cs
├── Build-Plugin.ps1                                # Build + package script
├── Disco.Plugins.ADCompare.csproj
└── README.md

Building & Packaging

Prerequisites

• Windows machine with Visual Studio or MSBuild
• The Disco ICT solution cloned and built

Steps

1. Clone this repo alongside (or inside) the Disco solution directory
2. Build the Disco solution first (so assemblies are available)
3. Run the build script:

.\Build-Plugin.ps1 -DiscoSolutionPath "C:\Path\To\Disco"

This will:

• Compile the plugin against Disco's assemblies
• Generate a manifest.json (using Disco's ManifestGenerator if available, or manually)
• Package everything into a .discoPlugin file (which is just a zip)

Installing

1. In Disco ICT, go to Configuration > Plugins
2. Click Install Plugin
3. Upload the .discoPlugin file
4. Restart Disco
5. Navigate to the plugin dashboard to run comparisons

Requirements

• Disco ICT (compatible version)
• .NET Framework 4.7.2
• Active Directory connectivity from the Disco server