Skip to main content
The IP ACL object represents a whitelisted IPv4 address that can authenticate to a trunk without requiring credentials. Each IP ACL entry is associated with a trunk and contains the IP address along with optional metadata such as description and enabled status.
IPv4 addresses: The ip_address field takes IPv4 addresses in standard dotted-decimal notation (e.g., 192.168.1.1).Public IPs: Ensure you whitelist the public IP address, not private/internal IPs. For devices behind NAT, use the router’s public IP address.

Attributes

Example

IP ACL Object Response

A typical IP ACL object returned by the API:
IP ACL Object
Best Practices:
  • Only whitelist IP addresses you control and trust
  • Use descriptive descriptions to identify each IP’s purpose
  • Regularly audit your IP ACL list and remove unused entries
  • For dynamic IPs, consider using credential authentication instead
  • Test connectivity after adding new IP addresses
  • Disable rather than delete entries when temporarily blocking access
Propagation: IP authentication is evaluated before digest authentication for every trunk on your account, and changes to IP ACLs (disable or delete) can take some time to propagate to the SIP edge. To test digest authentication on a credential trunk, make sure no ACL on your account contains that source IP.
Finding Your Public IP: To check your public IP address, run curl https://api.ipify.org from your command line or visit the URL in your browser.