SIP-Gateways

SIP-Gateways definieren, an welchen SIP-Server sich SIP-Extensions registrieren.
Ohne mindestens ein konfiguriertes Gateway können keine SIP-Extensions angelegt werden.

Interner SIP-Server

Wird der interne SIP-Server von SAM verwendet, ist kein eigenes SIP-Gateway notwendig. In diesem Fall wird automatisch ein Standard-Gateway erstellt.

Es können beliebig viele SIP-Gateways angelegt werden.
Damit ein Gateway funktioniert, muss der entsprechende Ziel-Server aus dem Netzwerk des
SIP Attendant- & Mediaservers erreichbar sein.

Wird ein externer Server / Hostname verwendet, muss ein funktionierendes Gateway oder Nameserver (DNS) konfiguriert sein.
Wurde bei der Installation keiner gesetzt, muss dieser nachträglich über den Ubuntu Netplan ergänzt werden.

Übersicht in der Weboberfläche

Unter Infrastruktur → SIP → SIP Gateways wird eine Tabelle mit allen vorhandenen Gateways angezeigt.
Die Spalten enthalten:

Name – frei wählbare Bezeichnung des Gateways
Beschreibung – optionale Beschreibung / Zweck
Register IP / Host – Ziel-Server (IP-Adresse oder Hostname)
Reg-Port – SIP-Registrierungsport (Standard: 5060)
Aktionen – Bearbeiten- und Löschen-Symbole

Über den Button „Neues Gateway“ kann ein neues Gateway angelegt werden.

Neues SIP-Gateway anlegen

Auf „Neues Gateway“ klicken.
Alle Pflichtfelder ausfüllen.
Mit „Speichern“ bestätigen.

Basisdaten

Name
Eindeutige, sprechende Bezeichnung, z. B. PBX-Standort-Berlin.
Beschreibung (optional)
Zusätzliche Informationen zum Gateway, z. B. Standort, Anbieter oder Zweck.

Gateway SIP-Proxy / PBX

Register IP / Host
IP-Adresse oder Hostname des SIP-Proxys / der PBX, an den sich die SIP-Extensions registrieren sollen.
Register Port
SIP-Port des Ziel-Servers (Standard: 5060).
Wird hier ein alternativer Port verwendet, muss dieser auch in Firewall und Gegenstelle passend konfiguriert sein. Siehe: Port Tabelle

Erweiterte Einstellungen

Die erweiterten Einstellungen sind über den Abschnitt „Erweiterte Einstellungen” im Dialog erreichbar (aufklappbar per Klick). Sie enthalten gateway-spezifische SIP-Kompatibilitätsoptionen.

!!! note “Neustart von Teilnehmern”

Werden Erweiterte Einstellungen geändert, müssen alle **SIP-Teilnehmer, die dieses Gateway nutzen,
neu gestartet** werden, damit die Änderungen wirksam werden.

RTP erst nach ACK starten (RFC 3261 §13 konform)

Zustand	Verhalten
Aktiv (Standard)	RFC-konformer Modus — RTP-Medienstrom startet erst, nachdem der ACK des Anrufers empfangen wurde.
Deaktiviert	Interop-Modus — RTP startet sofort nach dem Versand der `200 OK`-Antwort.

Wann deaktivieren? Manche PBX-Systeme senden das ACK nicht korrekt an die Contact-URI des SAM-Servers (z. B. bei bestimmten NAT-Szenarien oder nicht-RFC-konformen SIP-Stacks). In diesem Fall würde im RFC-konformen Modus kein Medienstrom aufgebaut — der Anruf bleibt stumm.

Gateway unterstützt REFER w/ Replaces (RFC 3891)

Aktivieren, wenn die Gegenstelle REFER mit Replaces unterstützt. SAM nutzt diese Methode für attended Transfers (vermittelte Rufübergaben). Bei Bedarf erfolgt automatisch ein Fallback auf einfaches REFER (RFC 3515) — relevant für Auto Attendant, Warteschlangen und Callback-Funktionen.

Gateway unterstützt OPTIONS-Keepalive

Wenn aktiviert, sendet SAM regelmäßig SIP OPTIONS-Nachrichten, um die Erreichbarkeit des Gateways zu überwachen. Nur aktivieren, wenn der Partner-SIP-Server darauf mit 200 OK antwortet.

Gateway unterstützt Rufnummern Manipulation

Wenn aktiviert, verwendet SAM die A-Rufnummer des Anrufers (z. B. aus dem Auto Attendant) im Vermittlungsprozess zum C-Teilnehmer. Nur aktivieren wenn die Gegenstelle entsprechende Rufnummern-Manipulation unterstützt.

SAM

Lokale IP-Adresse
IP-Adresse des SIP Attendant- & Mediaservers, unter der SAM aus Sicht des Gateways/PBX erreichbar ist.
Dies ist insbesondere bei Systemen mit mehreren Interfaces oder NAT wichtig.

Pflichtfeld lokale IP

Ohne lokale IP-Adresse des SAM-Servers kann das Gateway nicht gespeichert werden.Stelle sicher, dass die eingetragene IP-Adresse mit der Netzwerkkonfiguration des Systems übereinstimmt. Andernfalls werden falsche SIP-Transactions an den PBX Partner gesendet.

Bestehendes SIP-Gateway bearbeiten

In der Gateway-Tabelle das Stift-Symbol (Bearbeiten) beim gewünschten Gateway anklicken.
Die gewünschten Werte anpassen.
Mit „Speichern“ bestätigen.
Falls Leistungsmerkmale geändert wurden, die zugehörigen SIP-Extensions neu starten.

SIP-Gateway löschen

In der Gateway-Tabelle das Papierkorb-Symbol (Löschen) beim gewünschten Gateway anklicken.
Den Löschvorgang bestätigen.

Nach dem Löschen können sich SIP-Extensions, die dieses Gateway genutzt haben, nicht mehr registrieren, bis ihnen ein anderes Gateway zugewiesen wird.