zookeeper认证

前言

zookeeper下载下来,默认是不用认证就可以连接的,但是为了安全性,可以配置认证连接

zookeeper认证

认证的两个维度

在实际部署中,需区分并分别配置以下两类认证:

  1. Client-Server 认证:控制外部应用对 ZooKeeper 的访问。

    • 通过 authProvider.1=...SASLAuthenticationProvider 和 requireClientAuthScheme=sasl 启用。
    • 3.6.0+ 版本建议同时开启 sessionRequireClientSASLAuth=true,在会话建立阶段即拦截匿名请求。
  2. Server-Server (Quorum) 认证:防止未授权节点加入集群。

    • 需在 zoo.cfg 中额外配置 quorum.auth.enableSasl=true、quorum.auth.learnerRequireSasl=true 等参数。
    • JAAS 文件中需定义 QuorumServer 和 QuorumLearner 段,确保集群内部通信凭证一致。

zookepeer配置

sasl认证

在zoo.cfg配置文件中配置

ini 复制代码
authProvider.1=org.apache.zookeeper.server.auth.SASLAuthenticationProvider
requireClientAuthScheme=sasl
sessionRequireClientSASLAuth=true
jaasLoginRenew=3600000

然后同目录下新增zoo_jaas.conf,

内容为

ini 复制代码
Server {
    org.apache.zookeeper.server.auth.DigestLoginModule required
    user_admin="123456";
};

如果只想ip和账号配置的话,需要这么配置

ini 复制代码
authProvider.1=org.apache.zookeeper.server.auth.SASLAuthenticationProvider
#requireClientAuthScheme=sasl
#sessionRequireClientSASLAuth=true
jaasLoginRenew=3600000

把这两行去掉

程序连接

在application.properties下配置

ini 复制代码
# ==================== ZooKeeper 连接 ====================
demo.zookeeper.connect-string=127.0.0.1:2181
demo.zookeeper.session-timeout-ms=15000
demo.zookeeper.connection-timeout-ms=5000
demo.zookeeper.base-sleep-time-ms=1000
demo.zookeeper.max-retries=3
# 业务节点统一挂在该命名空间下(Curator 自动加前缀),留空则不启用
demo.zookeeper.namespace=demo-zk

# ==================== ZooKeeper 账号密码 ====================
# auth-mode=sasl :服务端设置了 requireClientAuthScheme=sasl 时必须用此模式。
#   客户端走 JAAS(DigestLoginModule,DIGEST-MD5),会话 scheme 为 sasl;
#   若用 digest 模式,服务端日志会报
#   "Client authentication scheme(s) [ip, digest] does not match ... [sasl]" 并断开会话。
# auth-mode=digest :ZooKeeper 原生 digest scheme(addAuthInfo("digest", "user:pass")),
#   仅适用于未开启 requireClientAuthScheme 的服务端。
demo.zookeeper.auth-mode=digest
demo.zookeeper.login-context-name=Client
demo.zookeeper.username=admin
demo.zookeeper.password=123456
# digest 模式下的 scheme,固定为 digest(sasl 模式下忽略)
demo.zookeeper.auth-scheme=digest

新增配置类

csharp 复制代码
package org.example.demozookeeper.config;

import org.springframework.boot.context.properties.ConfigurationProperties;

/**
 * ZooKeeper 连接与认证配置,对应 application.properties 中的 {@code demo.zookeeper.*}。
 */
@ConfigurationProperties(prefix = "demo.zookeeper")
public class ZookeeperProperties {

    /**
     * 认证机制:sasl(JAAS/DIGEST-MD5,服务端 requireClientAuthScheme=sasl 时必须)
     * 或 digest(ZooKeeper 原生 digest scheme,addAuthInfo("digest", ...))。
     */
    private String authMode = "sasl";

    /**
     * JAAS 登录上下文名,对应 jaas.conf 的 Client 段名。
     */
    private String loginContextName = "Client";

    /**
     * ZooKeeper 连接串,多个地址用逗号分隔。
     */
    private String connectString = "127.0.0.1:2181";

    /**
     * 会话超时(毫秒)。
     */
    private int sessionTimeoutMs = 15000;

    /**
     * 连接超时(毫秒)。
     */
    private int connectionTimeoutMs = 5000;

    /**
     * 重试退避基数(毫秒)。
     */
    private int baseSleepTimeMs = 1000;

    /**
     * 最大重试次数。
     */
    private int maxRetries = 3;

    /**
     * Curator 命名空间,留空表示不启用。
     */
    private String namespace = "demo-zk";

    /**
     * digest 模式下的 scheme,固定为 digest。
     */
    private String authScheme = "digest";

    /**
     * 账号。
     */
    private String username = "admin";

    /**
     * 密码。
     */
    private String password = "123456";

    public String getAuthMode() {
        return authMode;
    }

    public void setAuthMode(String authMode) {
        this.authMode = authMode;
    }

    public String getLoginContextName() {
        return loginContextName;
    }

    public void setLoginContextName(String loginContextName) {
        this.loginContextName = loginContextName;
    }

    public String getConnectString() {
        return connectString;
    }

    public void setConnectString(String connectString) {
        this.connectString = connectString;
    }

    public int getSessionTimeoutMs() {
        return sessionTimeoutMs;
    }

    public void setSessionTimeoutMs(int sessionTimeoutMs) {
        this.sessionTimeoutMs = sessionTimeoutMs;
    }

    public int getConnectionTimeoutMs() {
        return connectionTimeoutMs;
    }

    public void setConnectionTimeoutMs(int connectionTimeoutMs) {
        this.connectionTimeoutMs = connectionTimeoutMs;
    }

    public int getBaseSleepTimeMs() {
        return baseSleepTimeMs;
    }

    public void setBaseSleepTimeMs(int baseSleepTimeMs) {
        this.baseSleepTimeMs = baseSleepTimeMs;
    }

    public int getMaxRetries() {
        return maxRetries;
    }

    public void setMaxRetries(int maxRetries) {
        this.maxRetries = maxRetries;
    }

    public String getNamespace() {
        return namespace;
    }

    public void setNamespace(String namespace) {
        this.namespace = namespace;
    }

    public String getAuthScheme() {
        return authScheme;
    }

    public void setAuthScheme(String authScheme) {
        this.authScheme = authScheme;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

}

连接类

java 复制代码
@Configuration
public class ZookeeperConfig {

    private static final Logger log = LoggerFactory.getLogger(ZookeeperConfig.class);

    /**
     * 构造并启动 Curator 客户端。
     *
     * @param properties           ZK 连接与认证配置
     * @param connectionStateRef   连接状态引用
     * @return 已 start 的客户端,Spring 容器关闭时自动 close
     * @throws Exception 认证初始化失败时抛出
     */
    @Bean(initMethod = "start", destroyMethod = "close")
    public CuratorFramework curatorFramework(ZookeeperProperties properties,
                                             AtomicReference<ConnectionState> connectionStateRef) throws Exception {
        RetryPolicy retryPolicy = new ExponentialBackoffRetry(
                properties.getBaseSleepTimeMs(), properties.getMaxRetries());

        CuratorFrameworkFactory.Builder builder = CuratorFrameworkFactory.builder()
                .connectString(properties.getConnectString())
                .sessionTimeoutMs(properties.getSessionTimeoutMs())
                .connectionTimeoutMs(properties.getConnectionTimeoutMs())
                .retryPolicy(retryPolicy);

        if ("sasl".equalsIgnoreCase(properties.getAuthMode())) {
            installJaasConfiguration(properties);
            ZKClientConfig zkClientConfig = new ZKClientConfig();
            zkClientConfig.setProperty(ZKClientConfig.ENABLE_CLIENT_SASL_KEY, "true");
            zkClientConfig.setProperty(ZKClientConfig.LOGIN_CONTEXT_NAME_KEY,
                    properties.getLoginContextName());
            builder.zkClientConfig(zkClientConfig);
            // SASL 认证由 ZK 客户端在连接阶段自动完成(JAAS / DIGEST-MD5),
            // 不需要(也不应该)再调用 addAuthInfo("sasl", ...)。
        } else {
            // digest scheme:会话认证 + 节点 ACL
            byte[] auth = (properties.getUsername() + ":" + properties.getPassword())
                    .getBytes(StandardCharsets.UTF_8);
            builder.authorization(properties.getAuthScheme(), auth);
        }

        // 节点级 ACL:仅同 scheme 凭据的会话可读写
        ACLProvider aclProvider = new ACLProvider() {
            @Override
            public List<ACL> getDefaultAcl() {
                return buildAcl(properties);
            }

            @Override
            public List<ACL> getAclForPath(String path) {
                return buildAcl(properties);
            }
        };
        builder.aclProvider(aclProvider);

        if (StringUtils.hasText(properties.getNamespace())) {
            builder.namespace(properties.getNamespace());
        }

        CuratorFramework client = builder.build();
        client.getConnectionStateListenable().addListener((curator, state) -> {
            connectionStateRef.set(state);
            log.info("ZooKeeper 连接状态变更: {}", state);
        });
        return client;
    }

    /**
     * 按认证模式构造节点 ACL。
     */
    private List<ACL> buildAcl(ZookeeperProperties properties) throws RuntimeException {
        String scheme;
        String id;
        if ("sasl".equalsIgnoreCase(properties.getAuthMode())) {
            scheme = "sasl";
            id = properties.getUsername();
        } else {
            scheme = properties.getAuthScheme();
            try {
                id = DigestAuthenticationProvider.generateDigest(
                        properties.getUsername() + ":" + properties.getPassword());
            } catch (Exception e) {
                throw new IllegalStateException("生成 digest ACL 失败", e);
            }
        }
        // ZK 的 validateACL() 会调用 acl.contains(null) 来检查空元素,
        // 而 List.of() 是不可变 List,contains(null) 会抛 NPE;必须用 ArrayList。
        List<ACL> acl = new ArrayList<>();
        acl.add(new ACL(ZooDefs.Perms.ALL, new Id(scheme, id)));
        return acl;
    }

    /**
     * 以编程方式安装 JAAS 配置,提供 {@code Client} 登录上下文。
     *
     * <p>等效于 -Djava.security.auth.login.config=jaas.conf,但无需外部文件。
     * 会保留原有配置中其它 context 的条目,只覆盖 {@code loginContextName} 对应的段。
     */
    private void installJaasConfiguration(ZookeeperProperties properties) {
        Map<String, Object> options = new HashMap<>();
        options.put("username", properties.getUsername());
        options.put("password", properties.getPassword());
        AppConfigurationEntry entry = new AppConfigurationEntry(
                "org.apache.zookeeper.server.auth.DigestLoginModule",
                AppConfigurationEntry.LoginModuleControlFlag.REQUIRED,
                options);

        javax.security.auth.login.Configuration existing =
                javax.security.auth.login.Configuration.getConfiguration();
        javax.security.auth.login.Configuration.setConfiguration(
                new javax.security.auth.login.Configuration() {
            @Override
            public AppConfigurationEntry[] getAppConfigurationEntry(String name) {
                if (properties.getLoginContextName().equals(name)) {
                    return new AppConfigurationEntry[]{entry};
                }
                return existing.getAppConfigurationEntry(name);
            }
        });
        log.info("已安装 ZooKeeper JAAS 配置: context={}, username={}",
                properties.getLoginContextName(), properties.getUsername());
    }

    /**
     * 保存最新的连接状态,供 Service / HealthIndicator 读取。
     *
     * @return 连接状态引用
     */
    @Bean
    public AtomicReference<ConnectionState> zookeeperConnectionState() {
        return new AtomicReference<>(ConnectionState.LOST);
    }

}

对应哪种认证就改这个配置

ini 复制代码
demo.zookeeper.auth-mode=digest

Springboot连接启动成功

总结

  • 认证(Authentication) 解决身份识别问题,发生在连接建立时。
  • ACL(Access Control List) 解决权限授予问题,发生在操作执行时。
  • ACL 支持 world、auth、digest、ip、sasl、x509 六种 scheme,且不递归继承------每个 znode 必须独立设置 ACL,父节点权限不会自动传递给子节点。
  • 即使启用了 SASL 认证,若未对关键节点设置限制性 ACL,数据仍可能被已认证用户越权访问。
相关推荐
掘金者阿豪25 分钟前
数据库选型到底应该看什么?从业务需求到技术架构的实践分析
前端·后端
苍何1 小时前
豆包终于想通了...
后端
AAA修煤气灶刘哥1 小时前
Agent 都能干活了,软件还需要那么多按钮吗?
人工智能·后端·架构
未秃头的程序猿1 小时前
给新模块加了个 @MapperScan,启动崩了,最后发现跟 MapperScan 没关系
java·后端·mybatis
苍何1 小时前
不用 Opus5.5 ,即梦也能出爆款 vibe 视频了
后端
SimonKing2 小时前
WorkBuddy又推出新的限免模型(Hy4 flash)了,羊毛可以薅起来了
java·后端·程序员
Rain的Java大神之路2 小时前
别再死背"三级缓存"了!拿 Spring 7.0.8 源码,把 IoC、AOP、事务、循环依赖四大深水区一次蹚平
java·后端·面试
wno7042 小时前
springboot整合FastDFS
java·spring boot·后端
程序猿DD9 小时前
OctaFuse 2.20.0:MCP 用业务账号直接登录授权,请求日志合并工具调用
后端