IP whitelisting
The REST API accepts requests only from your organization’s active IP addresses.
A request from any other address is rejected with 403 Forbidden, even when its
API key is valid.
Add an IP address
-
Find your server’s outbound public IP address. From the server, run:
-
Go to Dashboard → Organization Security → API IP Whitelist (
/dashboard/organization). -
Click Request IP, enter the address and your authenticator code, then submit.
-
The Cheddar team reviews the request. The address starts working when its status changes to Active.
Enter each address exactly, in IPv4 or IPv6 form. CIDR ranges are not supported, so add every outbound address your servers use.
Statuses
The table also shows when each address was requested, approved, and revoked.
Revoke an IP address
Click Revoke next to the address and enter your authenticator code. Revoking takes effect immediately. To use the address again, request it again and wait for approval.
If you revoke your last active address, every REST API request is rejected until a new address is approved.
Change server IP addresses
- Request the new address and wait until it is Active.
- Move your traffic to the new address.
- Revoke the old address.
Troubleshooting 403 Forbidden
- Confirm the address your server actually sends from. NAT gateways, proxies, and VPNs change it.
- Confirm that address is Active in the dashboard.
- For IPv6 traffic, add the IPv6 address.
- Check that your API key belongs to the organization where the address is listed.