解析器做决定
包管理器把一个名称解析到一个或多个仓库中的版本。如果内部有 acme-utils,攻击者在公共仓库发布 [email protected],同时检查两个来源的解析器可能选择更高的公共版本,构建就以组织权限安装了攻击者代码。
工作机制
攻击者先从泄露的清单、公开 CI 日志、招聘信息或错误消息中得知内部包名,然后发布同名、版本号极高的包,有时带 preinstall 脚本,窃取环境变量或令牌。构建系统若把公共仓库当作非作用域名称的权威来源,就会拉入该包。
防御分多层:使用 @acme/utils 这类作用域名称,并把作用域只映射到私有仓库;禁用内部作用域的公共回退;提交带完整性哈希的锁文件;用 npm ci 而不是会重新解析的安装。代理仓库阻止未知包并要求审批,再加一道屏障。
何时使用与取舍
每个发布或使用内部包的项目都应采用这些控制,CI 中尤其重要,因为那里有令牌和部署凭据。开源维护者即使私有分发,也应到公共仓库占住名称。
作用域有效,但需要重命名和迁移。阻断公共回退会让确实需要公共包的构建失败,例外必须评审。锁文件有用,但取决于更新时的审查。私有代理增加基础设施,却提供可见性和熔断能力。
示例与常见误解
某公司构建内部 telemetry-agent,攻击者在公共仓库发布同名 99 版并带 postinstall 脚本。带公共回退的构建安装了它,把 CI 机密发送到外部主机。
常见误解是私有代码不可见。名称经常泄露,而且这种攻击根本不需要访问私有仓库。相关概念:供应链安全、依赖固定、误植域名。
代码示例
package main
import (
"crypto/sha256"
"crypto/subtle"
"fmt"
)
func ConstantTimeEqual(a, b string) bool {
left := sha256.Sum256([]byte(a))
right := sha256.Sum256([]byte(b))
return subtle.ConstantTimeCompare(left[:], right[:]) == 1
}
func main() {
secret := "s3cr3t-token"
fmt.Println(ConstantTimeEqual(secret, "s3cr3t-token"))
fmt.Println(ConstantTimeEqual(secret, "s3cr3t-tokeX"))
fmt.Println(ConstantTimeEqual(secret, "short"))
}
// SSRF guard: validate every serverSide request target before dialing
package main
import (
"context"
"fmt"
"net"
"net/http"
"net/url"
"strings"
"time"
)
var blockedZones = []string{
"127.0.0.0/8", "10.0.0.0/8", "172.16.0.0/12",
"192.168.0.0/16", "169.254.0.0/16", "::1/128", "fc00::/7",
}
var allowedHosts = map[string]bool{
"api.partner.com": true, "cdn.partner.net": true, "hooks.vendor.io": true,
}
func validateTarget(raw string) (*url.URL, error) {
parsed, err := url.Parse(raw)
if err != nil {
return nil, fmt.Errorf("parse url: %w", err)
}
if parsed.Scheme != "https" {
return nil, fmt.Errorf("scheme %q not allowed", parsed.Scheme)
}
if !allowedHosts[parsed.Hostname()] {
return nil, fmt.Errorf("host %q is not allowlisted", parsed.Hostname())
}
return parsed, nil
}
func dialGuard(ctx context.Context, network, addr string) (net.Conn, error) {
host, port, err := net.SplitHostPort(addr)
if err != nil {
return nil, err
}
ips, err := net.DefaultResolver.LookupIPAddr(ctx, host)
if err != nil {
return nil, err
}
for _, ip := range ips {
if !isPublic(ip.IP) {
return nil, fmt.Errorf("resolved %s to private address %s", host, ip.IP)
}
}
dialer := &net.Dialer{Timeout: 5 * time.Second}
return dialer.DialContext(ctx, network, net.JoinHostPort(ips[0].IP.String(), port))
}
func isPublic(ip net.IP) bool {
for _, zone := range blockedZones {
_, network, _ := net.ParseCIDR(zone)
if network.Contains(ip) {
return false
}
}
return !ip.IsLoopback() && !ip.IsUnspecified() && !ip.IsLinkLocalUnicast()
}
func guardedClient() *http.Client {
transport := &http.Transport{
DialContext: dialGuard,
// 重定向必须重走校验:禁止自动跟随
DisableKeepAlives: true,
}
return &http.Client{
Transport: transport,
CheckRedirect: func(req *http.Request, via []*http.Request) error {
return validateSameHost(via[0], req.URL)
},
Timeout: 8 * time.Second,
}
}
func validateSameHost(orig, next *url.URL) error {
if strings.EqualFold(orig.Hostname(), next.Hostname()) {
return nil
}
return fmt.Errorf("redirect to non-allowlisted host %q", next.Hostname())
}
func main() {
client := guardedClient()
if _, err := validateTarget("https://api.partner.com/v1/data"); err == nil {
resp, err := client.Get("https://api.partner.com/v1/data")
fmt.Println(resp, err)
}
_, err := validateTarget("http://169.254.169.254/latest/meta-data")
fmt.Println("metadata endpoint blocked:", err)
}