84 lines
2.9 KiB
Markdown
84 lines
2.9 KiB
Markdown
# Disco ICT - AD Compare Plugin
|
|
|
|
A plugin for [Disco ICT](https://github.com/garysharp/Disco) 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:
|
|
|
|
```powershell
|
|
.\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
|