fix: address injection vulnerabilities from red team audit (#171)

- Validate engine.model against [A-Za-z0-9._:-]+ to prevent shell
  injection via single-quote breakout in AWF command (Finding 1, High)
- Validate tools.bash entries reject single quotes (same attack surface)
- Reject ADO template expressions (${{ and $() in front matter name
  and description fields to prevent secret disclosure (Finding 2, Medium)
- Reject newlines in name/description to prevent YAML structure injection
- Escape single quotes in pipeline trigger config by doubling them per
  YAML spec (Finding 3, Medium)
- Quote {{ allowed_domains }} in base.yml template to prevent AWF
  argument injection via spaces in domain patterns (Finding 4, Medium)
- Clarify network.blocked docs: exact-match removal, not wildcard-aware
  blocking (Finding 6, Low)
- Add 9 security validation test cases

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: jamesadevine

AGENTS.md

@@ -189,7 +189,7 @@ teardown:                      # separate job AFTER safe outputs processing
 network:                       # optional network policy (standalone target only)
   allow:                       # additional allowed host patterns
     - "*.mycompany.com"
-  blocked:                     # blocked host patterns (takes precedence over allow)
+  blocked:                     # blocked host patterns (removes exact entries from the allow list)
     - "evil.example.com"
 permissions:                   # optional ADO access token configuration
   read: my-read-arm-connection   # ARM service connection for read-only ADO access (Stage 1 agent)

README.md

@@ -378,7 +378,7 @@ reachable. The allowlist is built from:
 1. **Core domains** — Azure DevOps, GitHub, Microsoft auth, Azure storage
 2. **MCP domains** — automatically added per enabled MCP
 3. **User domains** — from `network.allow` in front matter
-4. **Minus blocked** — `network.blocked` entries are removed
+4. **Minus blocked** — `network.blocked` entries are removed by exact match (wildcard patterns like `*.example.com` are not affected by blocking a specific subdomain)
 
 ```yaml
 network:

src/compile/common.rs

@@ -145,21 +145,48 @@ fn is_valid_parameter_name(name: &str) -> bool {
         && chars.all(|c| c.is_ascii_alphanumeric() || c == '_')
 }
 
-/// Reject ADO template expressions (`${{`) and macro expressions (`$(`) in a string value.
-/// Parameter definitions should only contain literal values — expressions could enable
-/// information disclosure or logic manipulation in the generated pipeline.
+/// Reject ADO template expressions (`${{`), macro expressions (`$(`), and runtime
+/// expressions (`$[`) in a string value. Parameter definitions should only contain
+/// literal values — expressions could enable information disclosure or logic manipulation
+/// in the generated pipeline.
 fn reject_ado_expressions(value: &str, param_name: &str, field_name: &str) -> Result<()> {
-    if value.contains("${{") || value.contains("$(") {
+    if value.contains("${{") || value.contains("$(") || value.contains("$[") {
         anyhow::bail!(
-            "Parameter '{}' field '{}' contains an ADO expression ('${{{{' or '$(') which is not \
-             allowed in parameter definitions. Use literal values only.",
+            "Parameter '{}' field '{}' contains an ADO expression ('${{{{', '$(', or '$[') which \
+             is not allowed in parameter definitions. Use literal values only.",
             param_name,
             field_name,
         );
     }
     Ok(())
 }
 
+/// Validate front matter `name` and `description` fields.
+///
+/// These values are substituted directly into the pipeline YAML template and must not
+/// contain ADO expressions (`${{`, `$(`, `$[`) which could disclose secrets or manipulate
+/// pipeline logic. Newlines are also rejected to prevent YAML structure injection.
+pub fn validate_front_matter_identity(front_matter: &FrontMatter) -> Result<()> {
+    for (field, value) in [("name", &front_matter.name), ("description", &front_matter.description)] {
+        if value.contains("${{") || value.contains("$(") || value.contains("$[") {
+            anyhow::bail!(
+                "Front matter '{}' contains an ADO expression ('${{{{', '$(', or '$[') which is not allowed. \
+                 Use literal values only. Found: '{}'",
+                field,
+                value,
+            );
+        }
+        if value.contains('\n') || value.contains('\r') {
+            anyhow::bail!(
+                "Front matter '{}' must be a single line (no newlines). \
+                 Multi-line values could inject YAML structure into the generated pipeline.",
+                field,
+            );
+        }
+    }
+    Ok(())
+}
+
 /// Reject ADO expressions in a serde_yaml::Value, recursing into strings within sequences.
 fn reject_ado_expressions_in_value(
     value: &serde_yaml::Value,
@@ -265,10 +292,10 @@ pub fn generate_pipeline_resources(triggers: &Option<TriggerConfig>) -> Result<S
     let mut yaml = String::from("pipelines:\n");
 
     yaml.push_str(&format!("    - pipeline: {}\n", resource_id));
-    yaml.push_str(&format!("      source: '{}'\n", pipeline.name));
+    yaml.push_str(&format!("      source: '{}'\n", pipeline.name.replace('\'', "''")));
 
     if let Some(project) = &pipeline.project {
-        yaml.push_str(&format!("      project: '{}'\n", project));
+        yaml.push_str(&format!("      project: '{}'\n", project.replace('\'', "''")));
     }
 
     // If no branches specified, trigger on any branch
@@ -279,7 +306,7 @@ pub fn generate_pipeline_resources(triggers: &Option<TriggerConfig>) -> Result<S
         yaml.push_str("        branches:\n");
         yaml.push_str("          include:\n");
         for branch in &pipeline.branches {
-            yaml.push_str(&format!("            - {}\n", branch));
+            yaml.push_str(&format!("            - '{}'\n", branch.replace('\'', "''")));
         }
     }
 
@@ -388,7 +415,7 @@ const DEFAULT_BASH_COMMANDS: &[&str] = &[
 ];
 
 /// Generate copilot CLI params from front matter configuration
-pub fn generate_copilot_params(front_matter: &FrontMatter) -> String {
+pub fn generate_copilot_params(front_matter: &FrontMatter) -> Result<String> {
     let mut allowed_tools: Vec<String> = vec!["github".to_string(), "safeoutputs".to_string()];
 
     // Edit tool: enabled by default, can be disabled with `edit: false`
@@ -422,12 +449,34 @@ pub fn generate_copilot_params(front_matter: &FrontMatter) -> String {
         }
     };
     for cmd in bash_commands {
+        // Reject single quotes in bash commands — copilot_params are embedded inside
+        // a single-quoted bash string in the AWF command.
+        if cmd.contains('\'') {
+            anyhow::bail!(
+                "Bash command '{}' contains a single quote, which is not allowed \
+                 (would break AWF shell quoting).",
+                cmd
+            );
+        }
         allowed_tools.push(format!("shell({})", cmd));
     }
 
     let mut params = Vec::new();
 
-    params.push(format!("--model {}", front_matter.engine.model()));
+    // Validate model name to prevent shell injection — copilot_params are embedded
+    // inside a single-quoted bash string in the AWF command.
+    let model = front_matter.engine.model();
+    if !model
+        .chars()
+        .all(|c| c.is_ascii_alphanumeric() || matches!(c, '.' | '_' | ':' | '-'))
+    {
+        anyhow::bail!(
+            "Model name '{}' contains invalid characters. \
+             Only ASCII alphanumerics, '.', '_', ':', and '-' are allowed.",
+            model
+        );
+    }
+    params.push(format!("--model {}", model));
     if front_matter.engine.max_turns().is_some() {
         eprintln!(
             "Warning: Agent '{}' has max-turns set, but max-turns is not supported by Copilot CLI \
@@ -458,7 +507,7 @@ pub fn generate_copilot_params(front_matter: &FrontMatter) -> String {
         }
     }
 
-    params.join(" ")
+    Ok(params.join(" "))
 }
 
 /// Compute the effective workspace based on explicit setting and checkout configuration.
@@ -1194,7 +1243,7 @@ mod tests {
             cache_memory: None,
             azure_devops: None,
         });
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(params.contains("--allow-tool \"shell(:*)\""));
     }
 
@@ -1207,7 +1256,7 @@ mod tests {
             cache_memory: None,
             azure_devops: None,
         });
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("shell("));
     }
 
@@ -1221,7 +1270,7 @@ mod tests {
                 ..Default::default()
             }),
         );
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--mcp my-tool"));
     }
 
@@ -1230,7 +1279,7 @@ mod tests {
         let mut fm = minimal_front_matter();
         fm.mcp_servers
             .insert("ado".to_string(), McpConfig::Enabled(true));
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         // Copilot CLI has no built-in MCPs — all MCPs are handled via the MCP firewall
         assert!(!params.contains("--mcp ado"));
     }
@@ -1241,14 +1290,14 @@ mod tests {
             "---\nname: test\ndescription: test\nengine:\n  model: claude-opus-4.5\n  max-turns: 50\n---\n",
         )
         .unwrap();
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--max-turns"), "max-turns should not be emitted as a CLI arg");
     }
 
     #[test]
     fn test_copilot_params_no_max_turns_when_simple_engine() {
         let fm = minimal_front_matter();
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--max-turns"));
     }
 
@@ -1258,14 +1307,14 @@ mod tests {
             "---\nname: test\ndescription: test\nengine:\n  model: claude-opus-4.5\n  timeout-minutes: 30\n---\n",
         )
         .unwrap();
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--max-timeout"), "timeout-minutes should not be emitted as a CLI arg");
     }
 
     #[test]
     fn test_copilot_params_no_max_timeout_when_simple_engine() {
         let fm = minimal_front_matter();
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--max-timeout"));
     }
 
@@ -1275,7 +1324,7 @@ mod tests {
             "---\nname: test\ndescription: test\nengine:\n  model: claude-opus-4.5\n  max-turns: 0\n---\n",
         )
         .unwrap();
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--max-turns"), "max-turns should not be emitted as a CLI arg");
     }
 
@@ -1285,7 +1334,7 @@ mod tests {
             "---\nname: test\ndescription: test\nengine:\n  model: claude-opus-4.5\n  timeout-minutes: 0\n---\n",
         )
         .unwrap();
-        let params = generate_copilot_params(&fm);
+        let params = generate_copilot_params(&fm).unwrap();
         assert!(!params.contains("--max-timeout"), "timeout-minutes should not be emitted as a CLI arg");
     }
 
@@ -2200,4 +2249,109 @@ mod tests {
             "None service connection should produce empty env block"
         );
     }
+
+    // ─── Security validation tests ────────────────────────────────────────────
+
+    #[test]
+    fn test_model_name_rejects_single_quote() {
+        let (mut fm, _) = parse_markdown(
+            "---\nname: test\ndescription: test\nengine: claude-opus-4.5\n---\n",
+        )
+        .unwrap();
+        fm.engine = crate::compile::types::EngineConfig::Simple("model' && echo pwned".to_string());
+        let result = generate_copilot_params(&fm);
+        assert!(result.is_err());
+        assert!(result.unwrap_err().to_string().contains("invalid characters"));
+    }
+
+    #[test]
+    fn test_model_name_rejects_space() {
+        let mut fm = minimal_front_matter();
+        fm.engine = crate::compile::types::EngineConfig::Simple("model && curl evil.com".to_string());
+        let result = generate_copilot_params(&fm);
+        assert!(result.is_err());
+    }
+
+    #[test]
+    fn test_model_name_allows_valid_names() {
+        for name in &["claude-opus-4.5", "gpt-5.2-codex", "gemini-3-pro-preview", "my_model:latest"] {
+            let mut fm = minimal_front_matter();
+            fm.engine = crate::compile::types::EngineConfig::Simple(name.to_string());
+            let result = generate_copilot_params(&fm);
+            assert!(result.is_ok(), "Model name '{}' should be valid", name);
+        }
+    }
+
+    #[test]
+    fn test_bash_command_rejects_single_quote() {
+        let mut fm = minimal_front_matter();
+        fm.tools = Some(crate::compile::types::ToolsConfig {
+            bash: Some(vec!["cat'".to_string()]),
+            edit: None,
+            cache_memory: None,
+            azure_devops: None,
+        });
+        let result = generate_copilot_params(&fm);
+        assert!(result.is_err());
+        assert!(result.unwrap_err().to_string().contains("single quote"));
+    }
+
+    #[test]
+    fn test_validate_front_matter_identity_rejects_ado_expression_in_name() {
+        let mut fm = minimal_front_matter();
+        fm.name = "My Agent ${{ variables['System.AccessToken'] }}".to_string();
+        let result = validate_front_matter_identity(&fm);
+        assert!(result.is_err());
+        assert!(result.unwrap_err().to_string().contains("ADO expression"));
+    }
+
+    #[test]
+    fn test_validate_front_matter_identity_rejects_macro_in_description() {
+        let mut fm = minimal_front_matter();
+        fm.description = "Agent $(System.AccessToken)".to_string();
+        let result = validate_front_matter_identity(&fm);
+        assert!(result.is_err());
+        assert!(result.unwrap_err().to_string().contains("ADO expression"));
+    }
+
+    #[test]
+    fn test_validate_front_matter_identity_rejects_newline_in_name() {
+        let mut fm = minimal_front_matter();
+        fm.name = "My Agent\ninjected: true".to_string();
+        let result = validate_front_matter_identity(&fm);
+        assert!(result.is_err());
+        assert!(result.unwrap_err().to_string().contains("single line"));
+    }
+
+    #[test]
+    fn test_validate_front_matter_identity_allows_valid_values() {
+        let mut fm = minimal_front_matter();
+        fm.name = "Daily Code Review Agent".to_string();
+        fm.description = "Reviews code daily for quality issues".to_string();
+        let result = validate_front_matter_identity(&fm);
+        assert!(result.is_ok());
+    }
+
+    #[test]
+    fn test_validate_front_matter_identity_rejects_runtime_expression() {
+        let mut fm = minimal_front_matter();
+        fm.name = "Agent $[variables['System.AccessToken']]".to_string();
+        let result = validate_front_matter_identity(&fm);
+        assert!(result.is_err());
+        assert!(result.unwrap_err().to_string().contains("ADO expression"));
+    }
+
+    #[test]
+    fn test_pipeline_resources_escapes_single_quotes() {
+        let triggers = Some(TriggerConfig {
+            pipeline: Some(crate::compile::types::PipelineTrigger {
+                name: "Build's Pipeline".to_string(),
+                project: Some("My'Project".to_string()),
+                branches: vec!["main".to_string()],
+            }),
+        });
+        let result = generate_pipeline_resources(&triggers).unwrap();
+        assert!(result.contains("source: 'Build''s Pipeline'"));
+        assert!(result.contains("project: 'My''Project'"));
+    }
 }

src/compile/onees.rs

@@ -24,9 +24,9 @@ use super::common::{
     generate_job_timeout, generate_parameters, generate_pipeline_path,
     generate_pipeline_resources, generate_pr_trigger, generate_repositories, generate_schedule,
     generate_source_path, generate_working_directory, is_custom_mcp, replace_with_indent,
-    validate_comment_target, validate_resolve_pr_thread_statuses,
-    validate_submit_pr_review_events, validate_update_pr_votes,
-    validate_update_work_item_target, validate_write_permissions,
+    validate_comment_target, validate_front_matter_identity,
+    validate_resolve_pr_thread_statuses, validate_submit_pr_review_events,
+    validate_update_pr_votes, validate_update_work_item_target, validate_write_permissions,
 };
 use super::types::{FrontMatter, McpConfig};
 
@@ -48,6 +48,9 @@ impl Compiler for OneESCompiler {
     ) -> Result<String> {
         info!("Compiling for 1ES target");
 
+        // Validate inputs early, before any values are used in template substitution
+        validate_front_matter_identity(front_matter)?;
+
         // Load 1ES template
         let template = include_str!("../../templates/1es-base.yml");
 
@@ -61,7 +64,7 @@ impl Compiler for OneESCompiler {
         let repositories = generate_repositories(&front_matter.repositories);
         let checkout_steps = generate_checkout_steps(&front_matter.checkout);
         let checkout_self = generate_checkout_self();
-        let copilot_params = generate_copilot_params(front_matter);
+        let copilot_params = generate_copilot_params(front_matter)?;
         let has_memory = front_matter
             .tools
             .as_ref()