In dieser Dokumentation wird beschrieben welche Konfigurationsmöglichkeiten beim anlegen eines neuen SIP-Providers zur Verfügung stehen.
Leitungskonfiguration
Es stehen die folgenden Konfigurationsfelder zur Verfügung:
| type | |
|---|---|
| Beschreibung | Verbindungsart zum Provider |
| Syntax | Drop-Down-Menü |
| Anmerkung | |
| Auswahlmöglichkeiten | |
| friend | Es können ein- und ausgehende Rufe aufgebaut werden. |
| peer | Es können nur ausgehende Rufe aufgebaut werden. |
| user | Es können nur eingehende Rufe empfangen werden. |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| dtmfmode | |
|---|---|
| Beschreibung | Standard des Tonwahlverfahrens |
| Syntax | Drop-Down-Menü |
| Anmerkung | |
| Auswahlmöglichkeiten | |
| rfc2833 | DTMF-Töne nach RFC 2833 senden |
| infoband | DTMF-Töne als SIP-INFO-Nachrichten senden |
| info | DTMF-Töne „inband“ als Audio sende |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| auth mode | |
|---|---|
| Beschreibung | Art der Authentifizierung beim Provider |
| Syntax | Drop-Down-Menü |
| Anmerkung | |
| Auswahlmöglichkeiten | |
| Username/passwort | Authentifizierung über Benutzernamen und Passwort |
| IP adress | Authentifizierung über IP-Adresse |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| auth user | |
|---|---|
| Beschreibung | Art der Authentifizierung beim Provider |
| Syntax | Drop-Down-Menü |
| Anmerkung | Das Feld "Authuser" in der Leitungskonfiguration wird erst nach dem speichern eingeblendet. |
| Auswahlmöglichkeiten | |
| ohne | Es wird kein Authentifizierungsbenutzer übertragen |
| SIP-Benutzername | Es wird der Eintrag im Feld "Benutzername" der Leitungskonfiguration übertragen |
| Authuser | Es wird der Eintrag im Feld "Authuser" der Leitungskonfiguration übertragen |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| nat | |
|---|---|
| Beschreibung | Angabe des verwendeten NATs |
| Syntax | Freifeld |
| Anmerkung | Es wird empfohlen dieses Feld nicht zu konfigurieren und die Netzwerkeinstellungen der STARFACE zu nutzen. |
| Auswahlmöglichkeiten | |
| <leer> | Kein NAT in Verwendung |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| allow | |
|---|---|
| Beschreibung | Angabe der erlaubten Codec |
| Syntax | Freifeld / Alle Angaben in Kleinbuchstaben und kommagetrennt |
| Anmerkung | Die Reihenfolge der Angaben gibt die gewünschte Priorität vor. |
| Beispiele | |
| <leer> | Erlaubt alle Codec |
| all | Erlaubt alle Codec |
| alaw,ulaw | Erlaubt die Codec "alaw" und "ulaw" in dieser Reihenfolge |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| insecure | |
|---|---|
| Beschreibung | Sicherheitseinstellungen bezüglich ein- und ausgehender Rufe |
| Syntax | Freifeld / Alle Angaben in Kleinbuchstaben und Kommagetrennt |
| Anmerkung | Aktuell wird nur die Option "port,invite" unterstützt und muss eingetragen werden! |
| Auswahlmöglichkeiten | |
| port | Ignoriert den Port von dem der Request kommt |
| invite | Keine Authentifizierung bei einkommenden Invites |
| port,invite | Kombination aus den beiden obrigen Auswahlmöglichkeiten |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| port | |
|---|---|
| Beschreibung | Hier kann einer alternativer SIP-Port konfiguriert werden |
| Syntax | Freifeld |
| Anmerkung | Der Standard-SIP-Port der STARFACE ist 5060 |
| Beispiele | |
| <leer> | Nutzung des Standardports 5060 |
| 5061 | Pflichteintrag wenn TLS-Transport aktiviert ist |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| transport | |
|---|---|
| Beschreibung | Auswahl des Netzwerkprotokolls |
| Syntax | Drop-Down-Menü |
| Anmerkung | Wird die Option "tls" ausgewählt muss zwingend der Port 5061 bei "port" eingetragen werden. |
| Beispiele | |
| udp | Unverschlüsselte Übertragung via UDP |
| tls | Verschlüsselte Übertragung via TLS |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| defaultip | |
|---|---|
| Beschreibung | Standard-IP-Adresse bei der Nutzung eines dynamischen Hosts |
| Syntax | Freifeld |
| Anmerkung | Dieses Feld wird aktuell nicht beachtet! |
| Beispiele | |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| rtpholdtimeout | |
|---|---|
| Beschreibung | Angabe der Zeitdauer bis eine gehaltene Verbindung ohne RTP-Datenverkehr automatisch geschlossen wird |
| Syntax | Freifeld / Angabe in Sekunden |
| Anmerkung | Diese Angabe muss größer sein als der Eintrag bei "rtptimeout" |
| Beispiele | |
| <leer> | Der Standardwert sind 300 Sekunden |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| fromdomain | |
|---|---|
| Beschreibung | Setzt eine Domain die von der STARFACE ausgehend signalisiert wird |
| Syntax | Freifeld |
| Anmerkung | |
| Beispiele | |
| <leer> | Es wird keine Domain bei ausgehenden Rufen gesetzt. |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| host | |
|---|---|
| Beschreibung | Die IP-Adresse oder der DNS-Name des Providerservers |
| Syntax | Freifeld |
| Anmerkung | |
| Beispiele | |
| sip123.provider.com | Beispiel für einen DNS-Eintrag |
| 60.70.80.90 | Beipiel für die Eintragung einer IP-Adresse |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| permit | |
|---|---|
| Beschreibung | Angabe der IP-Adresse(n) mit der sich der Provider bei der STARFACE melden darf |
| Syntax | Freifeld / Mehrere Einträge kommagetrennt ohne Leerzeichen |
| Anmerkung | |
| Beispiele | |
| <leer> | keine Einschränkungen |
| Angabe als IP-Adresse | 60.70.80.90 |
| Angabe als IP/Netzwerkmaske | 192.168.15.10/255.255.255.0 |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| deny | |
|---|---|
| Beschreibung | Angabe von IP-Adressen mit der sich der Provider bei der STARFACE nicht melden darf |
| Syntax | Freifeld / Mehrere Einträge kommagetrennt ohne Leerzeichen |
| Anmerkung | |
| Beispiele | |
| <leer> | keine Einschränkungen |
| Angabe als IP-Adresse | 60.70.80.90 |
| Angabe als IP/Netzwerkmaske | 192.168.15.10/255.255.255.0 |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| canreinvite | |
|---|---|
| Beschreibung | Angabe von IP-Adressen mit der sich der Provider bei der STARFACE nicht melden darf |
| Syntax | Drop-Down-Menü |
| Anmerkung | Aktuell wird nur die Option "no" unterstützt. |
| Auswahlmöglichkeiten | |
| <leer> | Es wird kein neues einladen zugelassen. |
| yes | Ein erneutes einladen wird zugelassen. |
| no | Es wird kein neues einladen zugelassen. |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| disallow | |
|---|---|
| Beschreibung | Angabe der nicht erlaubten Codec |
| Syntax | Freifeld / Alle Angaben in Kleinbuchstaben und kommagetrennt |
| Anmerkung | Es wird empfohlen alle Codec zu sperren und im Feld "allow" die erwünschten Codec zu hinterlegen. |
| Beispiele | |
| <leer> | Erlaubt alle Codec |
| all | Sperrt alle Codec |
| g722,g729 | Sperrt die Codec "alaw" und "ulaw" |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| outboundproxy | |
|---|---|
| Beschreibung | Angabe des verwendeten Outbound-Proxy |
| Syntax | Freifeld / Angabe der IP-Adresse |
| Anmerkung | |
| Beispiele | |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| progressinband | |
|---|---|
| Beschreibung | Konfiguration der Klingelsignalisierung |
| Syntax | Freifeld |
| Anmerkung | |
| Auswahllmöglichkeiten | |
| never | Der Provider muss das Klingeln erzeugen |
| no oder <leer> | Wenn nicht der Provider das Klingeln signalisiert, wird dies von der STARFACE gemacht |
| yes | Die STARFACE signalisiert immer das Klingeln |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| qualify | |
|---|---|
| Beschreibung | Prüfung ob der Provider noch erreichbar ist (Keep-Alive-Anfragen) |
| Syntax | Drop-Down-Menü |
| Anmerkung | |
| Auswahllmöglichkeiten | |
| yes | Es werden alle 2000ms Keep-Alive-Anfragen zum Provider geschickt. |
| no | Es werden keine Keep-Alive-Anfragen zum Provider geschickt. |
| Zahlenwert XXX | Es werden alle XXX ms Keep-Alive-Anfragen zum Provider geschickt. |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| encryption | |
|---|---|
| Beschreibung | Konfiguration ob SRTP verwendet wird oder nicht |
| Syntax | Drop-Down-Menü |
| Anmerkung | |
| Auswahllmöglichkeiten | |
| yes | Es wird SRTP verwendet |
| no | Es wird kein SRTP verwendet |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| rtptimeout | |
|---|---|
| Beschreibung | Angabe der Zeitdauer bis eine aktive Verbindung ohne RTP-Datenverkehr automatisch geschlossen wird |
| Syntax | Freifeld / Angabe in Sekunden |
| Anmerkung | Diese Angabe muss niedriger sein als der Eintrag bei "rtpholdtimeout" |
| Beispiele | |
| <leer> | Der Standardwert sind 60 Sekunden |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| mask | |
|---|---|
| Beschreibung | Angabe einer Netzwerkmaske für die Felder "deny" und "permit" |
| Syntax | Freifeld |
| Anmerkung | Dieses Feld wird aktuell in der Konfiguration nicht beachtet! |
| Beispiele | |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| fromuser | |
|---|---|
| Beschreibung | Setzt einen Benutzer der von der STARFACE ausgehend signalisiert wird |
| Syntax | Freifeld |
| Anmerkung | |
| Auswahlmöglichkeiten | |
| <leer> | Als Benutzer wird die Rufnummer signalisiert |
| ??????? | Es wird der Benutzername aus debn Leitungseinstellungen signalisiert |
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Rufnummernanzeige
In dem Die Anzeige der Rufnummer wird für das SIP Protokoll in verschiedenen RFCs behandelt. Neben diesen RFCs gibt es noch weitere Einstellmöglichkeiten in der STARFACE, diese wurden teilweise speziell für Provider eingefügt, welche sich nicht in diesen Standards bewegen.
| Name | Rufnummer anzeigen | Rufnummer unterdrücken | Besonderheiten |
|---|---|---|---|
| custom | From: Name <Nummer> | From: ANONYMOUS <username> | |
| dusnet | From: Name <Nummer> | From: ANONYMOUS <0> | |
| hfotelecom | P-Preferred-Identity: Name <sip:Nummer@starface.de> | From: Name <Nummer> P-Preferred-Identity: anonymous <sip:PAINummer@starface.de> | |
| isdn | From: Nummer | From: anonymous <0> | |
| m-net | From: Nummer <Nummer> | From: anonymous <Nummer> Privacy: id | Nummer ist im e.164-Format |
| qscconnect | Gleiche wie sipconnect, nur bei Rufweiterleitungen: | Nummer ist im e.164-Format | |
| remoteparty | Remote-Party-ID: Name <sip:Nummer@starface.de> | ||
| rfc3261 | From: Name <Nummer> | From: ANONYMOUS <0> | |
| rfc3323 | XXX | XXX | Diese Rufnummernanzeige weißt in der Version 6.2 einige Bugs auf und sollte nicht verwendet werden. |
| rfc3325 | From: Name <Nummer> | From: ANONYMOUS <0> | |
| sipconnect | From: Nummer <Nummer> | From: <sip:anonymous@anonymous.invalid> | Nummer ist im e.164-Format |
| sipgate | From: Nummer <Username> | From: ANONYMOUS <0> | Die Rufnummer wird normiert und ein führendes „+“ entfernt. |
| tcom | From: Nummer <Nummer> P-Asserted-Identity: <sip:nummer@domain> | From: Nummer | Nummer ist im e.164-Format |
| tonline | From: Nummer <Nummer> | From: anonymous <0> | |
| toplinkresale | P-Preferred-Identity: Name <sip:Nummer@starface.de> | Privacy: Id P-Asserted-Identity: <sip:Netzwerknummer@starface.de> |
Definiert wie die Rufnummer zusammen gebaut wird. Wenn in der Leitung no screening aktiviert wurde, wird diese Einstellung ignoriert.
- +11 (222) XXX ⇒ +49 721 15104 123
- 11 (222) XXX ⇒ 49 721 15104 123
- 0011 (222) XXX ⇒ 0049 721 15104 123
- 0 222 XXX ⇒ 0 721 15104 123
- 222 XXX ⇒ 721 15104 123
- Ohne Vorwahl ⇒ 15104 123
- No Screening ⇒ Diesen Wert nicht verwenden, er wird automatisch von der Leitung verwendet, wenn no screening bei den Leitungseinstellungen aktiviert wird.
Erweiterte Einstellungen
XXX