forge-security-review

name	forge-security-review
description	Performs a white-box security review of Atlassian Forge apps using structured, Forge-specific security rules and evidence-driven reporting. Use when the user asks for a Forge security review, security audit, vuln assessment, pentest-style code review, authz review, tenant isolation analysis, web trigger hardening, or static analysis execution for a Forge app.
license	Apache-2.0
labels	["forge","security","review","audit","atlassian"]
maintainer	atlassian-developer
namespace	cloud

Forge Security Review

Runs a Forge-focused white-box security review and reports validated findings with exploitability, impact, evidence, and remediation guidance.

Token-Efficient Default

Use manifest-driven routing by default to reduce token usage. Do not load every rule file up front.

Rule Assets

The review rules are packaged with this skill under assets/security-rules/:

• Global baseline: assets/security-rules/_global-forge.mdc
• Category indexes: assets/security-rules/forge-*/_index-*.mdc
• Category deep checks: assets/security-rules/forge-*/*.mdc

Execution Mandate

When this skill is triggered:

1. Run static analysis first from this skill directory:

• scripts/run_static_analysis.sh <forge-project-root-directory>
• use .ps1 script for windows

2. Read manifest.yml first before any deep code review.
3. Load assets/security-rules/_global-forge.mdc first.
4. Load only relevant category index rules based on manifest and code signals.
5. Load deep subrules only when the matching detection heuristics are triggered by real code patterns.
6. Perform an evidence-based security review across:
   • AuthN/AuthZ
   • Injection and input validation
   • Tenant isolation and cross-tenant leakage
   • Secrets and storage
   • Egress/remotes/CSP and manifest permissions
   • Public entry points (web triggers)
   • Agent and miscellaneous Forge security risks
7. Do not modify app code unless the user explicitly requests fixes.
8. Write all scan outputs and generated artifacts to security-audit-artifacts/.

Rule Routing Workflow

Phase 1: Reconnaissance (Mandatory)

Read manifest.yml first and extract:

• permissions.scopes
• permissions.external.fetch
• permissions.content.scripts
• modules (resolver/webtrigger/scheduledTrigger/rovo/etc.)
• remotes
• app.runtime.name

Build an execution map:

• UI modules -> bridge calls -> resolvers/functions
• External entry points (web triggers, events, schedules)
• api.asUser() vs api.asApp() paths
• Outbound fetch destinations

Phase 2: Index Rule Selection (Two-Tier Loading)

Always load first:

• assets/security-rules/_global-forge.mdc

Then load only relevant category index rules:

Signal	Load
Any meaningful scope usage, mutations, or asApp() usage	assets/security-rules/forge-authn-authz/_index-authn-authz.mdc
webtrigger or scheduledTrigger modules	assets/security-rules/forge-webtrigger-entrypoints/_index-webtrigger-entrypoints.mdc
permissions.external.fetch or remotes	assets/security-rules/forge-egress-remotes/_index-egress-remotes.mdc
SQL APIs or untrusted input reaching resolver sinks	assets/security-rules/forge-injection/_index-injection.mdc
Multi-tenant patterns, module/global state, cache reuse	assets/security-rules/forge-tenant-isolation/_index-tenant-isolation.mdc
Credentials/tokens/secrets handling	assets/security-rules/forge-secrets-storage/_index-secrets-storage.mdc
Unsafe CSP or likely scope/config misconfiguration	assets/security-rules/forge-manifest-config/_index-manifest-config.mdc
Rovo modules/actions	assets/security-rules/forge-rovo-agents/_index-rovo-agents.mdc
Baseline logging/error/static analysis concerns	assets/security-rules/forge-auditing/_index-auditing.mdc
Dependency/package risk review	assets/security-rules/forge-misc/_index-misc.mdc

Subrule policy:

• After reading an index, load only the subrules that match the detection heuristics observed in code.
• Do not pre-load every subrule in a category.

Phase 3: Analysis and Verification

For each loaded category:

1. Enumerate reachable entry points.
2. Trace source -> validation/authz -> sink.
3. Confirm exploitability with evidence.
4. Score confirmed findings with CVSS v3.1.

Focused Review Mode

If the user asks for a narrow review (for example, only authz), load:

• Global baseline
• Requested category index
• Only matching subrules in that category

Still mention any obvious critical findings observed outside scope.

Review Workflow

1. Build an execution map:
   • UI Kit/Custom UI entry points
   • Bridge invocations and resolver handlers
   • api.asUser() / api.asApp() call paths
   • External egress/remotes and trigger entry points
2. For each finding, trace source -> validation/authz -> sink.
3. Validate exploitability before classifying as a confirmed vulnerability.
4. Keep non-exploitable hardening observations in a separate "needs validation" section.
5. Provide file-level evidence and practical test leads for each issue.

Static Analysis Mode

If the user asks for a full scan, run the complete workflow from:

• assets/security-rules/forge-auditing/static-analysis-forge.mdc

Expected tools (when available): Semgrep, npm audit, Snyk, gitleaks.

Output Requirements

• Provide a markdown security audit report.
• Order confirmed exploitable findings by CVSS v3.1 severity and impact.
• Include for each confirmed finding:
  • CVSS vector and base score
  • Severity band
  • Exploitability and impact
  • File evidence and source-to-sink trace
  • CWE mapping
  • Reproducible PoC/test steps with concrete commands
• Include assumptions and evidence gaps.
• Do not report scanner counts only when vulnerabilities exist.

Example Trigger Phrases

• "Review this Forge app for security"
• "Do a white-box security audit of my Forge app"
• "Check this app for authz bypass and tenant isolation issues"
• "Run full static analysis for this Forge codebase"