文档中心

云数据库 MySQL 版

白名单管理

修改白名单

白名单是数据库连接的安全防控手段，只有添加到白名单的 IP 地址才能够成功访问 MySQL 实例。为保证数据库连接的安全性，白名单需要定期维护以清除不再需要访问数据库的 IP 地址。本文介绍编辑白名单的方式以对白名单和白名单中的 IP 地址进行管理。

背景信息

白名单是数据库连接的安全防控手段，只有白名单内的 IP 地址才能访问数据库。MySQL 实例在创建后，不会绑定任何白名单，默认禁止所有 IP 地址访问实例。因此无论是通过 VPC 内网还是通过公网连接访问实例，均需要先配置实例的白名单，才能保证实例可连接。

白名单支持设置 CIDR 格式的 IP 地址段，如：192.168.0.0/32（（/）后面可输入 0~32 间的任一整数），允许该网段内 IP 地址访问。

MySQL 白名单已支持关联 ECS 安全组，支持为 MySQL 白名单绑定 ECS 安全组。绑定 ECS 安全组后，可以将对应 ECS 安全组下所有的 ECS 实例的 IP 地址导入到该白名单中，使这些 ECS 安全组下的所有 ECS 实例都可以访问该白名单绑定的 MySQL 实例。

云数据库 MySQL 版支持将某个白名单设置为默认白名单。设置为默认白名单后，在创建新实例、恢复到新实例和购买新实例时，都会自动绑定默认白名单。

如果您之前使用过数据库工作台（DBW）提供的会话管理功能，或使用过数据库传输服务（DTS）对 MySQL 实例进行过操作，实例会被添加系统内置白名单。系统内置白名单不支持编辑、解绑或删除。

DBW 为 MySQL 实例添加的内置白名单名为 DBW_Sole_Group_Name_For_RDS。

DTS 为 MySQL 实例添加的内置白名单名为 dts_internal_for_EndpointVolcMySQL。

白名单需要定期维护，移除不再需要访问 MySQL 实例的 IP 地址，保障数据库连接的安全性。

注意事项

如果您移除了某些 IP 地址，那么这些 IP 将不再能够访问与白名单绑定的这些数据库实例，请谨慎操作。

从移除的 IP 发起的会话与连接不会在服务端主动关闭，可以在会话管理中进行查询和处理。

如果 MySQL 白名单绑定的 ECS 安全组有更新，可直接将更新同步到白名单。更多详细信息，请参见同步安全组。

如白名单绑定的实例状态为运行中，白名单的修改会立即同步到实例。如果白名单绑定的实例状态不满足此条件，系统会在条件满足时自动进行同步。如果在实例状态符合条件后未立即同步，您也可以在白名单详情页面手动同步白名单。

云数据库 MySQL 版的白名单功能进行了升级，支持了项目鉴权能力。项目鉴权能力上线后，历史白名单会自动归属于“全局资源”项目。对于“全局资源”项目下的白名单，需在顶部导航栏选择“账号全部资源”项目后才能查看。不建议为实例绑定其他项目的白名单。若缺少其他项目的相关权限，将无法对白名单进行编辑、删除等操作。

从白名单移除的 IP 地址发起的会话与连接不会在服务端主动关闭，可以在会话管理中进行查询和处理，也可以通过清理非白会话进行处理。

使用限制

每个白名单最多可以包含 300 个 IP 或 IP 段。当 IP 地址较多时，建议将零散的 IP 合并为 IP 段。

每个白名单最多可绑定 10 个安全组。

如果修改白名单时指定其为默认白名单，该白名单会替代原有的默认白名单（如有）。

操作步骤

登录云数据库 MySQL 版控制台。

在顶部菜单栏，选择白名单所属的地域。

在左侧导航栏单击白名单列表。

单击目标白名单的操作列的编辑按钮，进入编辑白名单信息页面。

修改白名单的名称、描述、IP 地址、是否为默认白名单、以及安全组信息后，单击确定。

参数	说明
白名单名称	必填。命名规则如下：名称唯一。以中文、字母或下划线（_）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度为 1~128 个字符。
描述	选填。描述信息可以用于在白名单列表中搜索白名单，描述内容长度应不超过 200 个字符。
IP 地址	必填。只有添加到白名单中的 IP 地址才可以访问该实例。支持粘贴 IP 地址或地址段，以中英文逗号、空格或换行符隔开。
默认白名单	选择是否为默认白名单。可在租户维度设定一个默认白名单，创建 MySQL 实例时将默认选中此白名单。说明一个白名单最多可绑定 500 个实例，超过上限后请修改默认白名单。
安全组	支持将云数据库 MySQL 版白名单关联 ECS 安全组。如果在关联后调整了 ECS 安全组，可在云数据库 MySQL 版白名单同步安全组，及时获得最新的 IP 列表。单击选择安全组，在编辑安全组窗口中选择需要绑定的安全组。支持通过两种模式进行绑定：关联 ECSIP：允许安全组内的云服务器访问数据库，当前仅支持主网卡的IP信息导入。入方向 IP：允许安全组入方向的源地址中 TCP 协议和 ALL 协议涉及的 IP 访问数据库，若源地址中配置为安全组将被忽略。说明可同时通过两种方式关联 ECS 安全组。采用入方向 IP 模式绑定安全组时，如果安全组中某地址的策略为拒绝，那么该地址将不会被加入到 MySQL 白名单。

说明

单击确定后系统会判断该白名单绑定的安全组是否有更新。如果有更新，则会弹出检测到绑定的安全组存在更新，是否进行同步对话框，在对话框中列出了安全组的 IP 变化。可根据需要选择同步或不同步。

同步：系统将自动识别白名单绑定的安全组的 IP 变化并更新到白名单。

不同步：则忽略这些 IP 变化，在白名单中保留安全组中原有的 IP。

API	说明
ModifyAllowList	调用 ModifyAllowList 接口修改目标白名单设置（例如白名单名称、 IP 白名单地址等）。