🆕SBC Number Lookup

Documentation for the usage of the SBC Reverse number lookup

This feature is currently in preview

Applicable to version 5.3.4 and above Unified Contacts Pro only

With Unified Contacts 5.3.4 and later you can perform a reverse number lookup against contacts in the Unified Contacts Database and inject the DisplayName of the caller into the SIP header.

Setup

Unified Contacts Settings

Per default the SBC Lookup Endpoint is disabled. To enable it open the Unified Contacts Admin Portal and click on Settings. All settings will be have to be configured under the category SBC Lookup.

If you have updated recently and can't see the SBC Lookup Category you might have to clear your browser cache and reload the page.

Enable the SBC Lookup Endpoint

Per default the SBC Lookup Endpoint is disabled. To enable it open the Unified Contacts Admin portal at the root page. Navigate to Settings > SBC Lookup and enable the SBC Lookup Endpoint.

Configure IP Authentication

We highly recommend having IP Authentication enabled.

Without it you expose the lookup endpoint publicly into the internet, secured only by Basic Auth.

To allow access to the Endpoint you can specify an allow-list of IP addresses that are allowed to access the Endpoint. You can add any valid IPv4 or IPv6 address. Add it by entering the address into the input field and click on the + Button.

To delete an IP address from the allow-list click on the trash bin symbol.

The endpoint validates the last IP address in a forwarding chain. If you have the Unified Contacts AppService set up behind a reverse proxy, load balancer or other proxy service(s) the request will be treated as if it was send from the outbound IP address of the last proxy in the chain. In such cases make sure to implement your own firewall in front of the proxy service and add the IP address(es) of your proxy service(s) to the SBC Lookup endpoint allow-list.

Configure Authentication Credentials

As most SBCs don't support modern Authentication the SBC Lookup endpoint uses Basic Auth for Authenticating requests. To use the Endpoint you have to set a username and password. Those are the credentials you will also have to enter in your SBC.

Usernames have to have at least 3 chars. Only alphanumerical chars are allowed

Passwords have to have at least 16 chars and contains at least one special character. Only alphanumerical chars and a list of special characters (!?@#$%^&*()_+-=[]{}) are allowed

After you leave this page you will not be able to see the credentials you have configured. Make sure to store the credentials securely (e.g. in your Password Manager). If you forget the credentials you have to set new ones.

SBC Setup

Last updated