The initial setup for ClearIP is a very straight forward process. The following steps must be completed before SIP INVITEs will be correctly processed by ClearIP. Go through each subsection for Organization, Number Translation, and Basic Integration Testing to get started with initial testing of ClearIP.
Once this basic testing is completed, you can setup ClearIP services such as toll fraud prevention, STIR/SHAKEN, least cost routing, and more by reviewing the main sections within the documentation.
1. Setup Organization menu
In the Organization menu, you can define an SBC. When ClearIP receives a SIP message, it must first identify the device that sent the message. This is done by matching the source IP address of the SIP message with the defined SBCs. If the SBC can’t be identified, a 403 Forbidden response will be returned.
You must also define a service provider, a group, and a user. Calls can be organized into a hierarchy structure with 3 levels: service provider, group, and user; with user being the lowest level. After identifying the SBC of a SIP message, the user must be identified. This is done by matching headers in the SIP message with the headers defined for each user.
2. Setup Number Translation Rules
In the Configuration menu, you can define calling and called number translation rules. To enable consistent processing, ClearIP requires all telephone numbers to be in E.164 format without the leading +.
3. Perform Basic Integration Testing
You should perform basic testing to ensure your SBC sends the correct number format and responds appropriately to the expected ClearIP responses.
ClearIP Call Processing Flow
The complete ClearIP call processing flow is listed below:
Step | Process | Potential Responses | Service Cost Incurred |
---|---|---|---|
1 | SBC lookup | 403, 603 | Reporting (base) |
2 | Number length check | 484 | |
3 | User lookup | 403, 603 | |
4 | Number translation | ||
5 | Data enrichment | ||
6 | Blacklists/whitelists | 302 (diversion), 603 | |
7 | Existing trigger | 302 (diversion), 603 | |
8 | Inbound Shield | 302 (diversion), 603 | Inbound Shield |
9 | Outbound Shield | 302 (diversion), 603 | Outbound Shield |
10 | Fraud control | 302 (diversion), 603 | Fraud control |
11 | SHAKEN authentication | 302 (diversion), 603 | STI authentication |
12 | SHAKEN verification | 302 (diversion), 603 | STI verification |
13 | Reputation lookup | 302 (diversion), 603 | Reputation lookup |
14 | CNAM lookup | CNAM lookup | |
15 | Static routing | 302 (routing) | Static routing |
16 | Least cost routing | 302 (routing) | Least cost routing |
17 | Allow call | 302, 404, 503 |
This shows the order of operations of ClearIP’s logic if every possible service was enabled for a single call. In practice, only a portion of the steps and not all steps would apply to any single call. ClearIP will apply each applicable step through the processing flow in order.
Service costs are applied only if ClearIP reaches the relevant step for a given call. If the analysis during a specific step causes ClearIP to return a SIP response, then ClearIP will immediately return the SIP response and exit the call processing flow.
For example, if ClearIP is used for toll fraud prevention and a call is blocked due to a blacklist entry in step 6, then the call will not be monitored by Outbound Shield in step 9 or ClearIP’s fraud triggers in step 10. The call would accrue the Reporting (base) cost but not the Outbound Shield or Fraud control cost.