IP Whitelist

he IP Whitelist feature allows you to designate a set of trusted IP addresses. Only registration or login requests originating from these IPs will be permitted. Once the Whitelist is enabled, any IP not on the list will be denied access, effectively enhancing your application's security.

Path: Console → Enter a specific application → Left navigation「Configuration」→ 「Security Settings」→ 「Risk Policies」→ Select “IP Whitelist” tab

 

1. Feature Overview

• IP addresses in the Whitelist are permitted to perform registration and login operations (the restriction type is fixed as “Allow registration/login”).

• When processing a request, the system checks the blacklist first, then the Whitelist.

  • If the IP is on the blacklist, it is directly rejected.

  • If the IP is not on the blacklist but the Whitelist is configured (at least one entry), then only IPs on the Whitelist are permitted; all other IPs are rejected.

  • If the Whitelist is empty (no IP configured), then no Whitelist restriction applies – all IPs are allowed (though they are still subject to blacklist checks).

• All configurations are managed per application and are independent of each other.

 

2. Whitelist List Page

The list page displays all added IP Whitelist entries in a table, supporting search and pagination.

List operations:

• Search: A search box at the top left of the list supports fuzzy search by IP address.

• Add IP: The “+ Add IP” button at the top right of the list opens an add modal.

3. Adding an IP to the Whitelist

Click the “+ Add IP” button to open a modal for entering the IP addresses to be allowed.

3.1Form fields

3.2Validation rules

• Frontend real‑time validation: Checks each IP format and correct comma separation. If invalid, an immediate prompt is shown (e.g., “Please enter a valid IP address”).

• Backend duplicate check: After submission, the system processes each IP individually. Any IP already on the Whitelist is automatically skipped without duplication and no user notification is shown. Only new IPs are successfully added.

3.3Saving and feedback

• Click “Confirm”: The modal closes, the list refreshes immediately, showing all successfully added IPs (including those already existing, which are not duplicated).

• No matter how many IPs are added in one batch, each IP appears as a separate record in the list for easy individual management.

• Click “Cancel” to close the modal without performing any action.

Propagation delay notice: After successfully adding an Whitelist entry, it may take up to 2 minutes to take effect globally. During this period, the new configuration may not yet be fully synchronized to all edge nodes. Please try again later.

 

4. Deleting an IP from the Whitelist

1. Find the IP to delete in the list and click the “Delete” button in its row.

2. A confirmation dialog appears:

3. Click “Confirm” to remove the IP from the Whitelist; the list will refresh automatically. Click “Cancel” to abort the deletion.