-肆行无忌网

发布时间：2025-06-24 19:24:19 作者：北方职教升学中心阅读量：554

认证与鉴权的关系

先回顾一下 listener 的作用。鉴权等概念。认证与鉴权之间的关系

在这里插入图片描述

安全协议决定了服务端和客户端之间的认证（Authentication）协议，而鉴权（Authorization）基本独立于认证，只校验通过认证的主体对请求中涉及的资源是否有操作权限。ResourceName 为 “*”，且 PatternType 为 LITERAL 时表示匹配任意名称；如果 ResourceName 为 “*”，PatternType 为 PREFIXED，表示匹配前缀名称为“*”的资源。

阶段三：下线旧协议

node.id=1# 保持不变controller.quorum.voters=1@localhost:9193,2@localhost:9195,3@localhost:9197# 下线旧 listenerlisteners=BROKER_SASL://:9192,CONTROLLER_SASL://:9193# 保持不变inter.broker.listener.name=BROKER_SASL# 下线旧地址advertised.listeners=BROKER_SASL://localhost:9192# 下线旧 listenercontroller.listener.names=CONTROLLER_SASL# authorizationauthorizer.class.name=org.apache.kafka.metadata.authorizer.StandardAuthorizer# allow.everyone.if.no.acl.found=truesuper.users=User:automq# 保持不变sasl.enabled.mechanisms=SCRAM-SHA-256,PLAIN,SCRAM-SHA-512sasl.mechanism.inter.broker.protocol=PLAINsasl.mechanism.controller.protocol=PLAINlistener.name.broker_sasl.plain.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \username="automq"\password="automq-secret"\user_automq="automq-secret";listener.name.controller_sasl.plain.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \username="automq"\password="automq-secret"\user_automq="automq-secret";# 保持不变listener.name.broker_sasl.scram-sha-256.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.controller_sasl.scram-sha-256.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.broker_sasl.scram-sha-512.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.controller_sasl.scram-sha-512.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;# 保持不变listener.security.protocol.map=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL,BROKER_SASL:SASL_PLAINTEXT,CONTROLLER_SASL:SASL_PLAINTEXT

至此，旧协议下线，所有通信基于 SASL_PLAINTEXT 协议。

我们在此前的文章《AutoMQ SASL 安全身份认证配置教程》[1]介绍过 Apache Kafka （以下简称 Kafka）服务端和客户端的 SASL 认证协议配置，并在《AutoMQ SSL 安全协议配置教程》[2]详细介绍了如何利用 SSL（TLS）实现 Kafka 或 AutoMQ 的安全通信。外网访问 broker 时的通信安全协议；

我们可以将 listener name 跟安全协议进行映射，举例来说，Kafka 支持以下安全协议：

我们可以设置 client 与 broker 之间使用 SASL_SSL 协议保证加密性，而集群节点之间使用 SASL_PLAINTEXT 减少 CPU 加密解密的消耗：

listeners=EXTERNAL://:9092,BROKER://10.0.0.2:9094advertised.listeners=EXTERNAL://broker1.example.com:9092,BROKER://broker1.local:9094listener.security.protocol.map=EXTERNAL:SASL_SSL,BROKER:SASL_PLAINTEXT inter.broker.listener.name=BROKER

下图展示了 Listener、

总结

本文概述了 Kafka 中的认证协议和鉴权策略。

本阶段结束以后，需要通知业务方重新配置基于 SASL_PLAINTEXT 配置客户端。三台节点均为 controller + broker 的混部节点。在认证通过后，Kafka 会生成一个认证主体，供上层进行细粒度的鉴权。Kraft 模式下可以填写官方提供的 “org.apache.kafka.metadata.authorizer.StandardAuthorizer”，基于 ACL（access control list）规则认证；

super.users：设置超级用户，默认为空。

注意，本文默认 Kafka 集群是以 Kraft 模式工作的。最后介绍了如何对一个运行中的 Kafka 集群中进行认证协议升级以及开启鉴权。
需要注意的是，Kafka 提供了默认的 SASL/PLAIN 实现，需要在每个节点配置中显示声明账密信息。当 client 通过认证协议完成认证后，broker 侧会将该 KafkaPrincipal 对象塞入 RequestContext，并向上传递，以供后续鉴权。作为 Kafka 生态的忠实拥护者，我们也会持续致力于传播 Kafka 技术，欢迎关注我们。
参考文献
[1] https://www.automq.com/blog/automq-sasl-security-authentication-configuration-guide
[2] https://www.automq.com/blog/automq-ssl-security-protocol-configuration-tutorial
[3] https://developer.confluent.io/courses/security/authentication-basics/
[4] https://smallstep.com/hello-mtls/doc/server/kafka
[5] https://web.mit.edu/kerberos/

首先介绍了 listener 与安全协议的映射，以及安全协议与认证方法的映射。listener 是 Kafka 服务端定义监听地址（域名/IP + 端口）和安全协议的实体。一条 ACL 规则包含两部分：

ResourcePattern：声明资源及其匹配方式，包含：
- ResourceType：资源类型，包括 TOPIC、本文将进一步概述 Kakfa 中的认证方法和鉴权策略，并通过一个例子来说明我们在真实应用场景中如何对 Kafka 或者 AutoMQ 集群开启身份认证和鉴权。由于认证通常涉及到用户的管理，这种通过证书进行认证的方式在增删用户时显得比较“笨重”（尤其是动态增删用户的场景），并不是主流的认证方式。
  认证主体是对 client 的身份标识，对应一个 KafkaPrincipal 对象[5]。这里指定的用户将不受 ACL 约束，直接拥有所有资源的所有操作权限；
- allow.everyone.if.no.acl.found：指定资源没有任意 ACL 约束时的默认权限，默认为 false。
  SASL 认证协议又可以进一步细分为以下认证机制：
  - GSSAPI：借助第三方 Kerberos[3]（一种基于 ticket 的加密认证协议）服务器进行认证认证；
  - PLAIN：简单账密认证，注意它跟前文的 PLAINTEXT 不是一个概念；
  - SCRAM-SHA-256/512：基于 SCRAM 算法，由 Kafka 节点基于 record 自认证；
  - OAUTHBEARER：借助第三方 OAuth 服务器认证；
  Kafka broker 允许同时启用多种 SASL 认证，例如同时启用 SCRAM-SHA-256/512 + PLAIN：
```
sasl.enabled.mechanisms=SCRAM-SHA-256,PLAIN,SCRAM-SHA-512
```
  Broker 侧还需要额外的 JAAS 配置，在《AutoMQ SASL 安全身份认证配置教程》中已经提及，这里不再赘述。下文将详细介绍认证方法和鉴权规则。
  以下以“PLAINTEXT、安全协议、
  鉴权
  鉴权是基于认证主体，检查是否有权限操作请求的资源。DELETE 等；
- AclPermissionType：允许/禁止。
  编辑导读：本篇内容将进一步介绍 Kafka 中的认证、CREATE、Write、接着分别介绍 Kafka 中支持的多种认证协议，以及 ACL 鉴权策略。
  升级认证协议或开启鉴权
  某些情况下我们需要考虑安全协议的切换，或者需要将集群从无鉴权转为开启鉴权。

一句话串联上述规则信息就是：

允许/禁止来自 {Host} 的用户 {Principal} 对匹配类型为 {PatternType} 、

认证协议

安全协议到认证协议之间的映射为：

PLAINTEXT：无认证；
SSL：无认证/mTLS；
SASL_PLAINTEXT: SASL;
SASL_SSL: SASL;

其中 SSL 如果想要利用 mTLS 进行认证，需要在 broker 侧开启对 client 的 SSL 验证：

ssl.client.auth=required

利用证书中的“DistinguishedName”字段[4]识别认证主体。false 表示仅允许 super user 操作，true 表示允许任意用户操作。对于 Host 字段，填写“*” 表示任意地址。

此外，当 ResourceType 为 CLUSTER 时，ResourceName 只能填写"kafka-cluster"。这种静态认证方式同样不利于用户的动态管理，可以通过集成外部的账密认证服务器来提供动态能力。名称为 {ResourceName} 的资源进行 {AclOperation} 操作。

原始配置

以下为第一个节点在 PLAINTEXT 协议下的部分配置，其他节点配置依次类推：

node.id=1controller.quorum.voters=1@localhost:9093,2@localhost:9095,3@localhost:9097listeners=PLAINTEXT://:9092,CONTROLLER://:9093inter.broker.listener.name=PLAINTEXTadvertised.listeners=PLAINTEXT://localhost:9092controller.listener.names=CONTROLLERlistener.security.protocol.map=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL

阶段一：新协议+默认 ALLOW 鉴权上线

node.id=1# 保持不变controller.quorum.voters=1@localhost:9093,2@localhost:9095,3@localhost:9097# controller 和 broker 的新 listener 上线listeners=PLAINTEXT://:9092,CONTROLLER://:9093,BROKER_SASL://:9192,CONTROLLER_SASL://:9193# 保持不变inter.broker.listener.name=PLAINTEXT# 新地址上线advertised.listeners=PLAINTEXT://localhost:9092,BROKER_SASL://localhost:9192# 新 listener 上线controller.listener.names=CONTROLLER,CONTROLLER_SASL# authorizationauthorizer.class.name=org.apache.kafka.metadata.authorizer.StandardAuthorizer# 允许所有人访问资源allow.everyone.if.no.acl.found=true# 超级用户，用于节点之间认证super.users=User:automqsasl.enabled.mechanisms=SCRAM-SHA-256,PLAIN,SCRAM-SHA-512# 指定与 broker 通信时具体的 SASL 机制sasl.mechanism.inter.broker.protocol=PLAIN# 指定与 controller 通信时具体的 SASL 机制sasl.mechanism.controller.protocol=PLAIN# 静态账密配置listener.name.broker_sasl.plain.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \username="automq"\password="automq-secret"\user_automq="automq-secret";listener.name.controller_sasl.plain.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \username="automq"\password="automq-secret"\user_automq="automq-secret";# 认证模块配置listener.name.broker_sasl.scram-sha-256.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.controller_sasl.scram-sha-256.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.broker_sasl.scram-sha-512.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.controller_sasl.scram-sha-512.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;# 添加新 listener 到 安全协议的映射listener.security.protocol.map=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL,BROKER_SASL:SASL_PLAINTEXT,CONTROLLER_SASL:SASL_PLAINTEXT

其中“allow.everyone.if.no.acl.found”设置为 true，是为了让线上的 client 能够正常认证，避免直接鉴权失败。同时，需要为各业务方配置 ACL 所需的规则。

Listener、

阶段二：节点之间使用新协议+鉴权开启

在上一阶段执行后，新协议下的 listener 已经上线，并可以对外提供服务，但是集群的节点之间依旧维持原有的通信协议，本阶段会将内部通信进行升级：

node.id=1# 使用新 controller 端口controller.quorum.voters=1@localhost:9193,2@localhost:9195,3@localhost:9197# 保持不变listeners=PLAINTEXT://:9092,CONTROLLER://:9093,BROKER_SASL://:9192,CONTROLLER_SASL://:9193# 使用新协议inter.broker.listener.name=BROKER_SASL# 使用新地址advertised.listeners=PLAINTEXT://localhost:9092,BROKER_SASL://localhost:9192# 注意顺序变化controller.listener.names=CONTROLLER_SASL,CONTROLLER# authorizationauthorizer.class.name=org.apache.kafka.metadata.authorizer.StandardAuthorizer# allow.everyone.if.no.acl.found=truesuper.users=User:automq# 保持不变sasl.enabled.mechanisms=SCRAM-SHA-256,PLAIN,SCRAM-SHA-512sasl.mechanism.inter.broker.protocol=PLAINsasl.mechanism.controller.protocol=PLAINlistener.name.broker_sasl.plain.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \username="automq"\password="automq-secret"\user_automq="automq-secret";listener.name.controller_sasl.plain.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \username="automq"\password="automq-secret"\user_automq="automq-secret";# 保持不变listener.name.broker_sasl.scram-sha-256.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.controller_sasl.scram-sha-256.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.broker_sasl.scram-sha-512.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;listener.name.controller_sasl.scram-sha-512.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required;# 保持不变listener.security.protocol.map=CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT,SSL:SSL,SASL_PLAINTEXT:SASL_PLAINTEXT,SASL_SSL:SASL_SSL,BROKER_SASL:SASL_PLAINTEXT,CONTROLLER_SASL:SASL_PLAINTEXT

注意，“allow.everyone.if.no.acl.found”配置被注释掉了，也就是不再默认允许任何人任意操作资源了。

鉴权配置

重要的配置包括：

authorizer.class.name：指定鉴权器，默认为空。
以下假定三台 Kafka 节点都在本机部署，使用不同的端口以示区分。格式为 User:{userName}。例如，在开发环境中，我们通常直接用默认的 PLAINTEXT 配置集群，如果不幸在测试或生产环境中也使用了 PLAINTEXT 协议，那么就需要考虑升级安全协议并开启鉴权。注意，各个阶段变更时，需要一一重启各个节点。安全协议、一般情况下，我们可以利用多 listener 来差异化设置：
- broker 与 broker 之间，controller 与 broker 之间，client 与 broker 之间的通信安全协议；
- 内网（局域网或 VPC 内部）访问 broker、GROUP（消费者组）、
鉴权规则
Kafka 是基于 ACL（access control list）规则限制用户对资源的访问的。
整体逻辑示意图：
集群共需要三轮重启，业务侧需要一轮重启。AutoMQ 是与 Apache Kafka 100% 完全兼容的新一代 Kafka，可以帮助用户降低 90%以上的 Kafka 成本并且进行极速地自动弹性。CLUSTER 等；
ResourceName：资源名称；
PatternType：资源匹配方式，包括 LITERAL（全文匹配）和 PREFIXED（前缀匹配）；

AccessControlEntry：用户限制信息，包括：

Principal：认证主体，其实就是个用户名；
Host：用户主机地址；
AclOperation：操作行为，包括 Read、
需要注意的是，可以将通配符“*”作为 ResourceName 或 Host 的内容。开启鉴权”为例，介绍如何平滑过渡。
“controller.listener.names”设置为“CONTROLLER，CONTROLLER_SASL”，表示 controller 同时使用两个 listener，并且本 node 的 broker 将使用“CONTROLLER”映射的安全协议与 controller 通信。一个 KafkaPrincipal 对象主要包括主体类型（目前仅有"User"这一类别）以及一个名称（可以简单理解为 client 声明的用户名）。
当同时满足：
- 存在某条 ACL 允许用户操作
- 不存在任何一条 ACL 禁止用户操作
时，允许用户对资源进行操作。
认证
认证主体
先简单介绍一下认证主体的概念。其他安全协议的变化可以以此类推。无鉴权”升级为“SASL_PLAINTEXT、

学生姓名：
男女
联系电话：
意向班型：
我是学生我是家长

咨询热线：	400-029-7969
咨询电话：	029-61855169 029-61855069
学校邮箱：	bfzx365@163.com
学校地址：	西安市雁塔区长安西路66号

阶段三：下线旧协议

总结

参考文献

鉴权

升级认证协议或开启鉴权