<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2171/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+10+Application_DISA">Asterisk 10 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="Asterisk10Application_DISA-DISA%28%29"></a>DISA()</h1>
<h3><a name="Asterisk10Application_DISA-Synopsis"></a>Synopsis</h3>
<p>Direct Inward System Access.</p>
<h3><a name="Asterisk10Application_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="Asterisk10Application_DISA-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>DISA(passcode|filename[,context[,cid[,mailbox[@context][,options]]]])</pre>
</div></div>
<h5><a name="Asterisk10Application_DISA-Arguments"></a>Arguments</h5>
<ul>
<li><tt>passcode|filename</tt> - If you need to present a DISA dialtone without entering a password, simply set <em>passcode</em> to <tt>no-password</tt> You may specified a <em>filename</em> instead of a <em>passcode</em>, this filename must contain individual passcodes</li>
<li><tt>context</tt> - 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><tt>cid</tt> - Specifies a new (different) callerid to be used for this call.</li>
<li><tt>mailbox</tt> - Will cause a stutter-dialtone (indication <b>dialrecall</b> ) to be used, if the specified mailbox contains any new messages.
<ul>
<li><tt>mailbox</tt></li>
<li><tt>context</tt></li>
</ul>
</li>
<li><tt>options</tt>
<ul>
<li><tt>n</tt> - The DISA application will not answer initially.</li>
<li><tt>p</tt> - The extension entered will be considered complete when a <tt>#</tt> is entered.</li>
</ul>
</li>
</ul>
<h3><a name="Asterisk10Application_DISA-SeeAlso"></a>See Also</h3>
<p><a href="/wiki/display/AST/Asterisk+10+Application_Authenticate" title="Asterisk 10 Application_Authenticate">Asterisk 10 Application_Authenticate</a><br/>
<a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Application_VMAuthenticate&linkCreation=true&fromPageId=19005681" class="createlink">Asterisk 10 Application_VMAuthenticate</a></p>
<h3><a name="Asterisk10Application_DISA-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk version SVN-branch-10-r340810.</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+10+Application_DISA">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Application_DISA?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>