# microsoft/idfix architecture

> Architecture diagram of the GitHub repository microsoft/idfix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/idfix
- Repository: https://github.com/microsoft/idfix

## Overview

IdFix is a Windows tool for finding and remediating Active Directory attribute errors before directory synchronization to Azure AD. Administrators configure a scan, the application runs directory queries and validation rules, then presents suggested fixes that can be applied or exported. The graph captures the scan and remediation path plus rule construction, settings, and duplicate tracking. Some UI wiring and later-stage scan details are unsampled; uncertain relationships are omitted. Major capabilities and the product purpose are documented in the README.

Main entry points: [`src/IdFix/FormApp.cs`](https://github.com/microsoft/idfix/blob/master/src/IdFix/FormApp.cs) (Main application), [`src/IdFix/Rules/RulesRunner.cs`](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/RulesRunner.cs) (Scan runner), [`src/IdFix/Rules/DedicatedRuleCollection.cs`](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/DedicatedRuleCollection.cs) (Dedicated rule set), [`src/IdFix/Rules/MultiTenantRuleCollection.cs`](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/MultiTenantRuleCollection.cs) (Multi-tenant rule set)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Administrator interface"]
  node_app["Main application<br/>[FormApp.cs]"]
  node_settings_ui["Settings dialog<br/>[FormSettings.cs]"]
  node_feedback["Feedback dialog<br/>[FormFeedback.cs]"]
  node_grid["Results grid<br/>[IdFixGrid.cs]"]
  node_files["File operations<br/>[Files.cs]"]
end

subgraph group_scan["Directory scan"]
  node_runner["Scan runner<br/>[RulesRunner.cs]"]
  node_connections["LDAP connections"]
end

subgraph group_validation["Validation rules"]
  node_rule_collection["Rule collection base<br/>[RuleCollection.cs]"]
  node_dedicated_rules["Dedicated rule set"]
  node_tenant_rules["Multi-tenant rule set"]
  node_composed["Composed validation<br/>[ComposedRule.cs]"]
  node_rule["Rule result model<br/>[Rule.cs]"]
  node_shared_rules["Shared validators"]
  node_dedicated_checks["Dedicated checks"]
  node_tenant_checks["Tenant checks"]
end

subgraph group_state["Settings and state"]
  node_settings["Runtime settings<br/>[SettingsManager.cs]"]
  node_duplicates["Duplicate tracking<br/>[DuplicateStore.cs]"]
  node_tlds["Valid TLD list<br/>[ValidTLDList.cs]"]
end

node_admin(("Administrator"))
node_directory[("Active Directory")]

node_admin -->|"starts scan"| node_app
node_app -->|"starts scan"| node_runner
node_app -->|"opens settings"| node_settings_ui
node_app -->|"opens feedback"| node_feedback
node_app -->|"uses files"| node_files
node_app -->|"reads settings"| node_settings
node_app -->|"applies changes"| node_connections
node_runner -->|"opens connections"| node_connections
node_connections -->|"reads connection settings"| node_settings
node_connections -->|"queries directory"| node_directory
node_runner -->|"searches entries"| node_directory
node_runner -->|"uses rules"| node_rule_collection
node_runner -->|"selects rules"| node_dedicated_rules
node_runner -->|"selects rules"| node_tenant_rules
node_runner -->|"tracks duplicates"| node_duplicates
node_dedicated_rules -->|"constructs checks"| node_composed
node_tenant_rules -->|"constructs checks"| node_composed
node_dedicated_rules -->|"uses validators"| node_shared_rules
node_tenant_rules -->|"uses validators"| node_shared_rules
node_dedicated_rules -->|"uses checks"| node_dedicated_checks
node_tenant_rules -->|"uses checks"| node_tenant_checks
node_composed -->|"executes rules"| node_rule
node_shared_rules -->|"checks duplicates"| node_duplicates
node_shared_rules -->|"checks domains"| node_tlds
node_settings_ui -->|"updates settings"| node_settings

click node_app "https://github.com/microsoft/idfix/blob/master/src/IdFix/FormApp.cs"
click node_settings_ui "https://github.com/microsoft/idfix/blob/master/src/IdFix/FormSettings.cs"
click node_feedback "https://github.com/microsoft/idfix/blob/master/src/IdFix/FormFeedback.cs"
click node_grid "https://github.com/microsoft/idfix/blob/master/src/IdFix/Controls/IdFixGrid.cs"
click node_files "https://github.com/microsoft/idfix/blob/master/src/IdFix/Files.cs"
click node_runner "https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/RulesRunner.cs"
click node_connections "https://github.com/microsoft/idfix/blob/master/src/IdFix/ConnectionManager.cs"
click node_rule_collection "https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/RuleCollection.cs"
click node_dedicated_rules "https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/DedicatedRuleCollection.cs"
click node_tenant_rules "https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/MultiTenantRuleCollection.cs"
click node_composed "https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/ComposedRule.cs"
click node_rule "https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/Rule.cs"
click node_shared_rules "https://github.com/microsoft/idfix/tree/master/src/IdFix/Rules/Shared"
click node_dedicated_checks "https://github.com/microsoft/idfix/tree/master/src/IdFix/Rules/Dedicated"
click node_tenant_checks "https://github.com/microsoft/idfix/tree/master/src/IdFix/Rules/MultiTentant"
click node_settings "https://github.com/microsoft/idfix/blob/master/src/IdFix/Settings/SettingsManager.cs"
click node_duplicates "https://github.com/microsoft/idfix/blob/master/src/IdFix/DuplicateStore.cs"
click node_tlds "https://github.com/microsoft/idfix/blob/master/src/IdFix/Settings/ValidTLDList.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_settings_ui,node_feedback,node_grid,node_files toneBlue
class node_runner,node_connections,node_directory toneAmber
class node_rule_collection,node_dedicated_rules,node_tenant_rules,node_composed,node_rule,node_shared_rules,node_dedicated_checks,node_tenant_checks toneMint
class node_settings,node_duplicates,node_tlds toneRose
class node_admin toneIndigo
```

## Components

### Administrator interface

- [Main application](https://github.com/microsoft/idfix/blob/master/src/IdFix/FormApp.cs): `src/IdFix/FormApp.cs`
- [Settings dialog](https://github.com/microsoft/idfix/blob/master/src/IdFix/FormSettings.cs): `src/IdFix/FormSettings.cs`
- [Feedback dialog](https://github.com/microsoft/idfix/blob/master/src/IdFix/FormFeedback.cs): `src/IdFix/FormFeedback.cs`
- [Results grid](https://github.com/microsoft/idfix/blob/master/src/IdFix/Controls/IdFixGrid.cs): `src/IdFix/Controls/IdFixGrid.cs`
- [File operations](https://github.com/microsoft/idfix/blob/master/src/IdFix/Files.cs): `src/IdFix/Files.cs`

### Directory scan

- [Scan runner](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/RulesRunner.cs): `src/IdFix/Rules/RulesRunner.cs`
- [LDAP connections](https://github.com/microsoft/idfix/blob/master/src/IdFix/ConnectionManager.cs): `src/IdFix/ConnectionManager.cs`

### Validation rules

- [Rule collection base](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/RuleCollection.cs): `src/IdFix/Rules/RuleCollection.cs`
- [Dedicated rule set](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/DedicatedRuleCollection.cs): `src/IdFix/Rules/DedicatedRuleCollection.cs`
- [Multi-tenant rule set](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/MultiTenantRuleCollection.cs): `src/IdFix/Rules/MultiTenantRuleCollection.cs`
- [Composed validation](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/ComposedRule.cs): `src/IdFix/Rules/ComposedRule.cs`
- [Rule result model](https://github.com/microsoft/idfix/blob/master/src/IdFix/Rules/Rule.cs): `src/IdFix/Rules/Rule.cs`
- [Shared validators](https://github.com/microsoft/idfix/tree/master/src/IdFix/Rules/Shared): `src/IdFix/Rules/Shared`
- [Dedicated checks](https://github.com/microsoft/idfix/tree/master/src/IdFix/Rules/Dedicated): `src/IdFix/Rules/Dedicated`
- [Tenant checks](https://github.com/microsoft/idfix/tree/master/src/IdFix/Rules/MultiTentant): `src/IdFix/Rules/MultiTentant`

### Settings and state

- [Runtime settings](https://github.com/microsoft/idfix/blob/master/src/IdFix/Settings/SettingsManager.cs): `src/IdFix/Settings/SettingsManager.cs`
- [Duplicate tracking](https://github.com/microsoft/idfix/blob/master/src/IdFix/DuplicateStore.cs): `src/IdFix/DuplicateStore.cs`
- [Valid TLD list](https://github.com/microsoft/idfix/blob/master/src/IdFix/Settings/ValidTLDList.cs): `src/IdFix/Settings/ValidTLDList.cs`

### Other components

- **Administrator**
- **Active Directory**

## Connections

- Administrator → Main application: starts scan (evidence: `README.md`)
- Main application → Scan runner: starts scan (evidence: `src/IdFix/FormApp.cs`)
- Main application → Settings dialog: opens settings (evidence: `src/IdFix/FormApp.cs`)
- Main application → Feedback dialog: opens feedback (evidence: `src/IdFix/FormApp.cs`)
- Main application → File operations: uses files (evidence: `src/IdFix/FormApp.cs`)
- Main application → Runtime settings: reads settings (evidence: `src/IdFix/FormApp.cs`)
- Main application → LDAP connections: applies changes (evidence: `src/IdFix/FormApp.cs`)
- Scan runner → LDAP connections: opens connections (evidence: `src/IdFix/Rules/RulesRunner.cs`)
- LDAP connections → Runtime settings: reads connection settings (evidence: `src/IdFix/ConnectionManager.cs`)
- LDAP connections → Active Directory: queries directory (evidence: `src/IdFix/ConnectionManager.cs`)
- Scan runner → Active Directory: searches entries (evidence: `src/IdFix/Rules/RulesRunner.cs`)
- Scan runner → Rule collection base: uses rules (evidence: `src/IdFix/Rules/RulesRunner.cs`)
- Scan runner → Dedicated rule set: selects rules (evidence: `src/IdFix/Rules/RulesRunner.cs`)
- Scan runner → Multi-tenant rule set: selects rules (evidence: `src/IdFix/Rules/RulesRunner.cs`)
- Scan runner → Duplicate tracking: tracks duplicates (evidence: `src/IdFix/Rules/RulesRunner.cs`)
- Dedicated rule set → Composed validation: constructs checks (evidence: `src/IdFix/Rules/DedicatedRuleCollection.cs`)
- Multi-tenant rule set → Composed validation: constructs checks (evidence: `src/IdFix/Rules/MultiTenantRuleCollection.cs`)
- Dedicated rule set → Shared validators: uses validators (evidence: `src/IdFix/Rules/DedicatedRuleCollection.cs`)
- Multi-tenant rule set → Shared validators: uses validators (evidence: `src/IdFix/Rules/MultiTenantRuleCollection.cs`)
- Dedicated rule set → Dedicated checks: uses checks (evidence: `src/IdFix/Rules/DedicatedRuleCollection.cs`)
- Multi-tenant rule set → Tenant checks: uses checks (evidence: `src/IdFix/Rules/MultiTenantRuleCollection.cs`)
- Composed validation → Rule result model: executes rules (evidence: `src/IdFix/Rules/ComposedRule.cs`)
- Shared validators → Duplicate tracking: checks duplicates (evidence: `src/IdFix/Rules/Shared/NoDuplicatesRule.cs`)
- Shared validators → Valid TLD list: checks domains (evidence: `src/IdFix/Rules/Shared/RFC2822Rule.cs`)
- Settings dialog → Runtime settings: updates settings (evidence: `src/IdFix/FormSettings.cs`)
