All Products
Search
Document Center

ApsaraDB for SelectDB:Configure IP address whitelist

Last Updated:Aug 24, 2026

By default, all IP addresses are blocked from accessing your ApsaraDB for SelectDB instance. Before you connect to an instance, add the required IP addresses or CIDR blocks to the instance's IP address whitelist.

Usage notes

  • Only IP addresses in an IP address whitelist can access your instance. We recommend that you review and maintain your whitelists regularly.

  • The default whitelist group (default) cannot be deleted. You can only modify or remove IP addresses within this group. By default, this group contains only the IP address 127.0.0.1.

  • Whitelist limits:

    • A single instance supports a maximum of 200 IP addresses and CIDR blocks across all whitelist groups.

    • A single whitelist group can contain a maximum of 50 IP addresses and CIDR blocks.

  • Changes to an IP address whitelist, such as adding, modifying, or deleting entries, take about one minute to take effect.

Important
  • Adding the CIDR block 0.0.0.0/0 to an IP address whitelist allows access from any IP address. This poses a high security risk and may lead to unauthorized access. Proceed with caution.

  • Once an IP address is added to an IP address whitelist, it is granted access to the related APIs of the ApsaraDB for SelectDB instance. To learn more about these APIs, see OPENAPI OVERVIEW.

Impact on instances

Configuring an IP address whitelist does not affect the normal operation of your ApsaraDB for SelectDB instance.

Procedure

  1. Log on to the ApsaraDB for SelectDB console.

  2. In the upper-left corner, select the region of your instance.

  3. On the Instances page, find the target instance and click its Instance ID.

  4. In the navigation pane on the left of the Instance Details page, click Data Security.

  5. On the whitelist group page, find the group named default and click Modify in the Actions column.

    Note

    Alternatively, click Create Whitelist. In the Create Whitelist panel, enter a Whitelist Name and add entries to the Whitelist field.

  6. In the Modify Whitelist panel, add IP addresses or CIDR blocks.

    Note

    An office network's public IP address can change frequently. The IP address you see may not be the actual public IP. Use an IP lookup service, such as whatsmyip, to confirm your public IP address.

  7. Click OK.

    Once saved, the new entries appear on the whitelist group page.

Next steps