Einstellungen des Relays im Formular ändern statt in der relay.json

Worum es geht

Alle Einstellungen Ihres Relays stehen in der Datei relay.json. Sie müssen sie nicht von Hand bearbeiten: Die Konsole zeigt sie als Formular mit Abschnitten. Kennwörter und andere Geheimnisse verlassen dabei nie den Server — Sie sehen nur, ob eines gesetzt ist.

Das brauchen Sie

• Ein eigenes Relay ab Fassung 20260924.12 (B2).
• Ein Konsolenkonto mit der Rolle System-Administrator. Andere Rollen sehen diese Seite nicht.

So geht's

1. In der Konsole Einstellungen öffnen. Unter Ersteinrichtung auf Konfiguration klicken.
2. Den passenden Abschnitt aufklappen. Es gibt unter anderem:

| Abschnitt | Was Sie dort einstellen | |---|---| | Server | Port, Bind-Adresse, erlaubte Browser-Ursprünge, Aufbewahrung von Aufzeichnungen, wartende Betrachter je Adresse | | TLS-Zertifikat | PFX-Datei und Kennwort, unter Windows den Fingerabdruck aus dem Zertifikatsspeicher | | STUN und TURN | öffentliche IP, Ports, TURN über TLS, Portbereich für vermittelte Medien | | Selbstupdate und Spiegel | Selbstupdate des Relays, Feed-Adresse, Spiegel der Programm-Feeds | | Verwaltung und Datenbank | Verbindung zur Datenbank | | Anmeldung per SSO (OIDC), Bereitstellung per SCIM, Anmeldung per LDAP / Active Directory | Firmen-Anmeldung für Konsolenkonten (B4) | | Gerätezertifikate (mTLS) | Zertifikate für Geräte (B9) | | E-Mail (SMTP) | Mailversand des Relays |

1. Werte ändern. Unter jedem Feld steht ein Hinweis, was es bewirkt.
2. Geheimnisse (Kennwörter, Client-Secret, Datenbank-Verbindung): - leer lassen = unverändert, - neuen Text eintragen = neu setzen, - Geheimnis löschen anhaken = leeren.
3. Speichern klicken. Port, Bind-Adresse, TLS, TURN und Datenbank brauchen einen Neustart — dafür Speichern & Relay neu starten nehmen. Alles andere gilt sofort.

Für Werte ohne eigenes Feld gibt es unten Erweitert: relay.json als Text. Dort steht die ganze Datei, Geheimnisse als Platzhalter. Was Sie dort speichern, ersetzt die ganze Datei; Platzhalter bleiben dabei erhalten.

Daran sehen Sie, dass es geklappt hat

• Nach Speichern erscheint „Gespeichert. Port, TLS und TURN wirken nach dem nächsten Neustart des Relays.“
• Nach Speichern & Relay neu starten erscheint „Gespeichert. Relay startet neu… (kurz warten, dann neu laden)“. Nach dem Neuladen zeigt das Formular Ihre Werte.
• Bei einem Geheimnis steht „gesetzt — leer lassen = unverändert“ statt „nicht gesetzt“.

Gut zu wissen

• Beim Neustart verbinden sich laufende Sitzungen von selbst neu; der Betrachter zeigt das an.
• Unter Windows ist der Neustart aus der Konsole noch nicht am echten Relay geprüft. Kommt das Relay nicht zurück, den Dienst BrowserDeskRelay in der Windows-Diensteverwaltung neu starten.
• Alle Änderungen landen im Audit-Log — mit den Namen der Felder, nie mit den Werten.
• Geheimnisse werden verschlüsselt gespeichert. Den Schlüssel dafür müssen Sie sichern (B9).
• Hand-Änderungen an der Datei wirken erst nach einem Neustart. Ist die Datei danach kein gültiges JSON, startet das Relay nicht und legt eine Kopie relay.json.broken-<Zeit> an. Das Formular prüft Ihre Eingaben vorher.
• Formular und Text zugleich geändert: Die Konsole fragt Formular oder Text?. Gespeichert wird dann der Text; die Formularänderungen gehen verloren.
• Der Pfad der Datei steht unter Erweitert: relay.json als Text.

Wenn es nicht klappt