mirror of
https://github.com/safedep/pmg.git
synced 2026-08-03 07:24:09 +02:00
* feat: add experimental Go module support via pmg go Adds Go modules as a proxy-guarded ecosystem, opt-in only: the command runs solely when invoked explicitly as `pmg go ...` and is deliberately excluded from setup aliases and PATH shims so existing users are unaffected. - packagemanager: goPackageManager with fail-safe command classification (vet/fix excluded from non-download since they can fetch on a cold cache) and pinned-version extraction where only canonical semver counts as explicit. - GOPROXY normalization (fail-closed): effective GOPROXY read via `go env` (honors go env -w), rebuilt comma-joined with `direct` dropped so a 403 block is terminal and nothing silently falls back to unanalyzed VCS fetches. GOPRIVATE/GONOPROXY surface a warning; GOINSECURE is cleared. Contributed to the proxy flow through a new ProxyRoutingProvider hook (extra child env + dynamic MITM hosts). - Go interceptor with dynamic host matching from the user's effective GOPROXY via InterceptorContext.GoProxyHosts. Malware analysis runs on .zip only (the sole endpoint that delivers code); .info/.mod/@latest/ list pass through; /sumdb/ traffic and sum.golang.org are never touched so checksum-db verification stays intact; golang.org/toolchain is allowed on Go's own checksum verification. - Dependency cooldown: publish time captured from .info responses (body unmodified), in-window .zip blocked with 403; fails open for cooldown only when the publish time was never observed. - Cert gate: on macOS/Windows `pmg go` fails fast with actionable guidance unless the persisted PMG CA is OS-trusted (Go ignores SSL_CERT_FILE there); Linux works via the injected bundle. - proxye2e: GOPROXY-protocol mock registry, Go driver and 10 hermetic cases (allow/block/confirm, case-escaped paths, cooldown block and fail-open, toolchain, sumdb passthrough). Verified end-to-end on Linux: `pmg go get github.com/google/uuid@v1.6.0` MITMs proxy.golang.org, analyzes the decoded module at the .zip fetch, and go.sum verification succeeds through the tunneled checksum db. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014xuhBeTVpfU4SdqVaarvuK * fix(go): address review findings on experimental Go support - Drop fmt/clean from NonDownloadCommands: both load packages via go list and can download modules on a cold cache, which would bypass the proxy under install_only. - Support GOPROXY entries with a base path (e.g. corp Athens/JFrog at https://corp/goproxy): the interceptor now receives host -> base URL and strips the path prefix before parsing module URLs, so verdicts and cooldown key on the real module path. - Default unschemed GOPROXY entries to https, matching go's own behavior, so corp mirrors configured as bare hosts are intercepted instead of silently unanalyzed. - Memoize the final verdict per module zip: go re-requests a failed zip during go get's load phase, which double-recorded stats (the report showed the same blocked module twice) and would have re-prompted on Confirm verdicts. - Fetch .info out-of-band on a cooldown cache miss: go serves .info from its local module cache on any machine that used go before PMG, which silently disabled cooldown. Failure of the side-fetch still fails open for cooldown only. - Move the noop package resolver into packagemanager. Verified live: cold-cache cooldown block now records once; warm-cache rerun is blocked via the side-fetch instead of failing open. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014xuhBeTVpfU4SdqVaarvuK * docs: collapse Go proxy-mode details by default Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014xuhBeTVpfU4SdqVaarvuK --------- Co-authored-by: Claude <noreply@anthropic.com>
106 lines
3.1 KiB
Go
106 lines
3.1 KiB
Go
package interceptors
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
packagev1 "buf.build/gen/go/safedep/api/protocolbuffers/go/safedep/messages/package/v1"
|
|
"github.com/safedep/pmg/analyzer"
|
|
"github.com/safedep/pmg/proxy"
|
|
)
|
|
|
|
// InterceptorContext carries per-execution data from the CLI command into
|
|
// the interceptor layer. Unlike the factory's long-lived dependencies
|
|
// (analyzer, cache, stats), this holds context specific to the current run.
|
|
type InterceptorContext struct {
|
|
PinnedVersions map[string]string
|
|
|
|
// GoProxyBaseURLs maps module-proxy hostnames from the user's effective
|
|
// GOPROXY to their upstream base URL (scheme + host + optional path
|
|
// prefix). The Go interceptor MITMs and analyzes these hosts; Go is the
|
|
// only ecosystem whose registry hosts are user-configurable rather than
|
|
// fixed.
|
|
GoProxyBaseURLs map[string]string
|
|
}
|
|
|
|
// InterceptorFactory creates ecosystem-specific interceptors for the proxy
|
|
type InterceptorFactory struct {
|
|
analyzer analyzer.PackageVersionAnalyzer
|
|
cache AnalysisCache
|
|
statsCollector *AnalysisStatsCollector
|
|
confirmationChan chan *ConfirmationRequest
|
|
execContext InterceptorContext
|
|
}
|
|
|
|
// NewInterceptorFactory creates a new interceptor factory with shared dependencies
|
|
func NewInterceptorFactory(
|
|
analyzer analyzer.PackageVersionAnalyzer,
|
|
cache AnalysisCache,
|
|
statsCollector *AnalysisStatsCollector,
|
|
confirmationChan chan *ConfirmationRequest,
|
|
execContext InterceptorContext,
|
|
) *InterceptorFactory {
|
|
return &InterceptorFactory{
|
|
analyzer: analyzer,
|
|
cache: cache,
|
|
statsCollector: statsCollector,
|
|
confirmationChan: confirmationChan,
|
|
execContext: execContext,
|
|
}
|
|
}
|
|
|
|
// CreateInterceptor creates an interceptor for the specified ecosystem
|
|
// Returns an error if the ecosystem is not supported for proxy-based interception
|
|
func (f *InterceptorFactory) CreateInterceptor(ecosystem packagev1.Ecosystem) (proxy.Interceptor, error) {
|
|
switch ecosystem {
|
|
case packagev1.Ecosystem_ECOSYSTEM_NPM:
|
|
return NewNpmRegistryInterceptor(
|
|
f.analyzer,
|
|
f.cache,
|
|
f.statsCollector,
|
|
f.confirmationChan,
|
|
f.execContext,
|
|
), nil
|
|
|
|
case packagev1.Ecosystem_ECOSYSTEM_PYPI:
|
|
return NewPypiRegistryInterceptor(
|
|
f.analyzer,
|
|
f.cache,
|
|
f.statsCollector,
|
|
f.confirmationChan,
|
|
f.execContext,
|
|
), nil
|
|
|
|
case packagev1.Ecosystem_ECOSYSTEM_GO:
|
|
return NewGoRegistryInterceptor(
|
|
f.analyzer,
|
|
f.cache,
|
|
f.statsCollector,
|
|
f.confirmationChan,
|
|
f.execContext,
|
|
), nil
|
|
|
|
default:
|
|
return nil, fmt.Errorf("proxy-based interception not yet supported for ecosystem: %s", ecosystem.String())
|
|
}
|
|
}
|
|
|
|
// SupportedEcosystems returns a list of ecosystems that support proxy-based interception
|
|
func SupportedEcosystems() []packagev1.Ecosystem {
|
|
return []packagev1.Ecosystem{
|
|
packagev1.Ecosystem_ECOSYSTEM_NPM,
|
|
packagev1.Ecosystem_ECOSYSTEM_PYPI,
|
|
packagev1.Ecosystem_ECOSYSTEM_GO,
|
|
}
|
|
}
|
|
|
|
// IsSupported checks if an ecosystem supports proxy-based interception
|
|
func IsSupported(ecosystem packagev1.Ecosystem) bool {
|
|
for _, supported := range SupportedEcosystems() {
|
|
if ecosystem == supported {
|
|
return true
|
|
}
|
|
}
|
|
|
|
return false
|
|
}
|