Das Asterisk Buch

context = Contextname

Bestimmt den Context im Dialplan für eingehende Anrufe.

context=default

allowguest = [yes|no]

Anrufe von Gästen erlauben. Default: yes

allowguest=no

allowtransfer = [yes|no]

Transfer von Verbindungen erlauben. Default: yes

allowtransfer=yes

realm = Hostname

Der Systemname des Asterisk-Servers zur Authentifizierung. Default: asterisk oder ein ggf. in asterisk.conf eingestellter Systemname. Verwenden Sie hier den Host- oder Domain-Namen Ihres Servers.

realm=ast1.beispiel.de

bindport = Portnummer

Der UDP-Port, auf dem SIP-Verbindungen entgegengenommen werden sollen. Default: 5060.

bindport=5060

bindaddr = IP-Adresse

Die IP-Adresse, auf der SIP-Verbindungen entgegengenommen werden sollen. Default: 0.0.0.0 für alle Adressen des Rechners.

bindaddr=0.0.0.0

Für SIP können 3 TOS^[39]-Parameter angegeben werden, um SIP-Paketen im Netzwerk eine andere Priorität als z. B. Datenübertragungen zu geben. Eine genauere Beschreibung finden Sie unter „tos“. In der Regel sollte man diese Werte angeben (per Default sind sie nicht gesetzt):

tos_sip=cs3      ; für SIP-Pakete (Kommunikationsaufbau)
tos_audio=ef     ; für RTP-Audio-Pakete
tos_video=af41   ; für RTP-Video-Pakete

Mit allow und disallow können bestimmte Sprachcodecs erlaubt oder nicht erlaubt werden. Außer den bekannten Codecs gibt es all für alle. Dabei ist die Reihenfolge wichtig.

; Beispiel: Alle Codecs außer ilbc erlauben:
allow=all
disallow=ilbc

; Beispiel: nur die Codecs gsm und ulaw erlauben:
disallow=all
allow=gsm
allow=ulaw

language = Sprachkürzel

Stellt die Default-Sprache ein.

language=de

dtmfmode = Modus

Verfahren, wie DTMF-Töne gesendet werden. Mögliche Werte:

dtmfmode=rfc2833

videosupport = [yes|no]

Schaltet die generelle Unterstützung von Video-Übertragungen ein (nicht getestet). Video-Unterstützung kann in den einzelnen Kanälen ausgeschaltet werden, kann aber dort ohne diese globale Einstellung nicht aktiviert werden.

videosupport=yes

maxcallbitrate = Übertragungsrate

Bestimmt die maximale Übertragungsrate für Video-Telefonate in Kilobit pro Sekunde. Default: 384 (für 384 Kbit/s).

maxcallbitrate=384

g726nonstandard = [yes|no]

Mit dieser Option stellen Sie ein, dass, wenn ein Peer G726-32 Audio aushandelt, AAL2 packing statt RFC3551 packing verwendet wird (siehe doc/rtp-packetization.txt, ab Asterisk 1.4). Dies sollte nur eingestellt werden, wenn Sie Probleme mit z. B. Grandstream- oder Sipura-Telefonen haben, die fälschlicherweise G726-32 aushandeln, obwohl sie AAL2-G726-32 meinen.

g726nonstandard=no

rtpkeepalive = Intervall

Sendet im in Sekunden angegebenen Intervall Keep-Alive-Pakete im RTP-Stream, um NAT^[40]-Routen offen zu halten.

rtpkeepalive=5   ; alle 5 Sekunden Keep-Alive-Pakete senden

t38pt_udptl = [yes|no]

Erlaubt das Durchschleifen von T.38-Fax-Übertragungen von SIP- zu SIP-Kanälen. Default: no. Kann pro Kanal deaktiviert, aber nicht ohne diese Einstellung aktiviert werden.

t38pt_udptl=yes

register => user[:passwort[:authuser]]@host[:port][/extension]

Damit kann sich Asterisk als SIP-User bei einem anderen SIP-Proxy (z. B. einem externen Provider) registrieren.

Der Host ist entweder ein normaler Hostname, der per DNS aufgelöst werden kann, oder der Name eines Abschnitts, der weiter unten definiert ist.

Die Extension muss in der extensions.conf definiert sein, damit Anrufe von diesem Proxy empfangen werden können. Ohne Angabe der Extension gilt s.

; eingehende Anrufe von sip-provider.de an die Extension 999 leiten:
register => 123456:passwort@sip-provider.de/999

; eingehende Anrufe von sip-provider an die Extension 999 leiten:
register => 123456:passwort@sip-provider/999
[sip-provider]
...

externip = IP-Adresse

Diese Einstellungen kann wichtig sein, wenn sich Asterisk hinter einem NAT-Router befindet. Die angegebene IP-Adresse wird in ausgehenden SIP-Nachrichten verwendet, damit die Empfänger unsere korrekte öffentliche Adresse wissen (statt unserer Adresse aus dem privaten Netz).

externip=123.45.67.89

externhost = Hostname

Wie „externip“, nur dass stattdessen der eigene öffentliche Hostname angegeben wird (der natürlich per DNS auflösbar sein muss).

externhost=hanspeter.dyndns.net

localnet = Adressraum

Gibt die lokalen, privaten Netzwerke an. Meist kann man Folgendes verwenden (nach RFC 1918 und Zeroconf):

localnet=192.168.0.0/255.255.0.0
localnet=10.0.0.0/255.0.0.0
localnet=172.16.0.0/12
localnet=169.254.0.0/255.255.0.0

canreinvite = [yes|nonat|update|update,nonat]

Normalerweise versucht Asterisk den optimalsten „audio path“ zu wählen, d. h., bei 2 hergestellten Channels die beiden Gesprächsteilnehmer direkt zu verbinden ohne Asterisk als Mittelsmann. Das funktioniert aber nicht, wenn sich ein User in einem NAT befindet.

canreinvite=nonat

jbenable = [yes|no]

Schaltet den „Jitter-Buffer“ für eingehendes Audio ein, wenn das nötig ist. Dadurch können unterschiedliche Latenzen von IP-Paketen ausgeglichen werden (siehe Jitter). Default: no

jbenable=yes

jbforce = [yes|no]

Schaltet den Jitter-Buffer immer ein. (Natürlich muss auch jbenable aktiviert sein.) Default: no

jbforce=no

jbmaxsize = Länge

Maximale Größe des Jitter-Buffers in Millisekunden. Default: 200.

jbmaxsize=200

jbresyncthreshold = Länge

Resynchronisationsrahmen des Jitter-Buffers. Default: 1000.

jbresyncthreshold=500

jbimpl = [fixed|adaptive]

Bestimmt, welcher Jitter-Buffer-Algorithmus verwendet wird. Bisher sind zwei Algorithmen implementiert:

jbimpl=adaptive

type = [user|peer|friend]

Die Art des Geräts

type=peer

context = Contextname

Der Context im Dialplan für eingehende Anrufe.

context=from-birnenbrei

secret = Passwort

Unser Passwort, mit dem wir uns authentifizieren, bzw. das Passwort des anderen Geräts, um sich bei uns zu authentifizieren.

secret=geheim

username = Benutzername

Unser Benutzername/Account auf dem anderen Rechner.

username=apfelmus

fromuser = Benutzername

Wird von einigen SIP-Providern benötigt.

fromuser=apfelmus

host = [Hostname|dynamic]

Hostname (oder Adresse) des anderen Rechners. dynamic wird angegeben, wenn der Hostname des Geräts nicht bekannt ist, da er dynamisch vergeben wird (oft zusammen mit defaultip gebraucht).

host=siphost.provider.de

defaultip = IP-Adresse

Unter der angegebenen Adresse wird versucht, einen Host (host=dynamic) zu erreichen, der sich noch nicht bei uns registriert hat.

defaultip=192.168.0.33

port = Portnummer

Port auf dem anderen Rechner, mit dem wir uns verbinden.

port=5060

call-limit = Anzahl

Limitiert die Anzahl der gleichzeitigen Telefonate mit diesem Gerät. (Nicht für Realtime-Peers!) Bei type=friend wäre call-limit=1 ein Anruf für den peer und einer für den user.

call-limit=1

callerid = Vorname Nachname <Nummer>

Überschreibt die Caller-ID, die vom Gerät gesendet wird (und damit oft nicht vertrauenswürdig ist).

callerid=Hans Meier <1234>

nat = [yes|no]

Gibt Asterisk einen Hinweis, ob sich zwischen Server und dem Gerät ein NAT-Router befindet.

host=192.168.0.42
nat=no

mailbox = Nummer[@Context][,Nummer[@Context][,...]]

Ordnet dem User eine Mailbox im angegebenen Voicemail-Context (oder default) zu. Dadurch werden die entsprechenden MWI^[41]-Nachrichten an das Gerät geschickt – z. B. für ein Blinklicht bei neuen Nachrichten. Es können auch mehrere Mailboxen angegeben werden.

mailbox=1234@default

subscribemwi = [yes|no]

Schickt MWI-Nachrichten (siehe „mailbox“) nur dann, wenn das Gerät danach fragt.

subscribemwi=yes

vmexten = Extension

Übergibt die Dialplan-Extension, unter der die Mailbox zu erreichen ist. Default: asterisk (so auch in einigen Endgeräten, z. B. snom, voreingestellt).

vmexten=asterisk

Mit allow und disallow können bestimmte Sprachcodecs erlaubt oder nicht erlaubt werden (siehe „Sprach-Codecs (allow, disallow)“).

regexten = Extension

Erzeugt dynamisch eine Extension, wenn sich das Gerät anmeldet.

regexten=1234

qualify = [yes|no|Wartezeit]

Schickt dem anderen Gerät regelmäßig Pings; wenn das Gerät innerhalb der angegebenen Wartezeit (oder der Default-Zeit bei yes) nicht mit einem Pong antwortet, gilt es als nicht erreichbar.

qualify=5000

callgroup = Gruppen

Setzt für das Gerät die angegebene Call-Group. Es können auch mehrere Gruppen durch Komma getrennt oder eine Reihe von Gruppen mit - (Bindestrich) angegeben werden. Gruppennummern gehen von 0 bis 63.

callgroup=2,4-7   ; setzt die Gruppen 2,4,5,6,7

pickupgroup = Gruppen

Bestimmt die Pickup-Groups für das Gerät, gibt also an, für welche der durch callgroup angegebenen Gruppen Pickup (das Heranholen von Gesprächen) erlaubt ist.

pickupgroup=2,4-6   ; Pickup für die Gruppen 2,4,5,6 erlauben

Mit permit und deny können IP-Adressräume, aus denen sich das Gerät bei uns registrieren kann, erlaubt oder verboten werden (nicht zu verwechseln mit allow / disallow!). Dabei ist die Reihenfolge wichtig.

; Verbinden nur von 192.168.0.* erlauben geht so:
deny=0.0.0.0/0.0.0.0                ; alle verbieten
permit=192.168.0.0/255.255.255.0   ; 192.168.0.* erlauben

setvar = Variablenname=Wert

Setzt eine Channel-Variable für alle Anrufe von diesem Gerät.

setvar=KUNDENNR=1234

rfc2833compensate = [yes|no]

(Ab Asterisk 1.4) Ermöglicht Rückwärtskompatibilität zum Erkennen von DTMF-Tönen, die von einem verbundenen Asterisk-Gerät vor Version 1.4 gesendet werden.

rfc2833compensate=yes