FreePBX is one of the largest PBX suppliers on the planet, and we’re happy to tell you that PBX Shield uses it as one of it’s test systems, making us fully compatible with FreePBX and most other blends of the Asterisk PBX platform.
This quick setup guide deals with using PJSIP to connect to PBX Shield. If you have a very old version of FreePBX please check out our standard SIP tutorial for instructions on how to connect to PBX Shield.
Setting up PBX Shield on FreePBX is a quick and easy process.
Lets get started!
Before we begin, we have made a few assumptions:
- Your FreePBX is working with a VoIP or PSTN provider already.
- You have an extension or extensions connected already.
First of all, login to your FreePBX system. We’re starting from the dashboard, so it should look a little something like this:
In the top menu, hover over the connectivity menu item and then click on trunks in the drop-down menu that appears. (connectivity->trunks)
Once you are in the trunk screen, click on the Add Trunk button, and choose Add SIP (chan_pjsip) Trunk from the dropdown menu.
You should now be looking at the Add Trunk menu. Make sure the General tab is selected.
In this menu, make the following changes:
- Trunk Name: PBX Shield
- Outbound CallerID: “PBX_ID” <Your Outbound CID>
Replace PBX_ID with the PBX ID number that you copied from the configuration settings of your PBX Profile.
Replace Your Outbound CID with the outbound caller ID that you use for your calls, or simply leave blank (remove the whole <Your Outbound CID> section, including the brackets).
Once you have done this, underneath the words Add Trunk you will see a series of tabs. Click on the one named PJSip Settings.
Fill in the details in this menu as below:
- SIP Server: protect.pbxshield.com
- SIP Server Port: 5060
Everything else should be left to defaults. Including a blank username and secret.
Now you have setup your trunk, what we need to do is make sure that PBX Shield is the first trunk called, this allows us to check your security settings for each call made and choose to either allow the call or disallow it.
To do this we need to go back to the top menu and hover over the connectivity menu again. Then choose Outbound Routes from the drop down menu.
Once you have chosen outbound routes you will end up at the outbound routes menu.
Choose your outbound route from the menu and click the edit icon.
You will now be in the edit outbound routes menu under the Route Settings tab. This is where we control the path the call takes when you dial a number. In most cases you simply need to leave everything alone, except for the Trunk Sequence For Matched Routes and congestion settings. This is where we will put in our PBX Shield trunk.
Inside this menu make sure the settings are as follows:
- Trunk Sequence for Matched Routes: The first one MUST be PBXShield, then the second one should be your VOIP or PSTN providers trunk.
- Optional Destination on Congestion: Normal Congestion
Once you have done this, save your settings. Then finally click on the Apply Config big red button at the top right of the FreePBX settings page.
Congratulations! PBX Shield should now be connected to your FreePBX system.
Don’t take our word for it though. We have a few test numbers that should show up in your dashboard if your connected just fine.