文档中心

文档数据库 MongoDB 版

白名单管理

创建白名单

文档数据库 MongoDB 版实例创建成功后，您可以为实例设置白名单，以允许外部设备访问该实例。本文介绍如何通过控制台创建白名单。

背景信息

为保证 MongoDB 数据库的安全性和稳定性，系统默认禁止所有 IP 地址访问 MongoDB 实例。在开始使用 MongoDB 实例前，您需要先创建白名单，并将客户端的 IP 地址或 IP 地址段添加到 MongoDB 实例的白名单中，以允许该客户端访问 MongoDB 实例。建议您定期维护和管理白名单，提高 MongoDB 实例访问的安全性。

使用限制

每个火山引擎主账号在每个地域下最多可以创建 500 个 IP 白名单。

每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。

每个白名单中最多添加 1000 个 IP 地址（或 CIDR 格式的 IP 地址段）。

每个白名单最多支持绑定 500 个实例。

每个白名单每次可最多批量绑定 200 个实例。

每个实例最多支持绑定 100 个白名单，但每个实例绑定的所有白名单中，IP 地址或 CIDR 格式的 IP 地址段的总和不可超过 1000 个。

每个实例每次可最多批量绑定 100 个白名单。

如果一个实例没有绑定任何白名单，表示禁止所有地址访问。

操作步骤

在顶部菜单栏，选择实例所属的项目和地域。

在左侧导航栏中，选择 NoSQL 数据库 > MongoDB > 白名单列表。

在白名单列表页，单击创建白名单。

在创建白名单控制面板中，设置如下配置。

参数	说明
所属项目	从下拉列表中为白名单选择需要加入的项目，默认会加入 default 项目。说明若通过子用户使用 MongoDB 云服务，您只能看到已为当前子用户授权项目下的白名单信息。更多详情，请参见通过子用户使用 MongoDB 云服务。
白名单名称	输入白名单名称，名称需同时满足如下要求：不能以数字、中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需为 1~128 个字符。
描述	输入白名单的备注信息，长度不可超过 200 个字符。
IP地址	输入 IP 地址或 CIDR 格式的 IP 地址段。说明每个白名单中最多支持设置 1000 个 IP 地址或 CIDR 格式的 IP 地址段。不允许设置重复的地址，多个地址间用英文逗号（,）隔开。设置 0.0.0.0/0，表示允许所有地址访问。设置 127.0.0.1，表示禁止所有地址访问。同时设置 0.0.0.0/0 和 127.0.0.1，表示允许所有地址访问。设置 CIDR 192.168.1.0/24，表示允许该网段内的 IP 地址访问。设置 192.168.1.1，表示仅允许该 IP 地址访问。
默认白名单	选择是否将新建白名单设置为默认白名单。设置为默认白名单后，新建实例时会自动选中默认白名单。说明每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。更多详情，请参见约束与限制。

单击确定。

后续步骤

白名单创建完成后，您可以将该分组绑定至目标实例。白名单绑定方法，请参见绑定实例和白名单。

API	描述
CreateAllowList	调用 CreateAllowList 接口创建一个新的 IP 白名单。
DescribeAllowLists	调用 DescribeAllowLists 接口查询当前账号下指定地域内的 IP 白名单列表。
DescribeAllowListDetail	调用 DescribeAllowListDetail 接口查询目标白名单的详细信息，包括 IP 地址和绑定的实例详情。