UCware

UCware
Beschreibung:	UCware als Telefonanlage im Stratum 0
Kontakt:	53c70r, feix, i4n
Status:	aktiv (Was heißt das?)

Die UCware dient als zentrale Telefonanlage für den Space. Sie verbindet die Räume in Space 2, Space 3, sowie Räume davor und dazwischen und ermöglicht interne sowie externe Telefonie.

Wichtig!
Der Umgang mit der Telefonanlage tangiert Entitäten über Spaces und Standorte hinweg. Space-Entitäten: Berücksichtigt dies und verhaltet euch Exzellent gegenüber anderen Entitäten. Wer den Space zur ruhigen Einzelarbeit nutzt, wünscht ggf. keine ungefragte Beschallung. Beachtet dies bei Cybereien entsprechend.

Aktuelle Eckdaten

UCware Server

• Hostsystem: trokn
• Hostname: ucware.s0 / ucware.stratum0.net
• IP-Adresse: 192.168.178.35 (statischer Lease auf dem DHCP-Server, siehe Autoprovisionierung)
• MAC-Adresse: 52:54:00:1E:42:A1
• Zertifikat: gültiges TLS-Zertifikat für ucware.stratum0.net; die Telefone nutzen es direkt (Provisionierung und SIP über TLS)

Telefonverzeichnis

Alle Durchwahlen können von außen über +49 531 180 5978 6-Durchwahl erreicht werden.

Ferner siehe bitte Externe Einwahl.

Rufgruppen

Bezeichnung	Durchwahl	Beschreibung
Space Gesamt	100	Klingelt in beiden Spaces
Space 2 Gesamt	200	Klingelt in Space 2
Space 3 Gesamt	300	Klingelt in Space 3

Nebenstellen

Die Benennung folgt einheitlich dem Schema s2-<raum> (Space 2) bzw. s3-<raum> (Space 3), alles klein geschrieben und ohne Umlaute. Das Präfix ist Teil der Anzeigenamen (Benutzer, Telefon, Caller-ID) und des Hostnamens, damit Space 2 und Space 3 klar unterscheidbar sind. Die Login-Namen der Benutzer (z.B. kueche, werkstatt) sind davon unberührt, weil daran die SIP- und WebRTC-Konten hängen.

Anzeigename (Benutzer)	Rufnummer (Intern)	Hardware-Modell	MAC-Adresse	IP-Adresse	Hostname
s2-tuer	8837 / 201	Snom D765	00:04:13:94:9D:49 / D0:37:45:95:01:C4 (WIFI)	192.168.178.46	phone-s2-tuer.s0
s2-flur	210	Snom D870	00:04:13:54:0A:E3	192.168.178.240	phone-s2-flur.s0
s2-kueche	202	Snom D710	00:04:13:74:06:DB	192.168.178.36	phone-s2-kueche.s0
s2-chillraum	203	Snom D710	00:04:13:74:22:A3	192.168.178.41	phone-s2-chillraum.s0
s2-frickelraum	204	Snom D710	00:04:13:74:22:B2	192.168.178.37	phone-s2-frickelraum.s0
s2-werkstatt	205	Snom D710	00:04:13:74:10:58	192.168.178.42	phone-s2-werkstatt.s0
s2-subraum	206	Snom D765	00:04:13:94:12:2A	192.168.178.169	phone-s2-subraum.s0
s2-holodeck	207	Snom D710	00:04:13:74:22:1A	192.168.178.38	phone-s2-holodeck.s0
s2-bad	209	TBD	TBD	TBD	phone-s2-bad.s0
resinlab	250	Snom D765	00:04:13:94:12:E0	192.168.178.49	phone-resinlab.s0
s3-seminar	301	Snom D710	00:04:13:74:22:7C	192.168.178.39	phone-s3-seminar.s0
s3-bastelraum	302	Snom D720	00:04:13:70:59:DC	192.168.178.218	phone-s3-bastelraum.s0
s3-werkstatt	303	Snom D710	00:04:13:74:22:A1	192.168.178.40	phone-s3-werkstatt.s0

Weitere Geräte mit statischem Lease:

Gerät	Name in UCware	MAC-Adresse	IP-Adresse	Hostname
DECT-Basis (Gigaset N720 DM)	base-dect	7C:2F:80:B7:BA:20	192.168.178.117	base-dect.s0

Die Printversion des Telefonbuches wird unter https://gitli.stratum0.org/stratum0/stratum0-telephone-directory/-/blob/main/data.toml?ref_type=heads maintained.

Namenskonvention

Wichtig!
Die Namenskonvention ist verbindlich und gilt ausnahmslos für jedes neue Telefon, jeden neuen Benutzer und jede Basis. Sie wird von Anfang an eingehalten, damit nie wieder nachträglich umbenannt oder aufgeräumt werden muss. Wer nicht sicher ist, wie ein Name lauten muss, fragt vorher nach, statt einen vorläufigen Namen zu vergeben. Namen gelten identisch in UCware (Gerät, Benutzer, Caller-ID) und im DHCP-Static-Lease.

• Tischtelefone / Basen (Gerätename in UCware und Hostname): phone-<s2|s3>-<raum> bzw. base-<name>, z.B. phone-s2-kueche, phone-s3-seminar, base-dect. Räume ohne Zuordnung zu einem Space (resinlab) haben kein Präfix.
• Benutzer (Anzeigename): <s2|s3>-<raum>, klein geschrieben, Nachname leer (z.B. s2-kueche). Dadurch lautet die Caller-ID einheitlich s2-kueche <202> (Name, zwei Leerzeichen, Nummer).
• Geräte pro Benutzer (Slots): einheitlich Deskphone, UCC Client, DECT phone, Softphone, Handy, App. Ein zweiter Client desselben Typs heißt UCC Client 2.
• Softphones / WebRTC-Clients: Telefon <login>_<nr> (von UCware erzeugt, nicht ändern).
• Schreibweise: immer klein, s2/s3 nie als S2/S3; keine Umlaute, keine Leerzeichen, Trennzeichen ist ausschließlich der Bindestrich.
• Checkliste für ein neues Telefon: (1) Name nach Schema festlegen, (2) Static Lease mit genau diesem Namen beim OpenWrt anlegen lassen (53C70R), (3) Benutzer mit Anzeigename s2-<raum> bzw. s3-<raum> anlegen, (4) Gerät in UCware mit dem Namen phone-... benennen, (5) Caller-ID prüfen (<s2|s3>-<raum> <nr>), (6) Slot Deskphone benennen. Erst danach ist das Telefon fertig eingerichtet.

Nutzung & Features

Externe Einwahl

Es ist möglich, aus dem öffentlichen Telefonnetz angerufen zu werden.

• Ausgehend: Alle Telefone und Clients übermitteln bei ausgehenden Anrufen die Rufnummer +4953118059780.
• Eingehend: Die Rufnummern sind wie folgt routiert:
  • +4953118059786-NSt. wählt die entsprechende Nebenstelle an
  • +4953118059780: Space Sprachdialogsystem (Intern 77770)
  • +4953118059781: Space Gesamt (Intern 100)
  • +4953118059782: Space 2 (Intern 200)
  • +4953118059783: Space 3 (Intern 300)
  • +4953118059788: Telefonnummer für Lieferdienste

• Notrufe: Mit den Spacetelefonen können die Notrufnummern 110 und 112 gewählt werden. Als Notrufstandort wird dabei die Adresse des Space an die Leitstelle übermittelt.

• Kostenhinweis: Derzeit ist alles, was Geld kostet, zum Raustelefonieren gesperrt. Kostenfrei telefoniert werden kann unter anderem innerhalb des Sipgate-Netzes.

EPVPN

Die Auswahl in das EPVPN-Netz ist möglich. Hierfür muss "#" vorweg gewählt werden (z.B. für die EPVPN-Nummer "1234" muss am Space-Telefon "#1234" gewählt werden). Derzeit ist eine Einwahl aus dem EPVPN-Netz in den Space noch nicht umgesetzt, jedoch geplant.

Webinterface

Der Zugriff erfolgt primär intern im Stratum0-Netz oder extern über VPN.

• URL: ucware.stratum0.net
• Zugang: Via Stratum Wireguard VPN erreichbar.
• WebRTC: Über das Webinterface können Anrufe direkt im Browser getätigt werden.

Autoprovisionierung per DHCP

Die Snom-Tischtelefone provisionieren sich automatisch. Der DHCP-Server des Space ist der OpenWrt-Router space.stratum0.net (dnsmasq), nicht die UCware; der ISC-DHCP-Server auf der UCware ist deaktiviert und nur mit der Standardkonfiguration vorhanden.

• Erkennung: dnsmasq vergibt allen Geräten mit MAC-Präfix 00:04:13 (Snom) den Tag snom. In LuCI steht die Option unter Netzwerk > DHCP und DNS > Tags (Tag snom); die MAC-Zuordnung ist nur in der Konfigurationsdatei sichtbar.
• Option 66: Für den Tag snom wird als Provisionierungs-Server https://ucware.stratum0.net/ mitgegeben. Die Telefone nutzen das gültige Zertifikat direkt, es ist kein Zertifikat auf dem Telefon nötig.
• Konfiguration auf dem OpenWrt: /etc/config/dhcp:

config mac
	option networkid 'snom'
	option mac '00:04:13:*:*:*'

config tag 'snom'
	list dhcp_option '66,https://ucware.stratum0.net/'

• Ablauf: Telefon erhält per DHCP IP und Option 66, holt seine Einstellungen von der UCware (nginx auf Port 80/443, Pfad /ucware/prov/snom/settings.php?mac=...) und registriert sich per SIP/TLS (Port 5061). Der Zugriff auf die Provisionierung ist auf private Netze (192.168/16, 172.16/12, 10/8) beschränkt.
• Static Leases: Alle Telefone und die DECT-Basis haben einen statischen Lease (config host mit Name, MAC und IP, unbegrenzte Leasetime) im OpenWrt. Der Hostname eines Telefons kommt ausschließlich aus diesem Eintrag, die Provisionierung der UCware setzt keinen Hostnamen. Ohne Eintrag meldet sich ein Snom mit seinem Standardnamen (z.B. snomD765-94122A). Bei neuen Telefonen also immer zuerst einen Static Lease anlegen (Name nach der Namenskonvention).
• Verhalten nach dem Neustart: Ein bereits provisioniertes Telefon verwendet seine gespeicherte Setting-URL (https://ucware.stratum0.net/ucware/prov/snom/settings.php?mac={mac}); sie ist von der UCware als schreibgeschützt gesetzt und lässt sich auch im Admin-Modus nicht über die Weboberfläche ändern. Option 66 greift bei einem Telefon auf Werkseinstellungen.

Neustart / Neuprovisionierung per Check-Sync

Auf der UCware können die Telefone aus der Ferne neu gestartet bzw. zur erneuten Provisionierung aufgefordert werden:

ucware-checksync [-u benutzername | -e rufnummer] [-a] [-r] [MAC ...]
ucware-checksync --reboot 0004137059DC   # Neustart + Neuprovisionierung
ucware-checksync 000413949D49            # nur neu provisionieren, kein Neustart

Hinweis: Die MAC wird ohne Doppelpunkte angegeben. Das Skript sendet ein SIP-NOTIFY mit Event: check-sync. Ein direkter Aufruf von pjsip send notify in Asterisk funktioniert nicht, da keine pjsip_notify.conf vorhanden ist (das Konfigurationsverzeichnis von Asterisk ist /opt/ucware/etc/asterisk).

Technische Details & Zugriff

• Richtlinie: Es ist vorgesehen, dass jeder Raum einen eigenen Benutzer hat, der am jeweiligen Telefon angemeldet ist.
• Webinterface Benutzername: Der Benutzername für das Webinterface jedes Telefons ist der jeweilige 'Raum / Ort' (z.B. 'kueche').
• Passwörter / PINs: Die Telefon-PIN zum Anmelden am Gerät und das Passwort für das Webinterface sind im aktuellen Setup identisch und entsprechen standardmäßig der jeweiligen Rufnummer. Obwohl diese prinzipiell unterschiedlich sein könnten, wurden sie für die Telefone gleich eingestellt.
• Status "Nobody": Zeigt ein Telefon eine Nummer beginnend mit "95" (z.B. "nobody-95..."), ist kein Benutzer angemeldet.
• Anmeldung eines Telefons per Datenbank: Ein Telefon gilt als am Benutzer angemeldet, wenn sein Gerät im Slot Deskphone des Benutzers eingetragen ist (Tabelle slots, Spalte device). Ist der Slot leer, zeigt das Telefon eine "nobody"-Nummer (95...). Nach einer Zuordnung ein Check-Sync (siehe oben) senden.
• Caller-ID: wird je Gerät gespeichert (Tabelle devices) und beim Ändern von Anzeigenamen in der Datenbank nicht automatisch neu erzeugt; sie muss in diesem Fall mitgezogen werden.

Hinweis: Für Trunk-Informationen wenden Sie sich bitte an Benutzer:i4n.

Grundsätzlich können Space-Entitäten auch einen persönlichen Benutzer inkl. virtueller Nebenstellen erhalten.

Tischtelefon neu einrichten

Snom (mit DHCP-Autoprovisionierung):

1. Static Lease für das Telefon im OpenWrt anlegen (Name nach Namenskonvention, MAC, feste IP). Hierfür bitte an 53C70R wenden.
2. Benutzer in der UCware anlegen (Anzeigename s2-<raum> bzw. s3-<raum>).
3. Telefon anschließen, dabei "#" gedrückt halten und das Telefon zurücksetzen. Nach dem Start holt es sich per DHCP (Option 66) die Provisionierung von ucware.stratum0.net.
4. Wenn das Telefon wieder gestartet ist, kurz Roaming Berechtigung für Gruppe "users" einschalten, "Anmelden" drücken und PIN und Benutzer eintragen. Alternativ das Gerät in der Datenbank dem Slot Deskphone des Benutzers zuordnen und ein Check-Sync senden.
5. Außerdem muss eine Lizenz unter "Lizenz" zugewiesen werden.

Manuelle Einrichtung (falls Option 66 nicht ankommt): Weboberfläche des Telefons öffnen, "Erweitert" > "Update" wählen, als URL https://ucware.stratum0.net/ucware/prov/snom/settings.php?mac={mac} eintragen und speichern+neustarten.

Dokumentation

• Offizielles Wiki: wiki.ucware.com
  • Siehe Bereich "Endgeräte" für spezifische Snom-Anleitungen.
  • Siehe Bereich "Telefonieren" für weitere Leistungsmerkmale.