Skip to main content

cmtraceopen_parser/dsregcmd/
models.rs

1use chrono::{DateTime, Utc};
2use serde::{Deserialize, Serialize};
3
4use crate::intune::models::{EventLogAnalysis, IntuneDiagnosticSeverity};
5
6#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default)]
7pub enum DsregcmdJoinType {
8    HybridEntraIdJoined,
9    EntraIdJoined,
10    NotJoined,
11    #[default]
12    Unknown,
13}
14
15#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default)]
16#[serde(rename_all = "snake_case")]
17pub enum DsregcmdDiagnosticPhase {
18    Precheck,
19    Discover,
20    Auth,
21    Join,
22    PostJoin,
23    #[default]
24    Unknown,
25}
26
27#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default)]
28#[serde(rename_all = "snake_case")]
29pub enum DsregcmdCaptureConfidence {
30    High,
31    #[default]
32    Medium,
33    Low,
34}
35
36#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
37#[serde(rename_all = "snake_case")]
38pub enum DsregcmdEvidenceSource {
39    Dsregcmd,
40    PolicyManagerCurrent,
41    PolicyManagerProvider,
42    PolicyManagerComparison,
43    WindowsPolicyMachine,
44    WindowsPolicyUser,
45}
46
47#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
48#[serde(rename_all = "camelCase")]
49pub struct DsregcmdPolicyEvidenceValue {
50    pub display_value: Option<bool>,
51    pub current_value: Option<bool>,
52    pub provider_value: Option<bool>,
53    pub source: Option<DsregcmdEvidenceSource>,
54    pub note: Option<String>,
55}
56
57#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
58#[serde(rename_all = "camelCase")]
59pub struct DsregcmdWhfbPolicyEvidence {
60    pub policy_enabled: DsregcmdPolicyEvidenceValue,
61    pub post_logon_enabled: DsregcmdPolicyEvidenceValue,
62    pub pin_recovery_enabled: DsregcmdPolicyEvidenceValue,
63    pub require_security_device: DsregcmdPolicyEvidenceValue,
64    pub use_certificate_for_on_prem_auth: DsregcmdPolicyEvidenceValue,
65    pub use_cloud_trust_for_on_prem_auth: DsregcmdPolicyEvidenceValue,
66    #[serde(default)]
67    pub artifact_paths: Vec<String>,
68}
69
70#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
71#[serde(rename_all = "camelCase")]
72pub struct DsregcmdJoinState {
73    pub azure_ad_joined: Option<bool>,
74    pub domain_joined: Option<bool>,
75    pub workplace_joined: Option<bool>,
76    pub enterprise_joined: Option<bool>,
77}
78
79#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
80#[serde(rename_all = "camelCase")]
81pub struct DsregcmdDeviceDetails {
82    pub device_id: Option<String>,
83    pub thumbprint: Option<String>,
84    pub device_certificate_validity: Option<String>,
85    pub key_container_id: Option<String>,
86    pub key_provider: Option<String>,
87    pub tpm_protected: Option<bool>,
88    pub device_auth_status: Option<String>,
89}
90
91#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
92#[serde(rename_all = "camelCase")]
93pub struct DsregcmdTenantDetails {
94    pub tenant_id: Option<String>,
95    pub tenant_name: Option<String>,
96    pub domain_name: Option<String>,
97    pub idp: Option<String>,
98}
99
100#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
101#[serde(rename_all = "camelCase")]
102pub struct DsregcmdManagementDetails {
103    pub mdm_url: Option<String>,
104    pub mdm_compliance_url: Option<String>,
105    pub mdm_tou_url: Option<String>,
106    pub settings_url: Option<String>,
107    pub device_management_srv_ver: Option<String>,
108    pub device_management_srv_url: Option<String>,
109    pub device_management_srv_id: Option<String>,
110}
111
112#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
113#[serde(rename_all = "camelCase")]
114pub struct DsregcmdServiceEndpoints {
115    pub auth_code_url: Option<String>,
116    pub access_token_url: Option<String>,
117    pub join_srv_version: Option<String>,
118    pub join_srv_url: Option<String>,
119    pub join_srv_id: Option<String>,
120    pub key_srv_version: Option<String>,
121    pub key_srv_url: Option<String>,
122    pub key_srv_id: Option<String>,
123    pub web_authn_srv_version: Option<String>,
124    pub web_authn_srv_url: Option<String>,
125    pub web_authn_srv_id: Option<String>,
126}
127
128#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
129#[serde(rename_all = "camelCase")]
130pub struct DsregcmdUserState {
131    pub ngc_set: Option<bool>,
132    pub ngc_key_id: Option<String>,
133    pub can_reset: Option<String>,
134    pub wam_default_set: Option<bool>,
135    pub wam_default_authority: Option<String>,
136    pub wam_default_id: Option<String>,
137    pub wam_default_guid: Option<String>,
138    pub is_device_joined: Option<bool>,
139    pub is_user_azure_ad: Option<bool>,
140    pub policy_enabled: Option<bool>,
141    pub post_logon_enabled: Option<bool>,
142    pub device_eligible: Option<bool>,
143    pub session_is_not_remote: Option<bool>,
144}
145
146#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
147#[serde(rename_all = "camelCase")]
148pub struct DsregcmdSsoState {
149    pub azure_ad_prt: Option<bool>,
150    pub azure_ad_prt_authority: Option<String>,
151    pub azure_ad_prt_update_time: Option<String>,
152    pub acquire_prt_diagnostics: Option<String>,
153    pub enterprise_prt: Option<bool>,
154    pub enterprise_prt_update_time: Option<String>,
155    pub enterprise_prt_expiry_time: Option<String>,
156    pub enterprise_prt_authority: Option<String>,
157    pub on_prem_tgt: Option<bool>,
158    pub cloud_tgt: Option<bool>,
159    pub adfs_refresh_token: Option<bool>,
160    pub adfs_ra_is_ready: Option<bool>,
161    pub kerb_top_level_names: Option<String>,
162}
163
164#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
165#[serde(rename_all = "camelCase")]
166pub struct DsregcmdDiagnosticFields {
167    pub previous_prt_attempt: Option<String>,
168    pub attempt_status: Option<String>,
169    pub user_identity: Option<String>,
170    pub credential_type: Option<String>,
171    pub correlation_id: Option<String>,
172    pub endpoint_uri: Option<String>,
173    pub http_method: Option<String>,
174    pub http_error: Option<String>,
175    pub http_status: Option<u16>,
176    pub request_id: Option<String>,
177    pub diagnostics_reference: Option<String>,
178    pub user_context: Option<String>,
179    pub client_time: Option<String>,
180}
181
182#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
183#[serde(rename_all = "camelCase")]
184pub struct DsregcmdPreJoinTests {
185    pub ad_connectivity_test: Option<String>,
186    pub ad_configuration_test: Option<String>,
187    pub drs_discovery_test: Option<String>,
188    pub drs_connectivity_test: Option<String>,
189    pub token_acquisition_test: Option<String>,
190    pub fallback_to_sync_join: Option<String>,
191}
192
193#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
194#[serde(rename_all = "camelCase")]
195pub struct DsregcmdRegistrationState {
196    pub previous_registration: Option<String>,
197    pub error_phase: Option<String>,
198    pub cert_enrollment: Option<String>,
199    pub logon_cert_template_ready: Option<String>,
200    pub pre_req_result: Option<String>,
201    pub client_error_code: Option<String>,
202    pub server_error_code: Option<String>,
203    pub server_message: Option<String>,
204    pub server_error_description: Option<String>,
205}
206
207#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
208#[serde(rename_all = "camelCase")]
209pub struct DsregcmdPostJoinDiagnostics {
210    pub aad_recovery_enabled: Option<bool>,
211    pub key_sign_test: Option<String>,
212}
213
214#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
215#[serde(rename_all = "camelCase")]
216pub struct DsregcmdFacts {
217    pub join_state: DsregcmdJoinState,
218    pub device_details: DsregcmdDeviceDetails,
219    pub tenant_details: DsregcmdTenantDetails,
220    pub management_details: DsregcmdManagementDetails,
221    pub service_endpoints: DsregcmdServiceEndpoints,
222    pub user_state: DsregcmdUserState,
223    pub sso_state: DsregcmdSsoState,
224    pub diagnostics: DsregcmdDiagnosticFields,
225    pub pre_join_tests: DsregcmdPreJoinTests,
226    pub registration: DsregcmdRegistrationState,
227    pub post_join_diagnostics: DsregcmdPostJoinDiagnostics,
228}
229
230#[derive(Debug, Clone, Serialize, Deserialize, Default)]
231#[serde(rename_all = "camelCase")]
232pub struct DsregcmdDerived {
233    pub join_type: DsregcmdJoinType,
234    pub join_type_label: String,
235    pub dominant_phase: DsregcmdDiagnosticPhase,
236    pub phase_summary: String,
237    pub capture_confidence: DsregcmdCaptureConfidence,
238    pub capture_confidence_reason: String,
239    pub mdm_enrolled: Option<bool>,
240    pub missing_mdm: Option<bool>,
241    pub compliance_url_present: Option<bool>,
242    pub missing_compliance_url: Option<bool>,
243    pub azure_ad_prt_present: Option<bool>,
244    pub stale_prt: Option<bool>,
245    pub prt_last_update: Option<DateTime<Utc>>,
246    pub prt_reference_time: Option<DateTime<Utc>>,
247    pub prt_age_hours: Option<f64>,
248    pub tpm_protected: Option<bool>,
249    pub certificate_valid_from: Option<DateTime<Utc>>,
250    pub certificate_valid_to: Option<DateTime<Utc>>,
251    pub certificate_expiring_soon: Option<bool>,
252    pub certificate_days_remaining: Option<i64>,
253    pub network_error_code: Option<String>,
254    pub has_network_error: bool,
255    pub remote_session_system: Option<bool>,
256}
257
258#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
259#[serde(rename_all = "camelCase")]
260pub struct DsregcmdDiagnosticInsight {
261    pub id: String,
262    pub severity: IntuneDiagnosticSeverity,
263    pub category: String,
264    pub title: String,
265    pub summary: String,
266    pub evidence: Vec<String>,
267    pub next_checks: Vec<String>,
268    #[serde(default)]
269    pub suggested_fixes: Vec<String>,
270}
271
272#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
273#[serde(rename_all = "camelCase")]
274pub struct DsregcmdOsVersionEvidence {
275    pub current_build: Option<String>,
276    pub display_version: Option<String>,
277    pub product_name: Option<String>,
278    pub ubr: Option<u32>,
279    pub edition_id: Option<String>,
280}
281
282#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
283#[serde(rename_all = "camelCase")]
284pub struct DsregcmdProxyEvidence {
285    pub proxy_enabled: Option<bool>,
286    pub proxy_server: Option<String>,
287    pub proxy_override: Option<String>,
288    pub auto_config_url: Option<String>,
289    pub wpad_detected: bool,
290    pub winhttp_proxy: Option<String>,
291}
292
293#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
294#[serde(rename_all = "camelCase")]
295pub struct DsregcmdEnrollmentEntry {
296    pub guid: Option<String>,
297    pub upn: Option<String>,
298    pub provider_id: Option<String>,
299    pub enrollment_state: Option<u32>,
300}
301
302#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
303#[serde(rename_all = "camelCase")]
304pub struct DsregcmdEnrollmentEvidence {
305    pub enrollment_count: u32,
306    #[serde(default)]
307    pub enrollments: Vec<DsregcmdEnrollmentEntry>,
308}
309
310#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
311#[serde(rename_all = "camelCase")]
312pub struct DsregcmdConnectivityResult {
313    pub endpoint: String,
314    pub reachable: bool,
315    pub status_code: Option<u16>,
316    pub latency_ms: Option<u64>,
317    pub error_message: Option<String>,
318    pub timestamp: String,
319}
320
321#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
322#[serde(rename_all = "camelCase")]
323pub struct DsregcmdScpQueryResult {
324    pub scp_found: bool,
325    pub tenant_domain: Option<String>,
326    pub azuread_id: Option<String>,
327    pub keywords: Vec<String>,
328    pub domain_controller: Option<String>,
329    pub error: Option<String>,
330}
331
332#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
333#[serde(rename_all = "camelCase")]
334pub struct DsregcmdActiveEvidence {
335    pub connectivity_tests: Vec<DsregcmdConnectivityResult>,
336    pub scp_query: Option<DsregcmdScpQueryResult>,
337}
338
339#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
340#[serde(rename_all = "camelCase")]
341pub struct DsregcmdScheduledTaskEvidence {
342    #[serde(default)]
343    pub enterprise_mgmt_guids: Vec<String>,
344}
345
346#[derive(Debug, Clone, Serialize, Deserialize, Default)]
347#[serde(rename_all = "camelCase")]
348pub struct DsregcmdAnalysisResult {
349    pub facts: DsregcmdFacts,
350    pub derived: DsregcmdDerived,
351    #[serde(default)]
352    pub diagnostics: Vec<DsregcmdDiagnosticInsight>,
353    #[serde(default)]
354    pub policy_evidence: DsregcmdWhfbPolicyEvidence,
355    #[serde(default)]
356    pub os_version: Option<DsregcmdOsVersionEvidence>,
357    #[serde(default)]
358    pub proxy_evidence: Option<DsregcmdProxyEvidence>,
359    #[serde(default)]
360    pub enrollment_evidence: Option<DsregcmdEnrollmentEvidence>,
361    #[serde(default)]
362    pub active_evidence: Option<DsregcmdActiveEvidence>,
363    #[serde(default)]
364    pub scheduled_task_evidence: Option<DsregcmdScheduledTaskEvidence>,
365    #[serde(default)]
366    pub event_log_analysis: Option<EventLogAnalysis>,
367}
368
369#[cfg(test)]
370mod tests {
371    use super::{
372        DsregcmdCaptureConfidence, DsregcmdDiagnosticPhase, DsregcmdEvidenceSource,
373        DsregcmdJoinType,
374    };
375
376    #[test]
377    fn join_type_serializes_with_pascal_case_variants() {
378        assert_eq!(
379            serde_json::to_string(&DsregcmdJoinType::HybridEntraIdJoined)
380                .expect("serialize join type"),
381            "\"HybridEntraIdJoined\""
382        );
383        assert_eq!(
384            serde_json::to_string(&DsregcmdJoinType::EntraIdJoined).expect("serialize join type"),
385            "\"EntraIdJoined\""
386        );
387        assert_eq!(
388            serde_json::to_string(&DsregcmdJoinType::NotJoined).expect("serialize join type"),
389            "\"NotJoined\""
390        );
391        assert_eq!(
392            serde_json::to_string(&DsregcmdJoinType::Unknown).expect("serialize join type"),
393            "\"Unknown\""
394        );
395    }
396
397    #[test]
398    fn phase_and_confidence_serialize_with_expected_strings() {
399        assert_eq!(
400            serde_json::to_string(&DsregcmdDiagnosticPhase::PostJoin)
401                .expect("serialize diagnostic phase"),
402            "\"post_join\""
403        );
404        assert_eq!(
405            serde_json::to_string(&DsregcmdCaptureConfidence::High)
406                .expect("serialize capture confidence"),
407            "\"high\""
408        );
409        assert_eq!(
410            serde_json::to_string(&DsregcmdEvidenceSource::PolicyManagerCurrent)
411                .expect("serialize evidence source"),
412            "\"policy_manager_current\""
413        );
414        assert_eq!(
415            serde_json::to_string(&DsregcmdEvidenceSource::WindowsPolicyMachine)
416                .expect("serialize evidence source"),
417            "\"windows_policy_machine\""
418        );
419    }
420}