
# 修改接入认证配置
#### 操作场景
您可根据业务使用场景修改接入认证配置。修改后，已应用原认证配置的当前会话可以正常使用，但应用原认证配置的新建会话在不满足新认证配置的情况下将无法连接。请确认修改的接入认证符合您的业务需求，并谨慎操作。
#### 约束限制
- 修改客户端接入认证配置，需要实例所有节点都是正常状态。
- 在跨Region容灾场景下，修改主实例的客户端接入认证配置，灾备实例不会自动同步，灾备实例如需修改接入认证配置，需要去灾备实例端手动修改。
- V2.0-8.1.0及以上版本的实例支持ADDRESS配置IPv6地址。如何查看实例版本请参见[查看数据库引擎版本](https://support.huaweicloud.com/productdesc-gaussdb/gaussdb_01_012.html#section2)。
- 集中式版实例配置信息会同步到所有节点，分布式版实例配置信息会同步所有CN组件。
- 外部客户端使用M-Compatibility兼容协议远程连接M-Compatibility数据库时，只支持sha256认证方式。
- 修改接入认证配置后，在新创建会话时会生效。
- 若新增策略中除ADDRESS外的其他字段与已有策略一致，且新ADDRESS网段语义等同于已有策略，系统将自动覆盖原有策略。示例如下：
  如果在新增前已有如下策略：
  ```
  TYPE   DATABASE        USER    ADDRESS                 METHOD
  host    all            all     0.0.0.0/0               sha256
  host    all            all     192.168.10.0/16         sha256
  ```
  新增如下策略：
  ```
  TYPE   DATABASE        USER    ADDRESS                 METHOD
  host    all            all     192.168.10.10/0         sha256
  ```
  最终策略结果如下：
  ```
  TYPE   DATABASE        USER    ADDRESS                 METHOD
  host    all            all     192.168.10.10/0         sha256
  host    all            all     192.168.10.0/16         sha256
  ```
  
 
#### 操作步骤
1. [登录云数据库GaussDB控制台](https://console.huaweicloud.com/gaussdb/?locale=zh-cn#/gaussdb/management/list)。
2. 在"实例管理"页面，选择指定的实例，单击实例的名称，进入"基本信息"页面。
3. 在左侧导航栏选择"数据库管理 \> 接入认证管理"。
4. 在"接入认证配置"页签，选择目标配置，单击操作列的"修改"。 
   图1修改接入认证配置   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002649934172.png "点击放大")
   
   
   
5. 修改认证配置，修改完成后，单击操作列的"保存"。 
   图2修改接入认证配置   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002649774278.png "点击放大")
   
   表1参数说明 
   | **参数名称** | **参数解释**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   |:---|:---|
   | TYPE     | 客户端连接类型。 - host：表示数据库实例既接受一个普通的TCP/IP套接字连接，也接受一个经过SSL加密的TCP/IP套接字连接。  - hostssl：表示数据库实例只接受一个经过SSL加密的TCP/IP套接字连接。  - hostnossl：表示数据库实例只接受一个普通的TCP/IP套接字连接。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | DATABASE | 声明允许访问的数据库。 - all：表示该记录匹配所有数据库。  - 特定的数据库名称或者数据库列表。 说明： - 值replication表示如果请求一个复制连接，则匹配，但复制连接不表示任何特定的数据库。如需使用名为replication的数据库，需在database列使用记录"replication"作为数据库名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | USER     | 声明允许访问的数据库用户。 - all：表明该记录匹配所有用户。  - 特定的数据库用户名或者用户列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | ADDRESS  | 指定允许访问的IP地址范围。 - 当前仅支持IP地址/掩码长度格式。  - V2.0-8.1.0及以上的数据库引擎版本支持ADDRESS配置IPv6的IP地址。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | METHOD   | 声明连接时使用的认证方法。 - reject：无条件地拒绝连接。常用于过滤某些主机。  - md5：MD5加密算法安全性低，存在安全风险，不推荐使用，建议使用更安全的加密算法。默认不支持，若需启用，可通过修改password_encryption_type参数进行配置，如何修改参数可参见[修改实例参数](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_166.html#ZH-CN_TOPIC_0000002649932710__section267472834710)。  - sha256：要求客户端提供一个sha256算法加密的口令进行认证，该口令在传送过程中结合salt（服务器发送给客户端的随机数）的单向sha256加密，增强了安全性。  - sm3：要求客户端提供一个sm3算法加密口令进行认证，该口令在传送过程中结合salt（服务器发送给客户端的随机数）的单向sm3加密，增加了安全性。  - cert：客户端证书认证模式，此模式需进行SSL连接配置且需要客户端提供有效的SSL证书，不需要提供用户密码。cert认证方式只支持hostssl类型的规则。   |
      
   
   
6. 保存成功后，您可以在列表中查看已修改后的配置信息。
