SIP Trunking for IP PBX Capable of Digest Authentication

Initial Configuration of PortaSwitch®

Create Customer Tariffs

Enter Rates

Create a Product

Create a Customer Class

Create a Customer

Create Accounts

Accounts for Outgoing Calls from IP PBX

Accounts for Incoming Calls to IP PBX

 

This chapter demonstrates how to set up SIP trunking for IP PBX capable of digest authentication so that:

·       A call to one of the DIDs that the customer has purchased is processed by PortaSwitch® and routed to the customer’s external IP PBX.

·       Outgoing calls from the customer’s IP PBX are processed and routed by PortaSwitch® to carriers.

 

Please refer to the Hosted IP PBX / IP Centrex Solution section in the PortaSIP Administrator Guide for information on how to activate and use the IP Centrex / hosted IP PBX features available in PortaSwitch®.

Checklist

Print the following page and use it to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes should be checked), otherwise the service will not work.

 

_Hint_ExclamationMark The checklist below assumes that you have already configured basic SIP and PSTN‑to‑SIP services according to the instructions provided in the previous chapters.

 

 

Operation

 

Done

Rating configuration (Vendor)

Confirm that the DID supplier vendor and its “Calls from Vendor via SIP” connection has been configured according to the instructions in the Incoming Calls from PSTN section

 

[     ]

Confirm that the internal vendor and its “Calls to Vendor via SIP” connection has been configured according to the instructions in the PortaSwitch Initial Configuration section. Check if the Internal connection use for field contains the “SIP-to-External SIP proxy (SIP-URI)” string for this vendor. Check if the tariff assigned has a zero cost rate for the wildcard destination (|).
If you need to configure the internal vendor rating perform the following steps:

Create a tariff (referred to as tariff A later on) that describes your termination costs for calls forwarded to SIP-URI (make sure it is NOT a Routing type!)

[     ]

 

 

 

 

 

Enter a zero cost rate for the wildcard destination (|) in tariff A

[     ]

Create an internal (virtual) vendor for keeping track of calls forwarded to SIP-URI

[     ]

Create a “Calls to Vendor via SIP” connection with the Internal connection use for field contains the “SIP-to-External SIP proxy (SIP-URI)” for this vendor using tariff A

[     ]

Rating configuration (Customer)

 

Create a tariff (referred to as tariff B later on) that will be used to calculate the charges for outgoing calls from customer’s IP PBX

[     ]

Enter rates in tariff B that cover the destinations where your customers can call

[     ]

Create a tariff (referred to as tariff C later on) that will be used to calculate the charges for incoming calls to DIDs

[     ]

Enter rates in tariff C that cover the DIDs you offer to your customers

[     ]

Create your SIP trunking product

[     ]

Create a rating entry for this product that associates the service Voice Calls and tariff B with the PortaSIP Node and OUTGOING Access Code

[     ]

Create a rating entry for this product that associates the service Voice Calls and tariff C with PortaSIP Node and INCOMING Access Code

[     ]

Account provisioning

 

Create a retail customer who will represent the IP PBX owner

[     ]

Create an account that will be used to authorize outgoing calls from IP PBX

[     ]

Create accounts for incoming DIDs (depending on IP PBX capabilities)

[     ]

Testing

 

Provision the IP PBX to place outgoing calls via PortaSwitch®

[     ]

Provision the IP PBX to receive incoming calls via PortaSwitch®

[     ]

Check the parameters (SIP proxy address and port and optionally, account ID and password) in the IP BPX and then make a test call

[     ]

Initial Configuration of PortaSwitch®

If you have just installed the PortaSwitch® software or dedicated a new billing environment to configure the services described in this handbook, make sure to first perform the initial configuration of PortaSwitch® and configure incoming calls from PSTN. To do this, use the PortaSwitch Initial Configuration and Incoming Calls from PSTN handbooks.

Create Customer Tariffs

You should create two separate tariffs for your IP PBX customer. These tariffs will be used for charging outgoing and incoming calls.

 

Follow these steps to create customer tariffs:

 

1.     On the navigation menu, select Service catalog and click Tariffs.

2.     On the Create tariff panel, fill in the tariff details:

·       Name – Type a short name for the tariff object; this is the name you will see in the select menus.

·       Currency – This indicates the currency in which you charge your customers.

NOTE: The currency for the tariff is chosen only once, and cannot be changed later.

·       Service – Select Voice Calls.

·       Applied to – Select Customer as this tariff will be used to charge your customers.

·       Managed by – Select Administrator only here, since we are setting up a service without the involvement of resellers.

 

3.     Click Save.

 

Title: Tariff - Description: Create customer tariff.

Enter Rates

You should specify the rates for the two separate tariffs created in the previous section:

·       Rates for the first tariff (referred to as tariff B in the checklist) should cover the destinations that your customers can call. They are used to calculate the charges for outgoing calls from the customer’s IP PBX.

·       Rates for the second tariff (referred to as tariff C in the checklist) should cover the DIDs that the customer has purchased.

 

If you charge the same rate for forwarded calls as you do for outgoing calls and do not charge for calls made on your own network (a very typical case), you may use tariff B for both outgoing and forwarded calls.

 

_Hint_Glasses Rates can be managed online and offline. Use the section below to add rates to all tariffs.

Managing Rates Online

1.     On the navigation menu, select Service catalog and click Tariffs.

2.     Use the Tariff search panel to locate the tariff you created. Specify one or more of the search criteria listed there and click Apply filters.

3.     On the Results panel, click your customer tariff name, which is also a link that redirects you to the edit tariff panel.

4.     On your customer tariff’s panel, click Rates.

5.     On the Add rate panel, fill in the rate details:

·       Destination – Select a destination prefix from the list or type it directly, e.g. 420 for Czech Republic.

NOTE: You must create an entry for certain phone prefixes in the Destination register before creating a rate for them in the tariff.

·       First interval, seconds – Type a first billing unit in seconds.

·       Next interval, seconds – Type the next billing unit in seconds.

·       First price – Type a per minute price for the first interval.

·       Next price – Type a per minute price for the next interval

·       Off-peak first interval – Type a first billing unit in seconds for off‑peak time.

·       Off-peak next interval – Next billing unit in seconds for off‑peak time.

·       Off-peak first price – Type a per minute price for first interval for off‑peak time.

·       Off-peak next price – Type a per minute price for next interval for off-peak time.

NOTE: Off-peak fields appear only if this tariff has already been assigned an off-peak period on the General info panel.

·       Rate formula – Type a custom rating formula.

·       Effective from – If you want this rate to take effect sometime in the future, you can either type in a date manually, or use the calendar (click on the DD-MM-YYYY link).

NOTE: When using the calendar, you can specify that the date you are entering is in a different time zone than your present one. PortaBilling® will then automatically adjust the time.

6.     Click Save.

7.     Repeat these steps to enter more rates.

 

Title: Tariff - Description: Add rates

Managing Rates Offline

You also can upload rates from a .CSV or .XLS file – please consult the Rate Import section for more details.

 

Repeat the Create Tariff and Enter Rates steps to create tariffs that can be used for charging customers for incoming calls.

Create a Product

Create a SIP trunking product.

 

1.     On the navigation menu, select Service catalog and click Products.

2.     On the Create product panel, fill in the product details:

·       Name – Type an internal product name that will be shown on the administrator interface.

·       Name visible to end users – Type a name of the product that will be shown to end users on their self-care interfaces.

·       Product type – Select Main product here.

·       Currency – Choose a currency the product will be priced in.

·       Managed by – Select Administrator only here, since we are setting up a service without the involvement of resellers.

·       Account default ACL – Choose an Access Control List (ACL) for accounts with this product assigned. ACLs control which objects end users can access to and which actions they can perform.

·       Account role – Select Phone line since this product is intended for making and receiving calls.

 

3.     Click Save.

 

Title: Product - Description: Create product.

 

Included Services

Define which service types are included in the product. A service type is a description of the physical service provided to end users.

 

To add a service type:

1.     On your product’s panel, click Services.

2.     On the Services panel, click Add a service.

3.     In the Select services to add dialog box, select Voice calls and click Add.

 

Please refer to the Basic Residential VoIP Service section for a detailed description of the product creation process.

Create Rating Entries for the SIP Trunking Product

1.     On your product’s panel, click Charges, then click Usage charges.

2.     On the Usage charges panel, click Add.

3.     Fill in the required information:

·       Service – Select Voice Calls.

·       Node – Select the PortaSIP® node.

·       Access code – Leave this field empty for the basic SIP service.

·       Tariff – Choose the tariff that will be used to calculate the charges for outgoing calls.

·       Overdraft protection – To configure overdraft protection for this product, consult the Configure Overdraft Protection Section within the Product section in the Overdraft Protection Configuration handbook.

 

4.      Click Save.

 

Title: Product - Description: Add rating entries.

 

5.     On the Usage charges panel, click Add to add the second rating entry.

6.     Fill in the required information:

·       Service – Select Voice Calls.

·       Node – Select the PortaSIP® node.

·       Access code – Type INCOMING in this field.

·       Tariff – Choose the tariff that will be used to calculate the charges for incoming calls.

·       Overdraft protection – To configure overdraft protection for this product, consult the Configure Overdraft Protection Section within the Product section in the Overdraft Protection Configuration handbook.

 

7.     Click Save.

 

Title: Product - Description: Add rating entries.

Create a Customer Class

Customer class provides the ability to define a business model and a group of parameters in a centralized way, and then apply those parameters to many customers at once.

 

1.     On the navigation menu, select Sales, then select Customer classes.

2.     On the Create a customer class panel, fill in the customer class details:

·       Name – Type a short name for this customer class.

·       Currency – Specify the currency in which you want to set the Collection threshold. When specified, this customer class can only be assigned to customers with the same currency. Once the currency selection is saved, it cannot be changed.

·       Business model – Select which customers this customer class will apply. Select SIP trunking from the list.

·       Description – Type your comments about the intended use of this customer class.

 

3.     Click Save.

 

Refer to the Create a Customer Class section of the Basic Residential VoIP Service handbook and complete the customer class creation.

 

Create a Customer

1.     On the navigation menu, select Sales, then select Customers.

2.     On the Create customer panel, fill in the customer details:

·       Name – Type a short name for the customer object; this will be used on the web interface.

·       Business model ­– A business model defines what type of service is to be provided to the customer. Select SIP trunking for this customer.

·       Customer class – Customer class allows you to define a policy for automated payment collection. By choosing a specific class here the customer will automatically inherit all of the class properties (grace period, invoice template, etc.). Select the previously created customer class.

·       Billing period – Choose a billing period for the customer. A billing period defines the frequency of invoicing for this customer.

·       Billing period time zone – Choose a time zone in which customer’s billing period will be closed and invoices will be generated.

·       The last day of the billing period – This is a read-only field available only during customer creation. It shows the last date of the customer’s first billing period. Note that this date is shown in customer’s time zone.

·       Balance control - Specify the way the customer will pay for the service: Postpaid – after consuming the services; Prepaid – prior to consuming the services. Select Postpaid in this field.

·       Currency – Choose the currency in which this customer will be billed.

·       Credit limit – Assign a credit limit for the customer.

 

3.     Click Save.

Title: Customer - Description: Create customer

Personal info

Define the customer's personal information (such as name, email address, and etc.).

1.     On your customer’s panel, click Personal, then click General info.

2.     On the Personal info panel, fill in the customer’s personal information and an email address for the receipt of accounting information. After the billing period is over, a list of xDRs and other statistics will be sent to this address.

Web self-care

Define credentials and preferred settings (such as language, time zone, date input and output formats) for this customer's self-care interface.

1.     On your customer’s panel, click Personal, click General info, then click Web self-care.

2.     On the Web self-care panel, define credentials for the customer self-care interface (such as login, password, time zone, etc.) and other preferred settings.

Balance and credits

1.     On your customer’s panel, click Finances, click General info, then click Balance and credits.

2.     On the Balance and credits panel, define the Credit limit warning threshold parameter. The customer can be notified by email when his balance is dangerously close to the credit limit and service will soon be blocked. The threshold can be specified:

·       As a percentage (e.g. 90%). The warning will be sent when the customer’s balance exceeds that percentage of his credit limit. So, if the credit limit is USD 1000.00 and the threshold is 90%, a warning will be sent as soon as the balance exceeds USD 900.00. This is only applicable when the customer has a positive credit limit.

·       As an absolute value. The warning will be sent as soon as the balance goes above the specified value.

Invoices and taxation

Define whether to send this customer their statistics and invoices by email.

1.     On your customer’s panel, click Finances, and then click Invoices and taxation.

2.     On the Invoices and taxation panel, set the Send Statistics via email option to Summary only. This delivers a call summary only and do not attach a details file; this could be useful in the case of a large number of calls. Other options are Full Statistics (attach a complete list of xDRs) or Do not send (this option prevents the delivery of event statistics to this customer via email).

Services

1.     On your customer’s panel, click Services.

 

The Services panel provides an access to a group of panels where you can activate / deactivate various features of the voice calls service provided to the customer.

 

This is a convenient way for managing parameters which are the same for a whole set of accounts. Instead of trying to configure them for each individual account, you can define them once at the customer level, then specify in the account configuration that the value in the customer’s configuration be used. Should you wish to change this value later, you need only modify it once for the change to be automatically propagated to all accounts.

 

Please consult the PortaBilling Help for a description of parameters available here. For now you may leave these with their default values. If you change them later, these changes will automatically affect all accounts created under this customer.

 

2.     Click Save.

Create Accounts

Account creation is described in the Create Accounts section of the Basic Residential VoIP Service handbook. Account configuration particularities that depend on the IP PBX features and preferences are described below.

Accounts for Outgoing Calls from IP PBX

If the IP PBX system is capable of digest authentication, you should create an account with the following options:

1.     On your customer’s panel, click Accounts.

2.     On the Create an account panel, fill in the account information:

·       ID – SIP ID, i.e. the DID number to be used to log in to the SIP server and make outgoing calls.

·       Account role – Select Phone line.

·       Product – Choose the main product, which you would like your account to have (make sure it has the Phone line account role defined within).

·       Activation date – Choose the date from which the account is usable. By default the account is activated immediately upon creation.

·       Service password – Specify a service password for this account.

·       Type – Select Credit in this field.

·       Balance control – Define the way the balance of the account is controlled. Subordinate – the balance will directly depend on the customer’s balance (only the customer tops up the balance); Individual credit limit – this account may have its own balance and credit limit (the customer credit limit still applies.) Select Subordinate in this field.

3.     Click Save.

 

Add an account for outgoing calls from IP PBX

Account info

1.     On your account’s panel, click Personal info, then click General info.

2.     On the Personal info panel, click Additional info, then click Account info.

3.     On the Account info panel, enter the account owner’s email address in the Email field. If he ever forgets his password for the web self-care pages, he will be able to reset it, and a new password will be sent to this email address.

Web self-care

1.     On your account’s panel, click Personal info, click General info, then click Web self-care.

2.     On the Web self-care panel, define credentials for the account self-care interface (such as login, password, time zone, etc.).

Additional info

1.     On your account’s panel, click Personal info, and click General info.

2.     On the Personal info panel, click Additional info, then click Auto-provisioning.

3.     On the Auto-provisioning panel, leave the Auto-provisioning option disabled.

Life cycle

1.     On your account’s panel, click Personal info, click General info, then click Life cycle.

2.     On the Life cycle panel, fill in the account information:

·       Use an expiration date – This identifies the date when the account expires. Since we are setting up a postpaid service, which should function for a long time, leave this option disabled.

·       Availability period after first usage, days – This defines the number of days the account remains active after its first use or recharge. Since we are setting up a postpaid service, which should function for a long time, leave this field blank.

·       Availability period after last usage, days – This defines the number of days the account remains active after its last use or recharge. Since we are setting up a postpaid service, which should function for a long time, leave this field blank.

Service Configuration tab

Using this tab, you can activate / deactivate various features of the services provided to this account. Note that features are defined per service type (the physical service provided to the user such as Conferencing, Data Service, Voice Calls, Messaging etc.)

 

Please consult the PortaBilling Help for a description of parameters available here. For now you may leave these with their default values.

 

After clicking Save, you will see a confirmation screen announcing that a new account has been created.

 

Note that you can limit the number of simultaneous calls for a specified customer (for more details, see the …limit the number of concurrent calls for a specific customer? chapter in the How To… section).

Accounts for Incoming Calls to IP PBX

The configuration of incoming calls depends on whether IP PBX is capable of being registered on a SIP server.

 

If the IP PBX system is capable of registering on a SIP server, you should create an account with the following options:

·       ID – SIP ID, i.e. the DID number to be used to log in to the SIP server and make outgoing calls.

·       Account role – Select Phone line.

·       Product – Choose the main product, which you would like your account to have (make sure it has the Phone line account role defined within).

·       Activation date – Choose the date from which the account is usable. By default the account is activated immediately upon creation.

·       Service password – Specify a service password for this account.

·       Type – Select Credit in this field.

·       Balance control – Define the way the balance of the account is controlled. Subordinate – the balance will directly depend on the customer’s balance (only the customer tops up the balance); Individual credit limit – this account may have its own balance and credit limit (the customer credit limit still applies.) Select Subordinate in this field.

4.     Click Save.

NOTE: You may want to use the account that you already created for outgoing calls.

If you want to dedicate several DIDs to forwarding incoming calls to the IP PBX there are three comparable ways of doing this. They are described below.

Creating extra DIDs as accounts

You can create extra accounts (e.g. 12035556218, 18001111112 and 44201224505) with forwarding services on these accounts configured so that they always go to the main IP PBX account.

 

1.     On your customer’s panel, click Accounts.

2.     On the Create an account panel, fill in the account information:

·       ID – SIP ID, i.e. the DID number to be used to log in to the SIP server and make outgoing calls.

·       Account role – Select Phone line.

·       Product – Choose the main product, which you would like your account to have (make sure it has the Phone line account role defined within).

·       Activation date – Choose the date from which the account is usable. By default the account is activated immediately upon creation.

·       Service password – Specify a service password for this account.

·       Type – Select Credit in this field.

·       Balance control – Define the way the balance of the account is controlled. Subordinate – the balance will directly depend on the customer’s balance (only the customer tops up the balance); Individual credit limit – this account may have its own balance and credit limit (the customer credit limit still applies.) Select Subordinate in this field.

3.     On the Service configuration panel, select Voice calls and click on the Incoming calls link to enable forwarding:

·       Default answering mode – Specify Forward Only.

·       Call forwarding – Enable the option and choose Simple Forwarding.

o   Maximum Forwards – Specify the number of concurrently active forwarding destinations allowed.

o   Forward by DTMF – Leave the option disabled.

 

Create extra DIDs as accounts

 

4.     Click Save.

5.     The additional Forward tab now appears on the page. Go to this tab:

·       Specify the ID of the main IP PBX account in the Forward to field.

·       Activate the Keep Original CLD option to store the called DID. The IP PBX can then correctly route the calls made to individual phone numbers to their appropriate extensions. (Please consult theForwarding with the original DNIS (CLD) section in the PortaSIP Administrator guide for a detailed description.)

 

 Configure simple forwarding

 

6.     Click save_close Save & Close.

7.     Repeat these steps if you need to create more accounts for forwarding calls to the main IP PBX account.

Creating a separate account for every IP PBX extension

_Hint_Glasses If the IP PBX supports multiple SIP registrations, you can create separate accounts in PortaBilling® for every IP PBX extension.

Create extra DIDs as aliases

Please see the …create extra DIDs as aliases? chapter in the How to… section.

IP PBX with Dynamic IP Address

Routing incoming calls via the registration account is used for IP PBXs that can perform registration on the SIP server using their main account (i.e. the registration account), yet use dynamic IP addresses for registration.

 

To set this up, perform the following steps:

1.     Create a customer who represents the owner of the IP PBX.

2.     Create a main account for this customer as described in the Create Accounts section of the IP Centrex Services handbook (the Account ID is the phone number that will be used for registering on the SIP server).

3.     On your customer’s panel, select Services, select Voice calls, then select Incoming calls.

4.     On the Incoming calls configuration panel, enable the Sip contact option.

5.     Select Account in the Deliver incoming calls to list.

6.     Select the account you created at step 2 in the Account ID list.

7.     Click Save.

Configure registration account.

How to override incoming calls delivery settings for an account (optional)

Let’s consider the example of when it is necessary to use one of the PBX phone lines on a separate SIP phone. To do this, perform the actions as described below:

 

1.     Use the Customer search panel to locate the required account. Specify one or more of the search criteria listed there and click Apply filters.

2.     On the Results panel, click the account name, which is also a link that redirects you to the edit account panel.

3.     On your account’s panel, select Services, select Voice calls, then select Incoming calls.

4.     On the Incoming calls configuration panel, disable the SIP contact service feature.

5.     Click Save.

 

Disabel Sip static contact.

 

For more information about incoming call delivery to an IP PBX with dynamic IP address please refer to the PortaSIP Administrator Guide.