Cassandra 安全加固最容易被忽略的一点是:它出厂只监听端口、不校验身份。原生 CQL 端口 9042 一旦对公网或整段办公网开放,任何人用一条 cqlsh 就能读到全部 keyspace,默认账号甚至就是 cassandra/cassandra。本文从基线排查、认证授权、节点间与客户端 TLS、JMX 与端口收口四个层面给出可直接执行的配置,适用于 Apache Cassandra 3.11 与 4.x 单机及集群环境。
适用场景
以下情况都需要按本文做一遍加固,而不是只改个口令了事:
- Cassandra 部署在云主机上,安全组曾临时放通 0.0.0.0/0 访问 9042,之后忘记回收;
- 仍在用默认账号
cassandra,或所有业务共用一个超级用户连接数据库; - 集群节点之间(7000 内部通信、7199 JMX)走明文,同网段被控主机可被动嗅探;
- 开发人员本地直连生产库做调试,客户端与服务端之间没有 TLS,密码在网络上明文传输;
- 等保或客户审计要求提供「数据库身份鉴别 + 通信加密 + 访问授权」三项证据,但目前只有网络层隔离。
前置条件
- Cassandra 版本不低于 3.11,本文配置项在 4.x 上同样适用,路径以
/etc/cassandra为准; - 具备
cassandra系统用户权限与nodetool、cqlsh客户端,集群场景需能逐节点滚动重启; - JDK 自带
keytool,用于生成 JKS 证书库;建议由内部 CA 签发,自签也可但要保证 SAN 与节点实际地址一致; - 已完成一次可用备份(
nodetool snapshot),改认证类配置前先留存回滚快照; - 维护窗口内操作。启用节点间加密需要滚动重启,每次只重启一个节点并等待
UN状态恢复。
原理说明
Cassandra 的访问控制由三个相互独立的开关拼成,缺任何一个都等于没做。authenticator 决定「你是谁」,默认值是 AllowAllAuthenticator,即不校验任何身份;authorizer 决定「你能做什么」,默认 AllowAllAuthorizer,任何通过认证的连接都能读写所有表;role_manager 负责角色与权限的存储,启用密码认证后必须切到 CassandraRoleManager,否则账号无处存放。三者同时改成强校验模式,cqlsh 才真正需要账号口令,权限也才会被 CQL 的 GRANT 语句约束。
传输层是第二条边界。Cassandra 有两个独立的 TLS 配置块:server_encryption_options 管节点之间(gossip 之外的节点通信,默认端口 7000)以及可选的 JMX,client_encryption_options 管客户端到 9042。它们默认都关闭,意味着口令虽然经过认证流程校验,但整个握手与数据在网络上仍是明文,同网段的抓包可以直接还原出账号密码与业务数据。internode_encryption 支持 none、all、dc、rack 四档,生产环境应设为 all。
第三条边界是暴露面。Cassandra 默认 rpc_address 监听在配置的地址上,很多人图省事写 0.0.0.0,结果数据库直接对公网可达;JMX 在 3.11 上通过 cassandra-env.sh 的 JMX_PORT 开启,且默认 authenticate=false,等于把运维接口无密码交出。把监听地址收紧到内网网卡、把 7199 只留在本机、用防火墙兜底,才是完整闭环。
操作步骤
第一步:基线排查,确认当前是否「裸奔」
先确认监听地址、认证状态与网络可达性,这一步不动配置,只取证:
# 1) 监听地址:0.0.0.0 或公网 IP 都算高风险
ss -lntp | grep -E ':(9042|7000|7199|9160)\b'
# 2) 认证相关配置的当前取值
grep -nE '^(authenticator|authorizer|role_manager|rpc_address|listen_address):' /etc/cassandra/cassandra.yaml
# 3) 用默认口令试连:能连上说明认证未开,或默认口令未改
cqlsh -u cassandra -p cassandra 10.0.1.11 9042 -e "SELECT cluster_name, release_version FROM system.local;"
# 4) 从另一台机器验证 9042 是否对外可达(在外部主机执行)
timeout 3 bash -c '</dev/tcp/10.0.1.11/9042' && echo "9042 OPEN" || echo "9042 CLOSED"
# 5) 清点现有角色与超级用户(认证开启后执行)
cqlsh -u cassandra -p cassandra -e "LIST ROLES;"
排查结果里只要出现 AllowAllAuthenticator、9042 OPEN、或默认口令可登录中的任意一条,就应当立即排期整改。生产库建议先在安全组层面临时收紧,再动配置。
第二步:开启密码认证与角色鉴权
编辑 cassandra.yaml,把三个开关一次性改为强校验模式:
# /etc/cassandra/cassandra.yaml
# 身份鉴别:改后 cqlsh / 驱动必须带账号口令
authenticator: PasswordAuthenticator
# 权限模型:按 role 分配 keyspace/table 级权限
authorizer: CassandraAuthorizer
# 角色存储(4.x 为默认值,3.11 也建议显式声明)
role_manager: CassandraRoleManager
# 监听地址收紧:只绑内网网卡,禁止 0.0.0.0
listen_address: 10.0.1.11
rpc_address: 10.0.1.11
# 原生协议端口保持默认,但由防火墙限制来源
native_transport_port: 9042
start_native_transport: true
修改后必须重启 Cassandra 进程(systemctl restart cassandra),该配置项不支持热加载。首次以 PasswordAuthenticator 启动时,系统会依据默认超级用户创建 cassandra 角色,初始口令为 cassandra,因此重启后的第一件事就是建新超管并废掉默认账号。
# 1) 新建一个实名超级用户(口令用 openssl rand -base64 24 生成)
cqlsh -u cassandra -p cassandra -e "
CREATE ROLE ops_admin WITH PASSWORD = 'R7mQ2xLp9vT4nZ8sK1wY6bH3' AND LOGIN = true AND SUPERUSER = true;"
# 2) 业务账号:只给所需 keyspace 的读写权限,不给 ALL KEYSPACES
cqlsh -u ops_admin -p 'R7mQ2xLp9vT4nZ8sK1wY6bH3' -e "
CREATE ROLE app_rw WITH PASSWORD = 'cM4tP8dR2yN6uE1oJ5vB9gQ3' AND LOGIN = true;
GRANT SELECT, MODIFY ON KEYSPACE app TO app_rw;"
# 3) 只读报表账号
cqlsh -u ops_admin -p 'R7mQ2xLp9vT4nZ8sK1wY6bH3' -e "
CREATE ROLE rpt_ro WITH PASSWORD = 'zX7cV3bN9mQ5wE2rT8yU4iO6' AND LOGIN = true;
GRANT SELECT ON KEYSPACE app TO rpt_ro;"
# 4) 废掉默认账号:改强随机口令并禁止登录(Cassandra 不允许 DROP cassandra 角色)
cqlsh -u ops_admin -p 'R7mQ2xLp9vT4nZ8sK1wY6bH3' -e "
ALTER ROLE cassandra WITH PASSWORD = 'Qv5nH8jL2sD6fG1kM4pR7tW9' AND LOGIN = false;"
# 5) 复核:应只剩 ops_admin / app_rw / rpt_ro 可登录
cqlsh -u ops_admin -p 'R7mQ2xLp9vT4nZ8sK1wY6bH3' -e "LIST ROLES;"
权限粒度建议按「keyspace + 操作动词」组合授予,GRANT ALL ON KEYSPACE ... 会把 ALTER、DROP 一起给出,业务账号不应持有。需要回收时用 REVOKE MODIFY ON KEYSPACE app FROM app_rw;,权限变更即时生效,无需重启。
第三步:为节点间与客户端通信启用 TLS
先生成节点证书,再改两个 encryption 配置块。证书的 SAN 必须包含节点的主机名与 IP,否则开启双向校验后节点会互相拒绝:
# 1) 生成节点密钥库(有效期 10 年,SAN 与节点地址保持一致)
keytool -genkeypair -alias cassandra -keyalg RSA -keysize 2048 -validity 3650 \
-keystore /etc/cassandra/ssl/node1.keystore.jks -storepass changeit -keypass changeit \
-dname "CN=cassandra-node1, OU=infra, O=example, L=Shanghai, C=CN" \
-ext "SAN=DNS:cassandra-node1,IP:10.0.1.11"
# 2) 导出节点证书,并导入到集群共用的信任库
keytool -exportcert -alias cassandra -keystore /etc/cassandra/ssl/node1.keystore.jks \
-storepass changeit -rfc -file /tmp/node1.crt
keytool -importcert -alias cassandra-node1 -file /tmp/node1.crt \
-keystore /etc/cassandra/ssl/truststore.jks -storepass changeit -noprompt
# 3) 每个节点都要把其它节点的证书导入同一个 truststore,并分发到全部节点
# 最终校验:truststore 中条目数应等于集群节点数
keytool -list -keystore /etc/cassandra/ssl/truststore.jks -storepass changeit
# 4) 权限收紧,私钥库仅 cassandra 用户可读
chown -R cassandra:cassandra /etc/cassandra/ssl
chmod 640 /etc/cassandra/ssl/*.jks
# /etc/cassandra/cassandra.yaml
# 节点间加密:all = 全集群内部通信加密(7000 端口)
server_encryption_options:
internode_encryption: all
keystore: /etc/cassandra/ssl/node1.keystore.jks
keystore_password: changeit
truststore: /etc/cassandra/ssl/truststore.jks
truststore_password: changeit
require_client_auth: true
protocol: TLSv1.3
# 客户端加密:9042 端口,强制 TLS,不再接受明文连接
client_encryption_options:
enabled: true
optional: false
keystore: /etc/cassandra/ssl/node1.keystore.jks
keystore_password: changeit
truststore: /etc/cassandra/ssl/truststore.jks
truststore_password: changeit
require_client_auth: false
protocol: TLSv1.3
optional: false 是关键,写成 true 会允许明文与 TLS 并存,攻击者仍可用明文连接绕过加密。首次启用建议先在测试集群验证,再滚动重启生产节点:单节点重启后等待 nodetool status 出现 UN 再操作下一台。
第四步:收口 JMX 与端口暴露面
JMX 是 nodetool 的管理通道,未加固时等于无密码的数据库控制台。4.x 默认只开本地 JMX,3.11 需要显式检查:
# 1) 检查 JMX 是否对外监听(3.11 常见问题)
grep -nE 'JMX_PORT|jmxremote' /etc/cassandra/cassandra-env.sh
# 2) 若必须远程 JMX:开启认证,口令文件权限须为 600 且仅 cassandra 可读
cat > /etc/cassandra/jmxremote.password <<'EOF'
monitorRole Nn8kP2vL5xR9tB4m
controlRole Wq3zM7cV1bN6yH8s
EOF
chown cassandra:cassandra /etc/cassandra/jmxremote.password
chmod 600 /etc/cassandra/jmxremote.password
# 3) 防火墙兜底:9042/7000 仅内网段,7199 仅本机与跳板机
iptables -A INPUT -p tcp --dport 9042 -s 10.0.1.0/24 -j ACCEPT
iptables -A INPUT -p tcp --dport 7000 -s 10.0.1.0/24 -j ACCEPT
iptables -A INPUT -p tcp --dport 7199 -s 10.0.1.5 -j ACCEPT
iptables -A INPUT -p tcp --dport 9042 -j DROP
iptables -A INPUT -p tcp --dport 7000 -j DROP
iptables -A INPUT -p tcp --dport 7199 -j DROP
iptables-save > /etc/iptables/rules.v4
配置验证
四个维度逐项验证,全部通过才算加固完成。不要只看配置文件改没改,要看实际行为变没变:
# 1) 认证生效:错误口令必须被拒
cqlsh -u app_rw -p wrongpass 10.0.1.11 9042
# 期望:AuthenticationFailed - Provided username app_rw and/or password are incorrect
# 2) 授权生效:业务账号越权访问其它 keyspace 必须被拒
cqlsh -u app_rw -p 'cM4tP8dR2yN6uE1oJ5vB9gQ3' -e "SELECT * FROM system_auth.roles;"
# 期望:Unauthorized - Error from server: code=2100
# 3) 客户端 TLS 生效:明文连接应握手失败
cqlsh -u app_rw -p 'cM4tP8dR2yN6uE1oJ5vB9gQ3' 10.0.1.11 9042 -e "SELECT now() FROM system.local;"
# 期望:ConnectionShutdown / 连接被重置
# 4) TLS 握手本身可完成(说明 9042 已切到 TLS)
openssl s_client -connect 10.0.1.11:9042 -servername cassandra-node1 </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
# 5) 监听地址复核:不应出现 0.0.0.0
ss -lntp | grep -E ':(9042|7000|7199)\b'
# 6) 集群健康:全部节点 UN,无 down
nodetool status
- 认证:错误口令返回
AuthenticationFailed;默认账号cassandra无法登录。 - 授权:
app_rw访问system_auth或其它业务 keyspace 返回Unauthorized。 - 加密:
openssl s_client能看到 TLS 版本与加密套件,明文cqlsh连接失败。 - 暴露面:外部主机
/dev/tcp探测 9042 超时,ss输出中无0.0.0.0。
常见问题
Q1:把 authenticator 改成 PasswordAuthenticator 后全部业务连接失败,是配置写错了吗?
配置没错,是客户端还没带凭据。开启认证后,所有驱动连接都必须提供账号口令:Java 驱动用 withCredentials(),Python 用 PlainTextAuthProvider,cqlsh 用 -u/-p。正确顺序是「先在维护窗口重启开启认证 → 立刻建好业务角色 → 再发布带凭据的客户端配置」,否则会出现业务中断与权限空窗并存。若已中断,可临时把 authenticator 改回 AllowAllAuthenticator 重启恢复,但不要长期停留在这个状态。
Q2:启用 internode_encryption: all 后节点互相报连接失败,nodetool status 显示 DN,怎么排查?
八成是证书不匹配,按顺序查三点。第一,truststore 是否互相导入:每个节点的 truststore 必须包含集群内所有节点的证书,条目数等于节点数,漏一个该节点就会被拒。第二,SAN 是否覆盖实际地址:其他节点用 listen_address 或主机名去连,证书的 SAN 里必须有对应 IP 或 DNS,只有 CN 不够。第三,keystore 密码是否与 yaml 一致:keystore_password 与生成时的 -storepass 不同会直接握手失败。排查时可临时把 require_client_auth 设为 false 单向校验,确认服务端证书链没问题后再打开双向校验。日志看 /var/log/cassandra/system.log 中的 SSLException。
Q3:默认的 cassandra 超级用户能直接删除吗?
不能。DROP ROLE cassandra; 会被拒绝,因为它是系统内置角色。正确的处理方式是:先建一个实名超级用户并验证可登录,再对 cassandra 执行 ALTER ROLE cassandra WITH PASSWORD='<强随机串>' AND LOGIN = false;。这样即使口令泄露也无法登录,审计链上也有明确的责任人账号。同时建议在 system_auth keyspace 上把 replication_factor 设为大于 1,否则认证数据所在节点故障后会退化成允许任何登录的应急模式。
Q4:cqlsh 报「Connection error: (‘Unable to connect to any servers’, …)」,端口也通,是什么原因?
先区分是网络层还是协议层。用 ss -lntp | grep 9042 确认进程确实在监听,且地址是 rpc_address 配置的内网 IP;rpc_address: 0.0.0.0 在部分版本上需要配合 broadcast_rpc_address 才能被客户端正确解析。若监听正常但连接被拒,检查 client_encryption_options.enabled:开启 TLS 后必须用 cqlsh --ssl 并配置 ~/.cassandra/cqlshrc 的 [ssl] 段(certfile、validate、userkey、usercert),用明文参数连接只会得到连接重置。
总结
Cassandra 的安全边界由四个可独立开关的部件拼成:authenticator 管身份、authorizer 管权限、两个 encryption 块管传输、监听地址与防火墙管暴露面。它们默认全开在「信任所有」的状态,所以「装好就能用」恰恰是风险来源。落地顺序建议按风险排序:先收监听地址与防火墙(当天可做、零业务影响),再开认证授权并清理默认账号(需一次重启),然后滚动启用 TLS(需维护窗口),最后处理 JMX。每完成一步都用本文验证段落的命令实测,留下输出截图,这类证据在等保测评与客户安全审计里直接可用。