<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>manager.conf</title><link rel="stylesheet" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /><link rel="start" href="index.html" title="Asterisk™: The Future of Telephony" /><link rel="up" href="asterisk-APP-D.html" title="Appendix D. Configuration Files" /><link rel="prev" href="asterisk-APP-D-SECT-24.html" title="logger.conf" /><link rel="next" href="asterisk-APP-D-SECT-26.html" title="meetme.conf" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">manager.conf</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="asterisk-APP-D-SECT-24.html">Prev</a> </td><th width="60%" align="center">Appendix D. Configuration Files</th><td width="20%" align="right"> <a accesskey="n" href="asterisk-APP-D-SECT-26.html">Next</a></td></tr></table><hr /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="asterisk-APP-D-SECT-25"></a>manager.conf</h2></div></div></div><p><a id="I_indexterm_tt2649" class="indexterm"></a>The Asterisk Manager Interface is an API that external
programs can use to communicate with and control Asterisk, much as you
would do from the Asterisk console.</p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a id="asterisk-APP-D-NOTE-74"></a>Warning</h3><p>The Manager gives programs the ability to run commands and request
information from the Asterisk server. However, it is not very secure;
its authentication mechanism defaults to using plain-text passwords, and
all connected terminals default to receiving all events. The Asterisk
Manager should be used only on a trusted local area network, or locally
on the box. The <code class="literal">permit</code> and <code class="literal">deny</code> constructs allow you to restrict access
to certain extensions or subnets.</p></div><p>Many of the available graphical interfaces to Asterisk—such as the
Flash Operator Panel—use the Manager to pull data and determine the status
of applications. The <span class="emphasis"><em>manager.conf</em></span> file defines the
way programs authenticate with the Manager.</p><p>The Manager commands (which you can list by typing <code class="literal">show
manager commands</code> at the Asterisk console) have varying degrees
of privilege. You can control the read and write permissions for these
commands with the use of the <code class="literal">read</code> and
<code class="literal">write</code> options in the
<span class="emphasis"><em>manager.conf</em></span> file.</p><p>Here’s a sample <span class="emphasis"><em>manager.conf</em></span> file:</p><a id="I_programlisting_tt2650"></a><pre class="programlisting">[general]
enabled = no
port = 5038
bindaddr = 0.0.0.0
[oreilly]
secret = notvery
deny=0.0.0.0/0.0.0.0
permit= 192.168.1.0/255.255.255.0
read = system,call,log,verbose,command,agent,user,config
write = system,call,log,verbose,command,agent,user,config</pre><p>For more information on the Asterisk Manager Interface, see <a href="asterisk-CHP-10.html" title="Chapter 10. Asterisk Manager Interface (AMI) and Adhearsion">Chapter 10, <i>Asterisk Manager Interface (AMI) and Adhearsion</i></a>.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="asterisk-APP-D-SECT-24.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="asterisk-APP-D.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="asterisk-APP-D-SECT-26.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">logger.conf </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> meetme.conf</td></tr></table></div><div xmlns="" id="svn-footer"><hr /><p>You are reading <em>Asterisk: The Future of Telephony</em> (2nd Edition for Asterisk 1.4), by Jim van Meggelen, Jared Smith, and Leif Madsen.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-Noncommercial-No Derivative Works License v3.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://oreilly.com/catalog/9780596510480/">http://www.oreilly.com/</a>.</p></div></body></html>
