System Dienst SIP UA Responder
Beschreibung Systemdienst
Der Systemdienst SIP UA Responder (SIP User Agent Configuration Responder) ist eine Komponente des LocaPhone-Systems, die Provisionierungs-Informationen für unterstützte Endgeräte bereitstellt.
Bei Umgebungen, in denen die Endgeräte nicht per DHCP unmittelbar die entsprechenden Provisionierungs-URL erhalten können, stellt der SIP UA Responder mittels IP Multicast diese Informationen bereit.
Benutzung Systemdienst
Der Systemdienst kann als Daemon dauerhaft oder händisch im CLI bis zum Beenden des Dienstes gestartet werden.
root@voip:~$
root@voip:~# /opt/locaphone/sbin/gs-sip-ua-config-responder/gs-sip-ua-config-responder
Use --daemonize or --nofork
Parameter
Parameter | Beschreibung |
---|---|
-- nofork | SIP UA Responder aktiv in Shell |
-- daemonize | SIP UA Responder aktiv als daemon |
Ausgabe CLI
Ausgabe beim Start des Dienstes auf der Kommandozeile.
root@voip:~$
root@voip:~# /opt/locaphone/sbin/gs-sip-ua-config-responder/gs-sip-ua-config-responder --nofork
Not forking.
Reading configuration ...
Using provisioning URL base: http://192.168.1.130/locaphone/prov/
Listening on 224.0.1.75:5060 ...
Interface: any
Interface:
OUT-------------------------------------------------------{
NOTIFY 224.0.1.75:5060 SIP/2.0
----------------------------------------------------------}
Interface: any
Interface: 224.0.1.75
IN -------------------------------------------------------{
SUBSCRIBE sip:MAC%3a00041326007D@locaphone.tk SIP/2.0
Via: SIP/2.0/UDP 192.168.1.52:1026;rport
From: <sip:MAC%3a00041326007D@locaphone.tk>;tag=2113587399
To: <sip:MAC%3a00041326007D@locaphone.tk>
Call-ID: 1767881193@192.168.1.52
CSeq: 1 SUBSCRIBE
Event: ua-profile;profile-type="device";vendor="snom";model="snom370";version="8.7.5.44"
Expires: 0
Accept: application/url
Contact: <sip:192.168.1.52:1026>
User-Agent: snom370/8.7.5.44
Content-Length: 0
----------------------------------------------------------}
OUT (-> 192.168.1.52:1026) -------------------------------{
SIP/2.0 200 OK
Via: SIP/2.0/UDP 192.168.1.52:1026;rport
From: <sip:MAC%3a00041326007D@locaphone.tk>;tag=2113587399
To: <sip:MAC%3a00041326007D@locaphone.tk>
Call-ID: 1767881193@192.168.1.52
CSeq: 1 SUBSCRIBE
Expires: 0
Contact: <sip:224.0.1.75:5060>
User-Agent: gs-sip-ua-config-responder
Content-Length: 0
----------------------------------------------------------}
OUT-------------------------------------------------------{
NOTIFY 192.168.1.52:1026 SIP/2.0
Via: SIP/2.0/UDP 224.0.1.75:5060;rport
Max-Forwards: 25
Contact: <sip:224.0.1.75:5060>
To: <sip:MAC%3a00041326007D@locaphone.tk>;tag=2113587399
From: <sip:MAC%3a00041326007D@locaphone.tk>;tag=619613e7-21465e08
Call-ID: 1767881193@192.168.1.52
CSeq: 3 NOTIFY
User-Agent: gs-sip-ua-config-responder
Content-Type: application/url
Event: ua-profile
Subscription-State: terminated;reason=timeout
Content-Length: 69
http://192.168.1.130/locaphone/prov/snom/settings.php?mac={mac}&pnp=1
----------------------------------------------------------}
Responded to 192.168.1.52 (Snom, ua-profile;profile-type="device";vendor="snom";model="snom370";version="8.7.5.44")
Voraussetzungen
Der Systemdienst SIP UA Responder wird bei der Installation als Teil des regulären Funktionsumfanges mit installiert.
Endgeräte der Hersteller Snom und Gigaset müssen per DHCP/statisch konfiguriert im Subnetz des TK-Systems eine IP-Adresse zugewiesen bekommen und erreichbar sein.
Installation
Systembezogenes Leistungsmerkmal. Teil des regulären Funktionsumfanges von LocaPhone. Teil der LocaNet Standard-Installationsvariante.
Konfiguration
Die Funktionen des SIP UA Responders werden über die zentrale Konfigurationsdatei des TK-Systems konfiguriert.
/etc/locaphone/locaphone.php
/***********************************************************
* PROVISIONING
***********************************************************/
$PROV_HOST = '192.168.1.130';
//$PROV_PORT = 0; # 0 for default port for $PROV_SCHEME
//$PROV_SCHEME = 'http'; # without "://"
$PROV_PATH = '/locaphone/prov/';
# with starting and trailing "/"
# URL is build like this:
# <PROV_SCHEME>://<PROV_HOST>:<PROV_PORT><PROV_PATH>snom/dial-log.php
sip-ua-config-responder | ||||
---|---|---|---|---|
Parameter | Beschreibung | Wert | Default | Version |
PROV_HOST | IP-Adresse des Provisionierungs-Hosts | numerisch | 192.168.1.130 | 2.0.0.0 |
PROV_PORT | TCP-Port des Provisionierungs-Dienstes | numerisch | 0 | 2.0.0.0 |
PROV_SCHEME | Angabe, ob der Datenverkehr des Provisionierungsservers verschlüselt werden soll (https) | Text | http | 2.0.0.0 |
PROV_PATH | Provisionierungspfad. Beginnt und endet mit “/„ | Text | /locaphone/prov/ | 2.0.0.0 |
Formate
- Snom PnP Config - https://service.snom.com/display/wiki/pnp_config
- Gigaset Provisioning - https://teamwork.gigaset.com/gigawiki/display/GPPPO/URL+to+provisioning+server
- Gigaset SIP Multicast - https://teamwork.gigaset.com/gigawiki/display/GPPPO/SIP+multicast+message
IPv4 Multicast Address Space Registry - https://www.iana.org/assignments/multicast-addresses/multicast-addresses.xhtml
- SIP Session Initiation Protocol - https://en.wikipedia.org/wiki/Session_Initiation_Protocol#
Abhängigkeiten
Keine.
Zusätzliche Informationen
Nach Start des Systemdienstes ist der SIP-Dienst des Vermittlungskerns neu zu laden, nachdem alle Endgeräte die entsprechende Provisionierungs-URL erhalten haben.
root@voip:~$
root@voip:~# asterisk -r
Asterisk 18.6.0~uloca-xenial4, Copyright (C) 1999 - 2021, Sangoma Technologies Corporation and others.
=========================================================================
Connected to Asterisk 18.6.0~uloca-xenial4 currently running on voip (pid = 1474)
voip*CLI> sip reload