# 配置Kafka实例的明文/密文接入 您可以通过明文接入Kafka实例，也可以通过密文接入Kafka实例，本章节指导您在控制台修改接入方式。 - 明文接入：表示客户端连接Kafka实例时，无需进行SASL认证。 - 密文接入：表示客户端连接Kafka实例时，需要进行SASL认证。 #### 约束与限制 - 首次修改接入方式时，部分实例会重启，另一部分实例不会重启，具体以控制台提示为准。实例重启大约需要75\~80s。后续再次修改接入方式时，实例不会再重启。 - 单机实例只支持开启/关闭公网访问的明文接入。 - 开启了IPv6功能后，不支持修改实例的接入方式。 #### 前提条件 只有处于"运行中"状态的Kafka实例才可以修改接入方式。 #### 配置Kafka实例的明文接入 明文接入表示客户端连接Kafka实例时，无需进行SASL认证。 - [开启明文接入] 1. 登录[Kafka控制台](https://console.huaweicloud.com/dms/?engine=kafka&locale=zh-cn#/queue/manager/newKafkaList)。 2. 在管理控制台左上角单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0143929918.png)，选择Kafka实例所在的区域。 3. 单击Kafka实例的名称，进入实例的"概览"页面。 4. 明文接入分为内网访问明文接入和公网访问明文接入，开启明文接入方法如[表1]所示。 表1开启明文接入方法 | 接入方式 | 开启明文接入 | |:---|:---| | 内网访问明文接入 | 1. 在"内网访问 \> 明文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001191767177.png)，弹出确认对话框。 2. 单击"确定"，跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功开启明文接入。 | | 公网访问明文接入 | 1. 确认公网访问已开启，如果未开启，请开启公网访问，具体步骤参考[配置Kafka实例的公网访问](https://support.huaweicloud.com/usermanual-kafka/kafka-ug-0319001.html)。 2. 在"公网访问 \> 明文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001191767177.png)，弹出确认对话框。 3. 单击"确定"，跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功开启明文接入。 | - [关闭明文接入] 1. 登录[Kafka控制台](https://console.huaweicloud.com/dms/?engine=kafka&locale=zh-cn#/queue/manager/newKafkaList)。 2. 在管理控制台左上角单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0143929918.png "点击放大")，选择Kafka实例所在的区域。 3. 单击Kafka实例的名称，进入实例的"概览"页面。 4. 明文接入分为内网访问明文接入和公网访问明文接入，关闭明文接入方法如[表2]所示。 表2关闭明文接入方法 | 接入方式 | 关闭明文接入 | |:---|:---| | 内网访问明文接入 | 内网访问不支持关闭，明文接入和密文接入至少开启一个。如果密文接入没有开启，此时无法关闭明文接入。 1. 在"内网访问 \> 明文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000002282572604.png)，弹出确认对话框。 2. 单击"确定"，跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功关闭明文接入。 | | 公网访问明文接入 | 1. 在"公网访问 \> 明文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000002282469332.png)，弹出确认对话框。 2. 单击"确定"，跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功关闭明文接入。 | #### 配置Kafka实例的密文接入 密文接入表示客户端连接Kafka实例时，需要进行SASL认证。 - [开启密文接入] 1. 登录[Kafka控制台](https://console.huaweicloud.com/dms/?engine=kafka&locale=zh-cn#/queue/manager/newKafkaList)。 2. 在管理控制台左上角单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0143929918.png)，选择Kafka实例所在的区域。 3. 单击Kafka实例的名称，进入实例的"概览"页面。 4. 密文接入分为内网访问密文接入和公网访问密文接入，开启密文接入方法如[表3]所示。 表3开启密文接入方法 | 接入方式 | 开启密文接入 | |:---|:---| | 内网访问密文接入 | 1. 在"内网访问 \> 密文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001191767177.png)，弹出"内网访问密文接入"对话框。 2. 设置[kafka安全协议、SASL PLAIN机制、用户名和密码]，单击"确定"。跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功开启密文接入。 说明： 首次开启密文接入（包括内网访问密文接入和公网访问密文接入）时，需要设置kafka安全协议、SASL PLAIN机制、用户名和密码，再次开启时，只需要设置kafka安全协议。 | | 公网访问密文接入 | 1. 确认公网访问已开启，如果未开启，请开启公网访问，具体步骤参考[配置Kafka实例的公网访问](https://support.huaweicloud.com/usermanual-kafka/kafka-ug-0319001.html)。 2. 在"公网访问 \> 密文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001191767177.png)，弹出"公网访问密文接入"对话框。 3. 设置[kafka安全协议、SASL PLAIN机制、用户名和密码]，单击"确定"。跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功开启密文接入。 说明： 首次开启密文接入（包括内网访问密文接入和公网访问密文接入）时，需要设置kafka安全协议、SASL PLAIN机制、用户名和密码，再次开启时，只需要设置kafka安全协议。 | kafka安全协议、SASL PLAIN机制、用户名和密码的参数解释如下： 表4密文接入参数说明 | 参数名称 | 参数值 | 说明 | |:---|:---|:---| | kafka安全协议 | SASL_SSL | 采用SASL方式进行认证，数据通过SSL证书进行加密传输，安全性更高。 | | kafka安全协议 | SASL_PLAINTEXT | 采用SASL方式进行认证，数据通过明文传输，性能更好。 由于明文传输，建议使用SCRAM-SHA-512机制。 | | SASL PLAIN机制 | - | - 未开启"SASL PLAIN机制"时，使用SCRAM-SHA-512机制对账号密码进行认证。 - 开启"SASL PLAIN机制"后，同时支持SCRAM-SHA-512机制和PLAIN机制，根据实际情况选择其中任意一种配置连接。 密文接入成功开启后，SASL PLAIN机制不支持修改。 **什么是SCRAM-SHA-512机制和PLAIN机制？** - SCRAM-SHA-512机制：采用哈希算法对用户名与密码生成凭证，进行身份校验的安全认证机制，比PLAIN机制安全性更高。 - PLAIN机制：一种简单的用户名密码校验机制。 | | 用户名、密码 | - | 客户端用于连接Kafka实例的用户名和密码。 用户名需要符合以下命名规则：由英文字母开头，且只能由英文字母、数字、中划线、下划线组成，长度为4\~64个字符。 密码需要符合以下规则： - 长度为8\~32个字符。 - 至少包含以下字符中的3种：大写字母、小写字母、数字、特殊字符\`\~!@#$%\^\&\*()-_=+\\\|\[{}\];:'",\<.\>?和空格，并且不能以-开头。 - 不能与用户名或倒序的用户名相同。 密文接入成功开启后，用户名不支持修改。 | kafka安全协议、SASL PLAIN机制、用户名和密码在客户端连接已开启密文接入的Kafka实例时需要配置，具体请参考[使用客户端连接Kafka（密文接入）](https://support.huaweicloud.com/usermanual-kafka/kafka-ug-180801001.html)。 - [关闭密文接入] 1. 登录[Kafka控制台](https://console.huaweicloud.com/dms/?engine=kafka&locale=zh-cn#/queue/manager/newKafkaList)。 2. 在管理控制台左上角单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0143929918.png "点击放大")，选择Kafka实例所在的区域。 3. 单击Kafka实例的名称，进入实例的"概览"页面。 4. 密文接入分为内网访问密文接入和公网访问密文接入，关闭密文接入方法如[表5]所示。 表5关闭密文接入方法 | 接入方式 | 关闭明文接入 | |:---|:---| | 内网访问密文接入 | 1. 在"内网访问 \> 密文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001933681676.png)，弹出确认对话框。 2. 单击"确定"，跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功关闭密文接入。 | | 公网访问密文接入 | 1. 在"公网访问 \> 密文接入"后，单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001930152461.png)![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0000001146496197.png)，弹出确认对话框。 2. 单击"确定"，跳转到"后台任务管理"页面。当任务状态显示为"成功"时，表示成功关闭密文接入。 | 关闭内网访问密文接入和公网访问密文接入后，已创建的用户不会被删除，下次开启密文接入时，无需再次创建用户。