VOS3000 how-to

VOS3000 blacklists and whitelists

Block numbers you never want to carry, and let VOS3000 block abusive numbers by itself.

Updated · By the VOS3000 Web team

Quick answer: VOS3000 blocks unwanted numbers with black/white list groups, set as Allow (white list) or Forbidden (black list) on gateways and phones, a system white list, a dynamic black list that adds abusive numbers automatically, and terminal blacklist policies. They are in the desktop client under Number management.

Where
Desktop client, Number management
Groups
Allow (white list) or Forbidden (black list)
Automatic
Dynamic black list, limits in system parameters
CDR reasons
TerminalBlackList (-92), ExternalBlackList (-93)

These tools are in the VOS3000 desktop client under Number management, and on each gateway and phone. Calls they stop end with reasons such as TerminalBlackList (-92) or ExternalBlackList (-93); see termination reasons.

Black/white list groups

Open Number management → Black/white list group, add a group, then open it and add the phone numbers, each with an optional memo. A group is just a list of numbers: whether it blocks or allows is decided where you use it.

Use a group on a gateway or phone

Mapping gateways, routing gateways and phones have the columns Caller black/white list group and Callee black/white list group. Choose one or more groups and pick:

  • Allow: only numbers in the groups are allowed (a white list).
  • Forbidden: numbers in the groups are blocked (a black list).

System white list

Number management → System white list holds phone numbers, each with a memo, that are on the white list for the whole system.

Dynamic black list

VOS3000 can add numbers to the Dynamic black list by itself, for four reasons: a callee called too many times, a callee with too many unanswered calls, a caller with too many concurrent calls, and a caller who dials too many times. Each entry shows the type, effective date, expiry time and last call time.

The limits, monitoring periods and how long numbers stay listed are system parameters (System management → System parameter), such as the malicious-call monitor cycle, maximum call times and expiry duration. The list can run globally or per softswitch; on a gateway, Enable dynamic blacklist in standalone mode switches it on in standalone mode. VOS3000 Web shows this check box on the gateway's Others tab.

Terminal blacklist policies

For finer rules, Number management → Terminal blacklist policy lets you build a strategy from conditions: a monitoring cycle in seconds, a number of times, a condition (Connect or Answer), an answer time threshold and an expiry in seconds. Matching numbers go into a Terminal black list group. Choose policies on a gateway or phone with Caller blacklist policy and Callee blacklist policy. Listed numbers appear in Terminal blacklist with the device they were caught on and when they expire.

Other protections against fraud

  • Call Permission on gateways and phones (Net, Local, Domestic or International) limits what they may call.
  • Prefix lists and rewrite rules can refuse whole destinations; see rewrite rules and dial plans.
  • Balance and overdraft limits stop a customer from running up debt; see customers and payments.
  • The SIP firewall lets in only the addresses you trust.

Questions about this topic

How do I block a number in VOS3000?

Add it to a black/white list group, then set that group as Forbidden in the Caller or Callee black/white list group of the gateway or phone.

Can VOS3000 block abusive numbers automatically?

Yes. The dynamic black list adds numbers that call too often, ring unanswered too often, or use too many concurrent calls, using limits set in the system parameters.

What does TerminalBlackList (-92) mean?

The call was refused because the number is on the terminal blacklist.

Run VOS3000 without the server work

Pick a VOS3000 server hosted by us, or have us install VOS3000 on your own server. VOS3000 Web and the Android app come with it.