Understanding VergeCloud Error Codes

While using VergeCloud services, users may encounter specific error codes unique to the platform. These codes signify issues or violations of rules configured on VergeCloud. This guide explains common VergeCloud error codes, their causes, and solutions.

Firewall Error – Error Code 403

Error code 403 occurs when a request violates the firewall rules configured in the VergeCloud User Panel. This error commonly arises when access restrictions are based on geolocation or other parameters.

Common Scenario

For instance, if you configure your website to allow access only from a specific country, such as Iran, requests from other locations will be blocked and display error 403. However, even users from the allowed country might encounter this error if:

• Their IP address is mistakenly assigned to a different country. This can happen if their IP range is advertised from another region.
• Geo IP databases (e.g., MaxMind) have not yet updated their data to reflect the correct country for that IP range.

Until the geo IP data is updated, legitimate users may experience access issues despite being located in an allowed region.

Rate Limit Error – Error Code 429

Error code 429 appears when users exceed the limits set by VergeCloud’s rate-limiting feature. This feature restricts the number of requests or connections allowed for specific users within a defined time frame.

Common Scenario

Overly restrictive rate limits can unintentionally block legitimate users. For example, if you underestimate the traffic patterns of your users and set strict limits, they may encounter error 429, affecting their ability to access your website.

Secure Link Errors

VergeCloud’s secure link feature enables businesses to share protected resources like videos, educational materials, or sensitive files. Secure links restrict access based on parameters such as IP address, time window, and token, ensuring that only authorized users can access the content.

How Secure Links Work

When a secure link is generated, it includes a server-side hash calculated based on the specified parameters. If an unauthorized user tries to access the resource with incorrect parameters, the request fails because the provided hash does not match the expected server-side hash.

Secure Link Error Codes

Users may encounter the following errors when accessing secure links:

• Error Code 483 – Expired: The secure link has expired, and the user is attempting to access the file beyond the allowed time window.
• Error Code 484 – Invalid: The structure or length of the hash string does not match VergeCloud’s expected format.
• Error Code 485 – Denied: One or more parameters (e.g., IP address, timespan, or token) are incorrect, preventing the user from accessing the resource.

Customizing VergeCloud Error Pages

VergeCloud allows you to replace default error pages with custom ones for a personalized user experience. Follow these steps to set up custom error pages:

1. Log in to the VergeCloud user panel.
2. Navigate to the Content Delivery Network (CDN) section.
3. Locate the Customizing Errors section.
4. Choose and upload your custom error page designs.

Considerations

• Geo IP discrepancies may cause legitimate users to encounter firewall error 403. Monitor access logs and review geo IP configurations periodically.
• Set realistic rate limits to avoid unintentionally blocking valid users with error 429.
• When using secure links, ensure that parameters such as IP, time window, and token are correctly configured to prevent access errors.
• For a seamless user experience, customize error pages to align with your website’s branding.