Issue Description:
Users are unable to find the IP Whitelist configuration option within the Agora Console. This issue prevents authorized API calls such as sending messages or automatically adding members to groups from being executed, resulting in access restriction errors.
Platform/SDK:
Agora Chat REST APIs integrated with the Laravel Framework (server-side), accessed through the Agora Console (Web).
Error Message:
{
"error": "forbidden_op",
"exception": "EasemobForbiddenOpException",
"timestamp": "*************",
"duration": 0,
"error_description": "not allowed ip address"
}
Step by Step Solution:
1. Access the Agora Console:
Log in to your Agora Console using your project credentials.
2. Open Your Chat Configuration:
- From the main dashboard, select your Chat Project.
- Navigate to Chat > Configuration.
3. Locate the IP Whitelist Section:
The IP Whitelist option may no longer appear directly under the “Features” tab due to recent changes in the Console UI.
To access it:
- Go to the Domain Filter section.
- Click on Rule Config.
- You should now see the IP Whitelist configuration page.
4. Add Authorized IP Addresses:
- Click Add IP Address.
- Enter the public IP address of your server or application host (e.g., your Laravel server IP).
- Save the configuration.
5. Verify Access:
- After adding the IP(s), re-run your API operations (such as sending messages or adding members).
- The requests should now succeed without the “forbidden_op” error.
6. If the Option Still Doesn’t Appear:
- Try accessing the Console in a new browser profile or incognito window to rule out cached interface issues.
- If unavailable, click the Configuration button found in the Features Overview section to reinitialize your feature configuration view.
Root Cause:
The IP Whitelist management panel was recently moved within the Console’s user interface. As a result, users may not find it under the previous location (“Features” tab) due to internal tab merging and interface updates.
Prevention/Best Practice:
- Regularly clear browser cache or use updated browser profiles when accessing the Agora Console to ensure the interface reflects the latest version.
- After major console UI releases, review the Change Logs or Product Update Announcements to stay informed on any relocated configuration menus.
Corresponding Document/Link:
- Agora Chat Console Configuration Guide
- Agora RESTful API Authentication and Security