Rundeck 作业调度加固实战:ACL 与凭据隔离

Rundeck ACL 策略与凭据存储是这套调度器加固的重点,端口屏蔽只是最外层。调度器天生持有大量服务器的 SSH 私钥和云厂商密钥,一旦某个低权限账号能执行任意 ad-hoc 命令,等于拿到了整片机器的 shell。本文给出从网络收口、匿名阻断、ACL 分权到 Key Storage 隔离的完整配置。

Rundeck 默认安装后监听 4440 端口,自带一套「登录即可执行」的宽松语义:只要账号存在,就能在任意项目里跑任意命令。多数团队只在防火墙放行了 443,却忘了 4440 也被一起映射出去,结果是 Web 界面加了 HTTPS,直连端口却仍是明文。

适用场景

  • Rundeck 承担生产环境批量发布,需要区分「只能看」「能跑指定作业」「能改作业定义」三类人
  • 作业里曾出现明文密码或私钥路径,需要统一迁到 Key Storage 并做路径级隔离
  • 安全审计要求提供「匿名不可访问」「令牌有有效期」的配置证据
  • 多项目共用一套 Rundeck,需要按项目维度限制可见范围

前置条件

  • Rundeck 4.x / 5.x,Java 11 及以上,安装路径 /var/lib/rundeck(deb/rpm 默认)
  • 配置目录 /etc/rundeck,ACL 策略目录 /var/lib/rundeck/etc
  • 前置 Nginx 完成 HTTPS,域名可解析
  • 一个系统管理员账号(realm.properties 中角色为 admin)
  • 注意:修改 rundeck-config.properties 需重启 rundeckd;新增 ACL 文件与 Key Storage 条目可热加载

原理说明

Rundeck 的授权模型是纯 ACL 驱动的:没有任何策略文件匹配某个请求时,请求被拒绝。策略以 YAML 描述,三个必填段落——context 声明作用域(项目、应用类型)、for 声明资源与动作、by 声明主体(用户或组)。动作按资源类型划分:项目级是 read/configure/delete/import/export,作业级是 read/run/create/update/delete/view/toggle_schedule/toggle_execution,节点级是 read/run。

这里有个反直觉的点:节点权限不等于命令权限。node: run 只允许对节点发起连接,真正能跑什么由 adhoc 与 job 资源决定。想禁止某组人执行任意命令,必须显式不授予 adhoc 的 run,同时只给 job: run 且把作业范围收窄到指定组——只要给了 adhoc,他们就能绕过所有作业约束直接敲命令。

凭据侧,Rundeck 提供 Key Storage(存储后端为文件或数据库),作业通过 ssh-key-storage-path 引用条目,运行时才解密注入,日志与作业定义里都不出现明文。默认项目会退化为「用执行用户的家目录私钥」,这等于把所有目标机的信任关系绑在同一个账号上,一旦该账号泄露就是全网失守。

操作步骤

1. 网络层收口:4440 只监听回环

sudo cp /etc/rundeck/rundeck-config.properties /etc/rundeck/rundeck-config.properties.bak

sudo tee -a /etc/rundeck/rundeck-config.properties > /dev/null <<'EOF'
# 只监听本机,外部统一走 Nginx
server.address=127.0.0.1
server.port=4440
# 开启 HMAC 请求令牌,防 CSRF
rundeck.security.useHMacRequestTokens=true
EOF

sudo systemctl restart rundeckd
ss -tlnp | grep 4440

预期只看到 127.0.0.1:4440。若仍显示 0.0.0.0:4440,说明 /etc/rundeck/profile 里通过 RDECK_JVM 传了覆盖参数,需要同步删掉 -Dserver.address。

2. Nginx 前置与来源限制

server {
    listen 443 ssl;
    http2 on;
    server_name rundeck.example.com;

    ssl_certificate     /etc/letsencrypt/live/rundeck.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/rundeck.example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;

    add_header Strict-Transport-Security "max-age=31536000" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Frame-Options "SAMEORIGIN" always;

    client_max_body_size 20m;

    location / {
        proxy_pass http://127.0.0.1:4440;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 管理接口(用户/令牌/系统设置)仅内网可达
    location ~ ^/(api/[0-9]+/(users|system|storage)|user/(add|edit)|admin) {
        allow 10.0.0.0/8;
        allow 192.168.0.0/16;
        deny  all;
        proxy_pass http://127.0.0.1:4440;
        proxy_set_header Host $host;
    }
}

3. 匿名访问阻断

先检查 ACL 目录现状,再补一条显式的顶层拒绝策略。Rundeck 中匿名请求的主体组是 anonymous,只要有策略匹配它就等于对外开房:

ls -l /var/lib/rundeck/etc/*.aclpolicy

# 顶层拒绝:不授予匿名任何权限,显式写死便于审计
sudo tee /var/lib/rundeck/etc/00-deny-anon.aclpolicy > /dev/null <<'EOF'
description: 拒绝匿名主体的一切访问
context:
  application: rundeck
for:
  resource:
    - allow: '*'
    - deny:  '*'
by:
  group: anonymous
EOF

策略文件的热加载依赖文件名排序,前缀 00- 保证它先被解析。写完后访问未登录页面应跳到登录表单,而不是返回项目列表。

4. ACL 按组分权

把人员分三类:devops 可改作业、ops 只能跑作业、audit 只读。注意 ops 组刻意不授予 adhoc,这样他们只能通过已定义的作业操作,无法在节点上执行任意命令:

# devops:可读写作业,但不可删除项目
sudo tee /var/lib/rundeck/etc/10-devops.aclpolicy > /dev/null <<'EOF'
description: 运维开发组,可维护作业定义
context:
  project: '.*'
for:
  project:
    - allow: read
  job:
    - allow: [read, run, create, update, view, toggle_schedule]
  node:
    - allow: [read, run]
  adhoc:
    - allow: [read, run]
by:
  group: devops
EOF

# ops:只跑作业,禁止 adhoc
sudo tee /var/lib/rundeck/etc/20-ops.aclpolicy > /dev/null <<'EOF'
description: 值班组,只能执行既有作业
context:
  project: '.*'
for:
  project:
    - allow: read
  job:
    - allow: [read, run, view]
  node:
    - allow: read
by:
  group: ops
EOF

# audit:只读,连执行日志也不许改
sudo tee /var/lib/rundeck/etc/30-audit.aclpolicy > /dev/null <<'EOF'
description: 审计组,只读作业与执行记录
context:
  project: '.*'
for:
  project:
    - allow: read
  job:
    - allow: [read, view]
  execution:
    - allow: read
  node:
    - allow: read
by:
  group: audit
EOF

用户与组的映射写在 realm.properties,格式为 用户名:密码,角色1,角色2。修改后需重启;密码建议使用 jetty 的 OBF: 混淆形式而非明文。

5. 凭据存入 Key Storage 并做路径隔离

把所有私钥从作业定义与执行用户家目录里挪出来,按「环境/用途」分层存放。上传通过 Storage API 完成,内容直接走请求体,不落临时文件:

export RD_URL=https://rundeck.example.com
export RD_TOKEN=<管理员 API 令牌>

# 上传私钥到 keys/prod/deploy_id_rsa
curl -sS -X POST \
  -H "X-Rundeck-Auth-Token: $RD_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @/root/.ssh/id_rsa \
  "$RD_URL/api/38/storage/keys/keys/prod/deploy_id_rsa"

# 校验条目存在且不可被普通用户读取
curl -sS -H "X-Rundeck-Auth-Token: $RD_TOKEN" \
  "$RD_URL/api/38/storage/keys/keys/prod" | head -20

然后在项目级指定默认密钥路径,避免每个作业各自硬编码:

sudo tee -a /var/lib/rundeck/projects/prod/etc/project.properties > /dev/null <<'EOF'
project.ssh-key-storage-path=keys/prod/deploy_id_rsa
project.ssh-authentication=privateKey
project.ssh-keypath=
EOF

project.ssh-keypath 置空是关键一步:只要它指向文件系统路径,Rundeck 就会优先用本地私钥,Key Storage 的隔离形同虚设。

6. API 令牌限期与回收

令牌一旦签发默认长期有效,必须显式指定 duration,并定期清理离职人员令牌:

# 签发 30 天有效期的令牌
curl -sS -X POST -H "X-Rundeck-Auth-Token: $RD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"duration":"30d","roles":["ops"],"generateToken":true}' \
  "$RD_URL/api/38/tokens/alice"

# 列出指定用户令牌,核对到期时间
curl -sS -H "X-Rundeck-Auth-Token: $RD_TOKEN" "$RD_URL/api/38/tokens/alice"

# 撤销
curl -sS -X DELETE -H "X-Rundeck-Auth-Token: $RD_TOKEN" \
  "$RD_URL/api/38/tokens/alice/<token-id>"

配置验证

# 1) 端口只监听回环
ss -tlnp | grep 4440

# 2) 未登录访问应 302 到登录页
curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' https://rundeck.example.com/project/prod/jobs

# 3) 低权限令牌执行 adhoc 应 403
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  -H "X-Rundeck-Auth-Token: $OPS_TOKEN" -H "Content-Type: application/json" \
  -d '{"project":"prod","filter":"name: web01","exec":"id"}' \
  https://rundeck.example.com/api/38/project/prod/run/command

# 4) 对照:同一令牌跑既有作业应 200
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  -H "X-Rundeck-Auth-Token: $OPS_TOKEN" -H "Content-Type: application/json" \
  -d '{}' https://rundeck.example.com/api/38/job/<job-id>/run

# 5) 审计日志确认 ACL 拒绝被记录
sudo tail -50 /var/log/rundeck/audit.log

预期:端口仅 127.0.0.1:4440;未登录 302;adhoc 返回 403;作业执行返回 200;audit.log 中出现 auth_denied 记录。

常见问题

FAQ 1:加了 ACL 文件后,管理员账号也进不去项目了?

先确认 realm.properties 里该账号是否带 admin 角色,再确认是否存在覆盖性的 deny 策略。Rundeck 的求值顺序是「先匹配先返回」,同一请求若被 00-deny-anon 之外的策略显式 deny,则后续 allow 不生效。排查方法是把日志级别调到 DEBUG,日志会打印命中的策略文件名。

FAQ 2:作业里配置了 ssh-key-storage-path,执行仍提示 Permission denied?

三种常见原因:私钥上传时未做换行转换导致格式损坏;project.ssh-keypath 仍指向本地文件从而覆盖了存储路径;目标机 authorized_keys 未绑定该密钥对应账号。ssh -i 手工验证一次私钥可用性,再回到 Rundeck 排查引用路径。

FAQ 3:ACL 策略改完必须重启吗?

不需要。ACL 策略文件与 Key Storage 条目都支持热加载,保存后下一次请求即按新策略判定。真正需要重启的是 rundeck-config.properties 的网络与安全开关。这也意味着策略写错会立刻生效,建议在维护窗口内变更,并保留上一版本文件便于回滚。

总结

Rundeck 的风险集中在一个事实:它是「能对全部服务器执行命令」的中枢。因此加固顺序应该是先切断直连(server.address=127.0.0.1),再封死匿名(策略文件显式 deny),然后用 ACL 把 adhoc 从普通账号手里拿走,最后把凭据从作业定义迁到 Key Storage 并清空 project.ssh-keypath。四步做完,一个「谁登录都能敲命令」的调度面板才变成权限可追溯的运维入口。