<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2172/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_DISA">Asterisk 11 Application_DISA</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="Asterisk11Application_DISA-DISA%28%29"></a>DISA()</h1>
<h3><a name="Asterisk11Application_DISA-Synopsis"></a>Synopsis</h3>
<p>Direct Inward System Access.</p>
<h3><a name="Asterisk11Application_DISA-Description"></a>Description</h3>
<p>The DISA, Direct Inward System Access, application allows someone from outside the telephone switch (PBX) to obtain an <b>internal</b> 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 <tt>#</tt>. If the passcode is correct, the user is then given system dialtone within <em>context</em> on which a call may be placed. If the user enters an invalid extension and extension <tt>i</tt> exists in the specified <em>context</em>, it will be used.</p>
<p>Be aware that using this may compromise the security of your PBX.</p>
<p>The arguments to this application (in <tt>extensions.conf</tt>) allow either specification of a single global <em>passcode</em> (that everyone uses), or individual passcodes contained in a file (<em>filename</em>).</p>
<p>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 <tt>#</tt> or <tt>;</tt>.</p>
<h3><a name="Asterisk11Application_DISA-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>DISA(passcode|filename,context,cidmailbox[@context],options)</pre>
</div></div>
<h5><a name="Asterisk11Application_DISA-Arguments"></a>Arguments</h5>
<ul>
<li>passcode|filename - If you need to present a DISA dialtone without entering a password, simply set <em>passcode</em> to {{no-password}}You may specified a <em>filename</em> instead of a <em>passcode</em>, this filename must contain individual passcodes</li>
<li>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 <tt>disa</tt> context. Presumably a normal system will have a special context set up for DISA use with some or a lot of restrictions.</li>
<li>cid - Specifies a new (different) callerid to be used for this call.</li>
<li>mailbox - Will cause a stutter-dialtone (indication <b>dialrecall</b>) to be used, if the specified mailbox contains any new messages.
<ul>
<li>mailbox</li>
<li>context</li>
</ul>
</li>
<li>options
<ul>
<li>n - The DISA application will not answer initially.</li>
<li>p - The extension entered will be considered complete when a <tt>#</tt> is entered.</li>
</ul>
</li>
</ul>
<h3><a name="Asterisk11Application_DISA-SeeAlso"></a>See Also</h3>
<ul>
<li><a href="/wiki/display/AST/Asterisk+11+Application_Authenticate" title="Asterisk 11 Application_Authenticate">Asterisk 11 Application_Authenticate</a></li>
<li><a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+11+Application_VMAuthenticate&linkCreation=true&fromPageId=20186997" class="createlink">Asterisk 11 Application_VMAuthenticate</a></li>
</ul>
<h3><a name="Asterisk11Application_DISA-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk Version SVN-trunk-r370322</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_DISA">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+Application_DISA?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>