EasyUC

Software, Updates und Lizenzdateien finden Sie im Kundenbereich. Zu den Downloads

Zertifikate erstellen und einrichten

Das Zertifikat für die Weboberfläche per CSR und die Zertifikate des Teams-SBC über Let's Encrypt.

Gilt für: EasyUC 4.8.7 Stand: Oktober 2026

Teil 1 · Weboberfläche

Webzertifikat: Überblick

Das Webzertifikat sichert HTTPS für Administration, Portale und Manager. Bis Sie ein eigenes Zertifikat aktivieren, verwendet Traefik ein eigenes, selbstsigniertes Zertifikat.

EasyUC erzeugt den privaten Schlüssel selbst, er verlässt den Cluster nicht. Sie erstellen deshalb im Manager eine Zertifikatsanforderung (CSR), lassen sie von Ihrer CA signieren und laden das Zertifikat wieder hoch.

Ablauf für das Webzertifikat Im Manager wird eine CSR mit einem RSA-Schlüssel mit 4096 Bit erstellt. Ihre CA signiert sie. Das Zertifikat wird mit der CA-Kette hochgeladen, geprüft und aktiviert und gilt dann in Traefik für alle Web-Routen. Der private Schlüssel bleibt im Cluster. EASYUC-CLUSTER 1 CSR erstellen RSA 4096, Schlüssel bleibt im Cluster 3 Hochladen Zertifikat (PEM/DER) und CA-Kette 4 Aktivieren Schlüssel prüfen, Kette sortieren 5 Traefik gilt für alle Web-Routen CSR 2 Ihre CA interne PKI oder öffentliche CA signiertes Zertifikat
Ablauf für das Webzertifikat. Der private Schlüssel bleibt im Cluster.

Webzertifikat einrichten

  1. CSR erstellen

    Öffnen Sie im Manager den Bereich für SSL-Zertifikate. Geben Sie Land, Bundesland, Stadt, Organisation, Common Name und E-Mail-Adresse ein, dazu die SAN-Einträge. EasyUC erzeugt einen RSA-Schlüssel mit 4096 Bit.

  2. CSR signieren lassen

    Reichen Sie die CSR bei Ihrer CA ein, einer internen PKI oder einer öffentlichen CA.

  3. Zertifikat hochladen

    Laden Sie das signierte Zertifikat im Format PEM oder DER hoch, dazu die CA- und Zwischenzertifikate.

  4. Aktivieren

    EasyUC prüft, ob das Zertifikat zum Schlüssel passt, und sortiert die Kette. Ist die Kette unvollständig, erhalten Sie eine Warnung. Danach gilt das Zertifikat für alle Web-Routen.

Tipp

Tragen Sie als SAN alle Hostnamen und IP-Adressen ein, unter denen EasyUC erreichbar sein soll. EasyUC erkennt bei jedem Eintrag selbst, ob es ein DNS-Name oder eine IP-Adresse ist. Weil es keine gemeinsame virtuelle IP gibt, gehören bei einem Cluster auch die Namen dazu, auf die Sie nach einem Ausfall umstellen, siehe Redundanz.

Warnung

Einen vorhandenen privaten Schlüssel oder eine PFX-/PKCS#12-Datei können Sie nicht importieren. Das Zertifikat muss für die CSR ausgestellt sein, die Sie in EasyUC erstellt haben.

Webzertifikat erneuern

Der Manager zeigt die verbleibende Gültigkeit an. Unter 30 Tagen empfehlen wir die Erneuerung.

Eine automatische Erneuerung gibt es für das Webzertifikat nicht. Wiederholen Sie die Schritte: CSR erstellen, signieren lassen, hochladen, aktivieren.

Teil 2 · Teams-SBC

Teams-SBC-Zertifikate: Überblick

Für Direct Routing braucht jeder Teams-Tenant ein öffentliches Zertifikat für den SBC. EasyUC bezieht es bei Let's Encrypt über die DNS-01-Prüfung. Port 80 muss dafür nicht aus dem Internet erreichbar sein.

Der SAN ist der SBC-FQDN des Tenants, zum Beispiel sbc.example.com. Die Domain muss im Teams-Tenant verifiziert sein.

Der SBC verwendet TLS 1.2 mit mutual TLS gegen die Root-CAs von Microsoft. Das Zwischenzertifikat ist Teil der Kette.

SBC-Zertifikat ausstellen

Für die DNS-01-Prüfung muss ein TXT-Eintrag in der DNS-Zone des SBC-FQDN stehen. Den legen Sie von Hand an, oder EasyUC erledigt das über Cloudflare.

Manuell

  1. EasyUC zeigt den TXT-Eintrag _acme-challenge.<fqdn> und seinen Wert an.

  2. Legen Sie den Eintrag bei Ihrem DNS-Anbieter an.

  3. Bestätigen Sie in EasyUC. EasyUC prüft den Eintrag und stellt das Zertifikat aus.

Beispiel für den TXT-Eintrag
_acme-challenge.sbc.example.com.  TXT  "<Wert aus EasyUC>"

Automatisch mit Cloudflare

Hinterlegen Sie ein Cloudflare-API-Token. EasyUC legt den TXT-Eintrag dann selbst an und entfernt ihn danach wieder.

EasyUC braucht dafür ausgehend TCP 443 zu api.cloudflare.com.

Erneuerung und Neuladen

  • EasyUC prüft täglich um 03:30 Uhr, ob eine Erneuerung fällig ist.
  • Mit Cloudflare erneuert EasyUC das Zertifikat automatisch, sobald 30 Tage oder weniger Gültigkeit übrig sind.
  • Ohne Cloudflare zeigt die Administrationsoberfläche an, dass die Erneuerung fällig ist. Sie wiederholen dann den manuellen TXT-Schritt.
  • Die Gültigkeit mit Ablaufdatum und verbleibenden Tagen sehen Sie je Tenant.

Der SBC lädt ein neues Zertifikat automatisch. Das SIP-Profil des Tenants startet er neu, sobald kein Gespräch aktiv ist, spätestens nach 30 Minuten.