mirror of
https://github.com/asterisk/asterisk.git
synced 2025-10-02 02:18:31 +00:00
4cf8a968fd
This commit introduces the security events API. This API is to be used by Asterisk components to report events that have security implications. A simple example is when a connection is made but fails authentication. These events can be used by external tools manipulate firewall rules or something similar after detecting unusual activity based on security events. Inside of Asterisk, the events go through the ast_event API. This means that they have a binary encoding, and it is easy to write code to subscribe to these events and do something with them. One module is provided that is a subscriber to these events - res_security_log. This module turns security events into a parseable text format and sends them to the "security" logger level. Using logger.conf, these log entries may be sent to a file, or to syslog. One service, AMI, has been fully updated for reporting security events. AMI was chosen as it was a fairly straight forward service to convert. The next target will be chan_sip. That will be more complicated and will be done as its own project as the next phase of security events work. For more information on the security events framework, see the documentation generated from doc/tex/. "make asterisk.pdf" Review: https://reviewboard.asterisk.org/r/273/ git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@206021 65c4cc65-6c06-0410-ace0-fbb531ad65f3
168 lines
3.7 KiB
TeX
168 lines
3.7 KiB
TeX
% To generate a PDF from this, install the "rubber" tool, and the LaTeX
|
|
% dependencies for it. Then, run:
|
|
%
|
|
% rubber asterisk.tex
|
|
%
|
|
% http://www.pps.jussieu.fr/~beffara/soft/rubber/
|
|
|
|
\documentclass[12pt,a4]{report}
|
|
|
|
\usepackage{hyperref}
|
|
|
|
\usepackage{url}
|
|
\makeatletter
|
|
\def\url@aststyle{%
|
|
\@ifundefined{selectfont}{\def\UrlFont{\sf}}{\def\UrlFont{\small\ttfamily}}}
|
|
\makeatother
|
|
\urlstyle{ast}
|
|
|
|
\usepackage[titles]{tocloft}
|
|
\renewcommand{\cftchapfont}{%
|
|
\fontsize{11}{13}\usefont{OT1}{phv}{bc}{n}\selectfont
|
|
}
|
|
|
|
\newenvironment{astlisting}
|
|
{\begin{list}{}{\setlength{\leftmargin}{1em}}\item\scriptsize\bfseries}
|
|
{\end{list}}
|
|
|
|
\usepackage{sectsty}
|
|
\allsectionsfont{\usefont{OT1}{phv}{bc}{n}\selectfont}
|
|
|
|
\usepackage[Lenny]{fncychap}
|
|
|
|
|
|
\author{Asterisk Development Team \\ Asterisk.org}
|
|
\title{Asterisk Reference Information \\ ASTERISKVERSION}
|
|
|
|
\begin{document}
|
|
\maketitle
|
|
|
|
\tableofcontents
|
|
|
|
\chapter{Introduction}
|
|
|
|
This document contains various pieces of information that are useful for
|
|
reference purposes.
|
|
|
|
\section{License Information}
|
|
\input{../../LICENSE}
|
|
\subsection{Hold Music}
|
|
Digium has licensed the music included with
|
|
the Asterisk distribution From FreePlayMusic
|
|
for use and distribution with Asterisk. It
|
|
is licensed ONLY for use as hold music within
|
|
an Asterisk based PBX.
|
|
\section{Security}
|
|
\input{security.tex}
|
|
\section{Hardware}
|
|
\input{hardware.tex}
|
|
|
|
\chapter{Configuration}
|
|
\section{General Configuration Information}
|
|
\subsection{Configuration Parser}
|
|
\input{configuration.tex}
|
|
\subsection{Asterisk.conf}
|
|
\input{asterisk-conf.tex}
|
|
\subsection{CLI Prompt}
|
|
\input{cliprompt.tex}
|
|
\subsection{Extensions}
|
|
\input{extensions.tex}
|
|
\subsection{IP Quality of Service}
|
|
\input{qos.tex}
|
|
\subsection{MP3 Support}
|
|
\input{mp3.tex}
|
|
\subsection{ICES}
|
|
\input{ices.tex}
|
|
\section{Database Support}
|
|
\subsection{Realtime Database Configuration}
|
|
\input{realtime.tex}
|
|
\subsection{FreeTDS}
|
|
\input{freetds.tex}
|
|
\section{Privacy}
|
|
\input{privacy.tex}
|
|
|
|
\chapter{Channel Variables}
|
|
\input{channelvariables.tex}
|
|
|
|
\chapter{AEL: Asterisk Extension Language}
|
|
\input{ael.tex}
|
|
|
|
\chapter{SLA: Shared Line Appearances}
|
|
\input{sla.tex}
|
|
|
|
\chapter{Channel Drivers}
|
|
\section{IAX2}
|
|
\input{chaniax.tex}
|
|
\subsection{IAX2 Jitterbuffer}
|
|
\input{jitterbuffer.tex}
|
|
\section{mISDN}
|
|
\input{misdn.tex}
|
|
\section{Local}
|
|
\input{localchannel.tex}
|
|
\section{Mobile}
|
|
\input{chan_mobile.tex}
|
|
|
|
\chapter{Distributed Universal Number Discovery (DUNDi)}
|
|
\section{Introduction}
|
|
\input{dundi.tex}
|
|
\section{Peering Agreement}
|
|
\input{../PEERING}
|
|
|
|
\chapter{ENUM}
|
|
\input{enum.tex}
|
|
|
|
\chapter{AMI: Asterisk Manager Interface}
|
|
\input{manager.tex}
|
|
\input{ajam.tex}
|
|
|
|
\chapter{CDR: Call Detail Records}
|
|
\input{billing.tex}
|
|
\input{cdrdriver.tex}
|
|
|
|
\chapter{CEL: Channel Event Logging}
|
|
\input{cel-doc.tex}
|
|
\input{celdriver.tex}
|
|
|
|
\chapter{Voicemail}
|
|
\section{ODBC Storage}
|
|
\label{odbcstorage}
|
|
\input{odbcstorage.tex}
|
|
\section{IMAP Storage}
|
|
\input{imapstorage.tex}
|
|
|
|
\chapter{SMS}
|
|
\input{app-sms.tex}
|
|
|
|
\chapter{Queues}
|
|
\input{queues-with-callback-members.tex}
|
|
\section{Queue Logs}
|
|
\input{queuelog.tex}
|
|
|
|
\chapter{Phone Provisioning}
|
|
\input{phoneprov.tex}
|
|
|
|
\chapter{Calendaring}
|
|
\input{calendaring.tex}
|
|
|
|
\chapter{Security Framework}
|
|
\input{security-events.tex}
|
|
|
|
\chapter{Development}
|
|
\section{Backtrace}
|
|
\input{backtrace.tex}
|
|
|
|
|
|
|
|
% This is a list of files not yet integrated into this document:
|
|
%
|
|
%Misc
|
|
%----
|
|
%asterisk-mib.txt SNMP mib for Asterisk (net-snmp)
|
|
%digium-mib.txt SNMP mib for Asterisk (net-snmp)
|
|
%
|
|
% Note that there is some developer documentation in the doc directory, but
|
|
% the goal is to have developer documentation all integrated into the doxygen
|
|
% documentation.
|
|
|
|
\end{document}
|