How securego/gosec works
gosec is a Go security scanner: users invoke its CLI on Go packages, configure rules and exclusions, and receive findings in a selected report format. The runtime combines pattern-based AST rules with SSA analyzers and taint analysis; findings are represented as issues and can optionally receive AI-generated fix suggestions. A separate Go analysis adapter exposes scanning through the standard analysis framework. The CLI and report routing are visible in excerpts; some scanner wiring is only documented or indexed, so uncertain links are omitted or marked unverified.
Main entry points: issue.go Issue model · formatter.go Report router · analyzer.go Scan engine · rulelist.go Rule catalog
Components 24
Entry points
- gosec CLI
cmd/gosec/main.go
Scanning
- Scan engine
analyzer.go - Rule framework
rule.go
Security checks
- Rule catalog
rules/rulelist.go - SQL rules
rules/sql.go - File rules
rules/readfile.go - TLS rules
rules/tls.go - Other AST rules
rules - Analyzer catalog
analyzers/analyzerslist.go - SSA analyzers
analyzers - Context analysis
analyzers/context_propagation.go - Slice bounds
analyzers/slice_bounds.go - Range analysis
analyzers/range_analyzer.go - Taint analysis
taint/taint.go
Findings and output
- Issue model
issue/issue.go - Report router
report/formatter.go - SARIF output
report/sarif/formatter.go - Text output
report/text/writer.go - Sonar output
report/sonar/formatter.go - JUnit output
report/junit/formatter.go - Other formats
report
Integrations
- AI fix suggestions
autofix/ai.go - Go analysis adapter
goanalysis/analyzer.go
Other components
- Scanner user
Connections 31
- Scanner user → gosec CLI: invokes
- gosec CLI → Scan engine: runs scan
- Scan engine → Rule framework: uses
- Scan engine → Analyzer catalog: loads analyzers
analyzer.go - Scan engine → Issue model: records findings
analyzer.go - Rule catalog → SQL rules: registers
- Rule catalog → File rules: registers
- Rule catalog → TLS rules: registers
- Rule catalog → Other AST rules: registers
- SQL rules → Issue model: creates issue
rules/sql.go - File rules → Issue model: creates issue
rules/readfile.go - TLS rules → Issue model: creates issue
rules/tls.go - Analyzer catalog → SSA analyzers: registers
- SSA analyzers → Context analysis: includes
- SSA analyzers → Slice bounds: includes
- SSA analyzers → Range analysis: includes
- Context analysis → Issue model: creates issue
analyzers/context_propagation.go - Slice bounds → Issue model: creates issue
analyzers/slice_bounds.go - Taint analysis → Issue model: creates issue
- gosec CLI → Report router: routes report
cmd/gosec/main.go - Report router → SARIF output: writes SARIF
report/formatter.go - Report router → Text output: writes text
report/formatter.go - Report router → Sonar output: writes Sonar
report/formatter.go - Report router → JUnit output: writes JUnit
report/formatter.go - Report router → Other formats: writes formats
report/formatter.go - Issue model → SARIF output: formats findings
report/sarif/formatter.go - Issue model → Sonar output: formats findings
report/sonar/formatter.go - Issue model → JUnit output: formats findings
report/junit/formatter.go - Issue model → Text output: formats findings
report/text/writer.go - gosec CLI → AI fix suggestions: requests fixes
- Go analysis adapter → Scan engine: runs analysis
goanalysis/analyzer.go