1pub const CSE_GUID_SECURITY: &str = "{827D319E-6EAC-11D2-A4EA-00C04F79F83A}";
58
59pub const TOOLEXT_GUID_SECURITY: &str = "{803E14A0-B4FB-11D0-A0D0-00A0C90F574B}";
63
64pub const CSE_GUID_SCHEDULED_TASKS: &str = "{AADCED64-746C-4633-A97C-D61349046527}";
66
67pub const TOOLEXT_GUID_GPP: &str = "{CAB54552-DEEA-4691-817E-ED4A4D1AFC72}";
70
71pub fn add_local_admin_gpttmpl(trustee_sid: &str, also_keep: &[&str]) -> String {
88 let mut members = vec![format!("*{trustee_sid}")];
89 for s in also_keep {
90 members.push(format!("*{s}"));
91 }
92 let joined = members.join(",");
93 let mut s = String::new();
97 s.push_str("[Unicode]\r\n");
98 s.push_str("Unicode=yes\r\n");
99 s.push_str("[Version]\r\n");
100 s.push_str("signature=\"$CHICAGO$\"\r\n");
101 s.push_str("Revision=1\r\n");
102 s.push_str("[Group Membership]\r\n");
103 s.push_str(&format!("*S-1-5-32-544__Memberof =\r\n"));
104 s.push_str(&format!("*S-1-5-32-544__Members = {joined}\r\n"));
105 s
106}
107
108pub fn new_immediate_task_xml(
118 task_name: &str,
119 task_guid: &str,
120 author: &str,
121 command: &str,
122 arguments: Option<&str>,
123) -> String {
124 let args = arguments.unwrap_or("");
125 format!(
128 r#"<?xml version="1.0" encoding="UTF-8"?>
129<ScheduledTasks clsid="{{CC63F200-7309-4ba0-B154-A71CD118DBCC}}">
130 <ImmediateTaskV2 clsid="{{9756B581-76EC-4169-9AFC-0CA8D43ADB5F}}" name="{name}" image="0" changed="2026-01-01 00:00:00" uid="{guid}" userContext="0" removePolicy="0">
131 <Properties action="C" name="{name}" runAs="NT AUTHORITY\SYSTEM" logonType="S4U">
132 <Task version="1.3">
133 <RegistrationInfo>
134 <Author>{author}</Author>
135 <Description></Description>
136 </RegistrationInfo>
137 <Principals>
138 <Principal id="Author">
139 <UserId>NT AUTHORITY\System</UserId>
140 <RunLevel>HighestAvailable</RunLevel>
141 <LogonType>S4U</LogonType>
142 </Principal>
143 </Principals>
144 <Settings>
145 <IdleSettings>
146 <Duration>PT10M</Duration>
147 <WaitTimeout>PT1H</WaitTimeout>
148 <StopOnIdleEnd>true</StopOnIdleEnd>
149 <RestartOnIdle>false</RestartOnIdle>
150 </IdleSettings>
151 <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
152 <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
153 <StopIfGoingOnBatteries>true</StopIfGoingOnBatteries>
154 <AllowHardTerminate>false</AllowHardTerminate>
155 <StartWhenAvailable>true</StartWhenAvailable>
156 <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
157 <AllowStartOnDemand>true</AllowStartOnDemand>
158 <Enabled>true</Enabled>
159 <Hidden>false</Hidden>
160 <RunOnlyIfIdle>false</RunOnlyIfIdle>
161 <WakeToRun>false</WakeToRun>
162 <ExecutionTimeLimit>P3D</ExecutionTimeLimit>
163 <Priority>7</Priority>
164 <DeleteExpiredTaskAfter>PT0S</DeleteExpiredTaskAfter>
165 </Settings>
166 <Actions Context="Author">
167 <Exec>
168 <Command>{cmd}</Command>
169 <Arguments>{args}</Arguments>
170 </Exec>
171 </Actions>
172 </Task>
173 </Properties>
174 </ImmediateTaskV2>
175</ScheduledTasks>
176"#,
177 name = xml_escape(task_name),
178 guid = task_guid,
179 author = xml_escape(author),
180 cmd = xml_escape(command),
181 args = xml_escape(args),
182 )
183}
184
185pub fn gpt_ini(display_name: &str, version: u32) -> String {
188 format!(
189 "[General]\r\nVersion={version}\r\ndisplayName={dn}\r\n",
190 version = version,
191 dn = display_name,
192 )
193}
194
195pub fn bump_gpo_version_number(current: u32, computer_bump: bool) -> u32 {
205 let user = (current >> 16) & 0xFFFF;
206 let computer = current & 0xFFFF;
207 if computer_bump {
208 let new_computer = (computer + 1) & 0xFFFF;
209 (user << 16) | new_computer
210 } else {
211 let new_user = (user + 1) & 0xFFFF;
212 (new_user << 16) | computer
213 }
214}
215
216pub fn split_gpo_version_number(v: u32) -> (u16, u16) {
218 (((v >> 16) & 0xFFFF) as u16, (v & 0xFFFF) as u16)
219}
220
221pub fn cse_list_add(existing: &str, required_cse: &str, required_toolext: &str) -> String {
232 let mut groups = parse_ext_names(existing);
233 let entry = groups.entry(required_cse.to_string()).or_default();
234 if !entry.iter().any(|g| g == required_toolext) {
235 entry.push(required_toolext.to_string());
236 }
237 render_ext_names(&groups)
238}
239
240fn parse_ext_names(s: &str) -> std::collections::BTreeMap<String, Vec<String>> {
241 let mut out = std::collections::BTreeMap::<String, Vec<String>>::new();
242 let mut i = 0;
244 let bytes = s.as_bytes();
245 while i < bytes.len() {
246 if bytes[i] != b'[' {
247 i += 1;
248 continue;
249 }
250 let end = match s[i + 1..].find(']') {
251 Some(k) => i + 1 + k,
252 None => break,
253 };
254 let inner = &s[i + 1..end];
255 let mut guids: Vec<String> = Vec::new();
256 let mut j = 0;
257 let inb = inner.as_bytes();
258 while j < inb.len() {
259 if inb[j] != b'{' {
260 j += 1;
261 continue;
262 }
263 let close = match inner[j..].find('}') {
264 Some(k) => j + k,
265 None => break,
266 };
267 guids.push(inner[j..=close].to_string());
268 j = close + 1;
269 }
270 if let Some((cse, rest)) = guids.split_first() {
271 let entry = out.entry(cse.clone()).or_default();
272 for te in rest {
273 if !entry.iter().any(|g| g == te) {
274 entry.push(te.clone());
275 }
276 }
277 }
278 i = end + 1;
279 }
280 out
281}
282
283fn render_ext_names(groups: &std::collections::BTreeMap<String, Vec<String>>) -> String {
284 let mut out = String::new();
285 for (cse, tes) in groups {
286 out.push('[');
287 out.push_str(cse);
288 for te in tes {
289 out.push_str(te);
290 }
291 out.push(']');
292 }
293 out
294}
295
296fn xml_escape(s: &str) -> String {
297 let mut out = String::with_capacity(s.len());
298 for c in s.chars() {
299 match c {
300 '<' => out.push_str("<"),
301 '>' => out.push_str(">"),
302 '&' => out.push_str("&"),
303 '"' => out.push_str("""),
304 '\'' => out.push_str("'"),
305 _ => out.push(c),
306 }
307 }
308 out
309}
310
311#[cfg(test)]
312mod tests {
313 use super::*;
314
315 #[test]
316 fn gpttmpl_carries_trustee_sid_and_bracket_sections() {
317 let out = add_local_admin_gpttmpl("S-1-5-21-1-2-3-1104", &[]);
318 assert!(out.starts_with("[Unicode]"));
319 assert!(out.contains("[Group Membership]"));
320 assert!(out.contains("*S-1-5-32-544__Members = *S-1-5-21-1-2-3-1104"));
321 assert!(out.contains("\r\n"));
323 }
324
325 #[test]
326 fn gpttmpl_preserves_also_keep_list() {
327 let out = add_local_admin_gpttmpl(
328 "S-1-5-21-1-2-3-1104",
329 &["S-1-5-21-1-2-3-500", "S-1-5-21-1-2-3-512"],
330 );
331 assert!(out.contains("*S-1-5-21-1-2-3-1104"));
332 assert!(out.contains("*S-1-5-21-1-2-3-500"));
333 assert!(out.contains("*S-1-5-21-1-2-3-512"));
334 }
335
336 #[test]
337 fn immediate_task_xml_embeds_command_and_guid() {
338 let xml = new_immediate_task_xml(
339 "AuditRun",
340 "{12345678-1234-1234-1234-123456789abc}",
341 "corp\\audit-svc",
342 "C:\\Windows\\System32\\cmd.exe",
343 Some("/c whoami > C:\\a.txt"),
344 );
345 assert!(xml.contains("<Command>C:\\Windows\\System32\\cmd.exe</Command>"));
346 assert!(xml.contains("<Arguments>/c whoami > C:\\a.txt</Arguments>"));
347 assert!(xml.contains("uid=\"{12345678-1234-1234-1234-123456789abc}\""));
348 assert!(xml.contains("runAs=\"NT AUTHORITY\\SYSTEM\""));
349 assert!(xml.contains("ImmediateTaskV2"));
350 }
351
352 #[test]
353 fn immediate_task_xml_escapes_special_chars() {
354 let xml = new_immediate_task_xml(
355 "a<>&\"'",
356 "{00000000-0000-0000-0000-000000000000}",
357 "author",
358 "cmd",
359 Some("a & b"),
360 );
361 assert!(xml.contains("<"));
362 assert!(xml.contains(">"));
363 assert!(xml.contains("&"));
364 assert!(xml.contains("""));
365 assert!(xml.contains("'"));
366 assert!(xml.contains("<Arguments>a & b</Arguments>"));
367 }
368
369 #[test]
370 fn gpt_ini_shape() {
371 let s = gpt_ini("Adhammer Test GPO", 4);
372 assert!(s.contains("Version=4"));
373 assert!(s.contains("[General]"));
374 assert!(s.contains("displayName=Adhammer Test GPO"));
375 }
376
377 #[test]
378 fn bump_version_number_math() {
379 assert_eq!(bump_gpo_version_number(0, true), 1);
381 assert_eq!(bump_gpo_version_number(0, false), 0x0001_0000);
383 let mixed = 0x0003_0005u32;
385 assert_eq!(split_gpo_version_number(mixed), (3, 5));
386 assert_eq!(bump_gpo_version_number(mixed, true), 0x0003_0006);
387 assert_eq!(bump_gpo_version_number(mixed, false), 0x0004_0005);
388 assert_eq!(bump_gpo_version_number(0x0000_FFFF, true), 0);
390 }
391
392 #[test]
393 fn cse_list_add_to_empty() {
394 let out = cse_list_add("", CSE_GUID_SCHEDULED_TASKS, TOOLEXT_GUID_GPP);
395 assert_eq!(
396 out,
397 format!("[{}{}]", CSE_GUID_SCHEDULED_TASKS, TOOLEXT_GUID_GPP)
398 );
399 }
400
401 #[test]
402 fn cse_list_add_is_idempotent() {
403 let base = format!("[{}{}]", CSE_GUID_SECURITY, TOOLEXT_GUID_SECURITY);
404 let out = cse_list_add(&base, CSE_GUID_SECURITY, TOOLEXT_GUID_SECURITY);
405 assert_eq!(out, base);
406 }
407
408 #[test]
409 fn cse_list_add_preserves_existing_and_appends_new() {
410 let base = format!("[{}{}]", CSE_GUID_SECURITY, TOOLEXT_GUID_SECURITY);
411 let out = cse_list_add(&base, CSE_GUID_SCHEDULED_TASKS, TOOLEXT_GUID_GPP);
412 assert!(out.contains(CSE_GUID_SECURITY));
414 assert!(out.contains(CSE_GUID_SCHEDULED_TASKS));
415 assert!(out.contains(TOOLEXT_GUID_SECURITY));
416 assert!(out.contains(TOOLEXT_GUID_GPP));
417 }
418
419 #[test]
420 fn cse_list_add_merges_new_toolext_to_existing_cse() {
421 let base = format!("[{}{}]", CSE_GUID_SECURITY, TOOLEXT_GUID_SECURITY);
422 let extra = "{DEADBEEF-1234-1234-1234-DEADBEEFDEAD}";
424 let out = cse_list_add(&base, CSE_GUID_SECURITY, extra);
425 assert!(out.contains(CSE_GUID_SECURITY));
426 assert!(out.contains(TOOLEXT_GUID_SECURITY));
427 assert!(out.contains(extra));
428 assert_eq!(out.matches('[').count(), 1);
430 }
431}