All Products
Search
Document Center

PolarDB:Configure whitelists

Last Updated:Jun 11, 2025

You can configure whitelists for your PolarDB-X instance. Whitelists do not affect the performance of the PolarDB-X instance in a negative manner. We recommend that you manage the whitelists of your database instance on a regular basis. This can help ensure that the data on your PolarDB-X instance is secure. This topic describes how to configure a whitelist for your PolarDB-X instance.

Note

  • After you create a database in your PolarDB-X instance, the default whitelist contains only the 127.0.0.1 IP address. In this case, no IP addresses can access the database. To ensure that your data is secure, we recommend that you specify only the public IP addresses or CIDR blocks of your web servers in the whitelists of your instance.

  • You can create up to 50 whitelists for a PolarDB-X instance, and each whitelist can contain up to 300 IP addresses and CIDR blocks.

  • IPv6 addresses are not supported.

Add a whitelist

  1. Log on to the PolarDB-X console.

  2. In the top navigation bar, select the region where the instance is deployed.

  3. On the Instances page, click the PolarDB-X 2.0 tab.

  4. Find the instance that you want to manage and click its ID.

  5. In the left-side navigation pane, choose ConfigurationManagement > Safety management.

  6. On the Whitelist settings tab, click Add Whitelist.

  7. In the Add Whitelist panel, configure the parameters.

    Parameter

    Description

    Group Name

    Specify a name for the whitelist.

    Group Whitelist

    Specify IP addresses.

    Note
    • You can enter IP addresses and CIDR blocks. For example, you can enter the 192.168.0.1 IP address and the 192.168.0.0/24 CIDR block.

    • You can specify up to 300 IP addresses and CIDR blocks in a whitelist.

    • Separate multiple IP addresses and CIDR blocks with commas (,). For example, you can enter 192.168.0.1,192.168.0.0/24.

    • If you want to block access from all IP addresses, you can specify 127.0.0.1 in the whitelist.

    • Specify an IP address of 0.0.0.0/0 to allow access from all IP addresses. This may cause security risks. Proceed with caution.

  8. Click OK.

    Note

    The whitelist takes effect approximately 1 minute after it is created.

Modify a whitelist

  1. Log on to the PolarDB-X console.

  2. In the top navigation bar, select the region where the instance is deployed.

  3. On the Instances page, click the PolarDB-X 2.0 tab.

  4. Find the instance that you want to manage and click its ID.

  5. In the left-side navigation pane, choose ConfigurationManagement > Safety management.

  6. On the Whitelist settings tab, find the whitelist that you want to modify and click Configuration in the Operation column.

    456789

  7. In the Configure Whitelist panel, update the IP addresses or CIDR blocks in the Group Whitelist field.

    Parameter

    Description

    Group Whitelist

    Update the IP addresses or CIDR blocks.

    Note
    • You can enter IP addresses and CIDR blocks. For example, you can enter the 192.168.0.1 IP address and the 192.168.0.0/24 CIDR block.

    • You can specify up to 300 IP addresses and CIDR blocks in a whitelist.

    • Separate multiple IP addresses and CIDR blocks with commas (,). For example, you can enter 192.168.0.1,192.168.0.0/24.

    • If you want to block access from all IP addresses, you can specify 127.0.0.1 in the whitelist.

    • Specify an IP address of 0.0.0.0/0 to allow access from all IP addresses. This may cause security risks. Proceed with caution.

  8. Click OK.

    Note

    The whitelist modification takes effect after approximately 1 minute.

Delete a whitelist

  1. Log on to the PolarDB-X console.

  2. In the top navigation bar, select the region where the instance is deployed.

  3. On the Instances page, click the PolarDB-X 2.0 tab.

  4. Find the instance that you want to manage and click its ID.

  5. In the left-side navigation pane, choose ConfigurationManagement > Safety management.

  6. On the Whitelist settings tab, find the whitelist that you want to delete and click Delete in the Operation column.

    456789

  7. In the message that appears, click OK.