Name

DISA() — Direct Inward System Access: allows inbound callers to make outbound calls

Synopsis

DISA(password[,context[,callerid[,mailbox[@vmcontext]]]])
DISA(password-file[,callerid[,mailbox[@vmcontext]]])

Allows outside callers to obtain an “internal” system dial tone and to place calls from it as if they were placing calls from within the switch. The user is given a dial tone, after which she should enter her passcode, followed by #. If the passcode is correct, the user is then given a system dial tone on which a call may be placed.

Warning

Obviously, this type of access has serious security implications, and extreme care must be taken not to compromise the security of your phone system.

The password argument is a numeric passcode that the user must enter to be able to make outbound calls. Using this syntax, all callers to this extension will use the same password. To allow users to use DISA() without a password, use the string no-password instead of the password.

The context argument specifies the context in which the user will be dialing. If no context is specified, the DISA() application defaults the context to disa.

The callerid argument specifies a new Caller ID string that will be used on the outbound call.

The mailbox argument is the mailbox number (and optional voicemail context, vmcontext) of a voicemail box. The caller will hear a stuttered dial tone if there are any new messages in the specified voicemail box.

Additionally, you may use an alternate syntax and pass the name of a global password file instead of the password and context arguments. On each line, the file may contain either a passcode, or a passcode and context, separated by a pipe character (|). If a context is not specified, the application defaults to the context named disa.

If the user login is successful, the application parses the dialed number in the specified context:

; allow outside callers to call 1-800 numbers, as long
; as they know the passcode. Set their Caller IDs to make
; it appear that they are dialing from within the company
[incoming]
exten => 123,1,DISA(4569,disa,"Company ABC" <(234) 123-4567>)


[disa]
exten => _1800NXXXXXX,1,Dial(Zap/4/${EXTEN})

Get Asterisk: The Future of Telephony, 2nd Edition now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.