文档中心

文档数据库 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 个白名单。

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

实例创建时绑定白名单

您可以在创建 MongoDB 实例时，直接将实例加入白名单中，方便白名单中的客户端对实例进行访问。具体操作步骤，请参见创建实例。

实例创建后绑定白名单

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

根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。

在目标实例类型列表页，单击目标实例名称。

在实例详情页，单击数据安全页签。

在白名单子页签下，单击绑定白名单。

在弹出的控制面板中，先确认实例名称和所属项目信息，再根据选择的绑定模式，完成后续操作。

若选择了已有白名单（即绑定已有白名单至当前实例），您需要：

在已有白名单列表中勾选需要绑定的白名单。

单击确定。

若选择了新白名单（即创建一个新的白名单，并自动绑定至当前实例）您需要：

从所属项目下拉列表中，为新建白名单选择需要加入的项目，默认会加入 default 项目。

输入新的白名单名称、描述（选填）和 IP 地址。

单击确定。

说明

关于创建白名单时的名称、描述和 IP 地址配置的更多说明，请参见创建白名单。

若通过子用户使用 MongoDB 云服务，您只能看到已为当前子用户授权项目下的白名单信息。更多详情，请参见通过子用户使用 MongoDB 云服务。

API	描述
CreateAllowList	调用 CreateAllowList 接口创建一个新的 IP 白名单。
ModifyAllowList	调用 ModifyAllowList 接口修改目标白名单设置（例如白名单名称、IP 白名单地址、是否设置为默认白名单等）。
DescribeAllowLists	调用 DescribeAllowLists 接口查询当前账号下指定地域内的 IP 白名单列表。
DescribeAllowListDetail	调用 DescribeAllowListDetail 接口查询目标白名单的详细信息，包括 IP 地址和绑定的实例详情。
AssociateAllowList	调用 AssociateAllowList 接口将目标 MongoDB 实例绑定到指定 IP 白名单。