DISA()

Since 0.1.9 Applications

Direct Inward System Access.

Last reviewed 2026-04-14

DISA(passcode|filename[,context,cid,mailbox,options])

Dialplan Builder -- build your DISA() command

passcode|filename

If you need to present a DISA dialtone without entering a password, simply set *passcode* to `no-password`

context (optional)

Specifies the dialplan context in which the user-entered extension will be matched. If no context is specified, the DISA application defaults to the `disa` context. Presumably a normal system will have a special context set up for DISA use with some or a lot of restrictions.

cid (optional)

Specifies a new (different) callerid to be used for this call.

mailbox@ (optional)

options

n: The DISA application will not answer initially.

The DISA application will not answer initially.

p: The extension entered will be considered complete when a '#' is entered.

The extension entered will be considered complete when a `#` is entered.

Full arguments reference

passcode|filename required - If you need to present a DISA dialtone without entering a password, simply set passcode to no-password
context - Specifies the dialplan context in which the user-entered extension will be matched. If no context is specified, the DISA application defaults to the disa context. Presumably a normal system will have a special context set up for DISA use with some or a lot of restrictions.
cid - Specifies a new (different) callerid to be used for this call.
mailbox - Will cause a stutter-dialtone (indication dialrecall) to be used, if the specified mailbox contains any new messages.
- mailbox required
- context
options
- n - The DISA application will not answer initially.
- p - The extension entered will be considered complete when a # is entered.

Description

The DISA, Direct Inward System Access, application allows someone from outside the telephone switch (PBX) to obtain an internal system dialtone and to place calls from it as if they were placing a call from within the switch. DISA plays a dialtone. The user enters their numeric passcode, followed by the pound sign #. If the passcode is correct, the user is then given system dialtone within context on which a call may be placed. If the user enters an invalid extension and extension i exists in the specified context, it will be used.

Be aware that using this may compromise the security of your PBX.

The arguments to this application (in extensions.conf) allow either specification of a single global passcode (that everyone uses), or individual passcodes contained in a file (filename).

The file that contains the passcodes (if used) allows a complete specification of all of the same arguments available on the command line, with the sole exception of the options. The file may contain blank lines, or comments starting with # or ;.

Arguments

passcode|filename required - If you need to present a DISA dialtone without entering a password, simply set passcode to no-password
context - Specifies the dialplan context in which the user-entered extension will be matched. If no context is specified, the DISA application defaults to the disa context. Presumably a normal system will have a special context set up for DISA use with some or a lot of restrictions.
cid - Specifies a new (different) callerid to be used for this call.
mailbox - Will cause a stutter-dialtone (indication dialrecall) to be used, if the specified mailbox contains any new messages.
- mailbox required
- context
options
- n - The DISA application will not answer initially.
- p - The extension entered will be considered complete when a # is entered.

User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.