With this application you can allow calls from outside your PBX to be interpreted as if they are inside the PBX.

The principle is the following: somebody from outside the PBX system place a call to one of our numbers. The caller will hear a continuous signal. He/she has to enter a password followed by the pound key. If the password is correct then the caller will hear again a signal which this time is coming from inside the PBX system.

To use this application you need a working Asterisk PBX with registered users in iax.conf, sip.conf or mgcp.conf(It depends on which protocol you would like to use) and made extensions.

To see how the application works we recommend to use our IAX softphone Idefisk. You can download it from here. Please also read our tutorial to learn how to configure it to work with Asterisk PBX.

NOTE: Before to start with this application we want to warn you that the usage of the DISA application hide a serious danger for the security of your system because it allows an access to you system through outside line!!!

NOTE: This is only an example of what for you can use this application. Of course it might be used for something different.

We need three registered users in iax.conf file. This is because we are going to use the IAX2 protocol. If you want to use other protocol such as SIP or MGCP, you have to do the configurations below respectively in sip.conf or mgcp.conf.

So, we have registered the users user1, user2, anatoliy.

Type=friend means that this user can make and receive calls. Host=dynamic means that the IP is not static but dynamic through a DHCP server. Allow=all means that the line which this user will use, could support all audio codecs. Context=test - this shows that this user is working with the extensions in this context of the configuration file extensions.conf.

On the picture above there is a screenshot of our extensions.conf file.

We will assign the number 222 for incoming calls from outside. And we will make an extension for this number which to contain the DISA application. So, when somebody from outside the PBX switch dials the number 222, he/she will hear a continuous signal. During this signal the caller has to enter the password and then to press the pound key(#). The password in our case is 1111. If the password is correct then the caller will hear again a signal which this time is an internal. It comes from inside the PBX system.

In our example we have set as second argument - test1. This means that when a caller from outside enter the correct password, he/she will be allowed to make calls only within this context of the extensions.conf file. So, the caller in our example could dial numbers 109 and 110 because they are in the context [test1] and could not dial numbers from other contexts.

If we enter the word no-password instead of the numeric password(in our case instead of 1111), then the caller from outside could enter in our system without entering a password. This could be a serious problem for the security of your system and we recommend you to avoid this option. Always set a password for access to your system.

If we enter a password, but we do not set a context, by default the context will be [disa].

Finally, there is one option which brings you more flexibility while using the DISA application. This is the option where you set as argument a file with passwords instead of one single password.

In the password file you can add different passwords and you can assign to each one a different context in which the user to make internal calls. On the picture below you can see how to do the configurations in extensions.conf. And also an example for a password file.

So the caller who enters 1234 as password would have a permission to make calls only in the [test1] context. The caller with password 12345 would have a permission to make calls in the [test2] context and the caller with password 2121 would have a permission to make calls in the [test3] context.