So konfigurieren Sie das Administratorkonsolenpasswort für Collabora Online

Wenn Sie Collabora Online öffnen, sich aber nicht in der Admin-Konsole anmelden können, wurden die Anmeldeinformationen möglicherweise nie für den Collabora-Server konfiguriert. Die Lösung hängt von der Installationsmethode von Collabora ab: Bei einer Linux-Paketinstallation wird das Dienstprogramm verwendet , während das offizielle CODE-Docker-Image die Umgebungsvariablen coolconfigakzeptiert . Dies sind separate Installationspfade; wählen Sie denjenigen, der Ihrer Bereitstellung entspricht.usernamepassword

Die Admin-Konsole ist eine serverseitige Verwaltungsoberfläche. Sie ist nicht identisch mit Ihrem Nextcloud-Administratorkonto, dem Login eines Dokumentbenutzers oder den WOPI-Integrationsdaten. Das Collabora SDK-Handbuch 24.04 dokumentiert die Adresse der Konsole, die Linux-Konfigurationsmethode und die Docker-Image-Variablen. Da sich die Bereitstellungsdetails zwischen den Versionen ändern können, prüfen Sie bitte die Dokumentation der von Ihnen verwendeten Version, bevor Sie Änderungen in der Produktionsumgebung vornehmen: Collabora Online SDK-Handbuch 24.04 .

Wählen Sie die Konfigurationsmethode, die zu Ihrer Installation passt.

Identifizieren Sie zunächst die Bereitstellung. coolwsdLäuft der Dienst direkt als Systemdienst und verfügt der Host über den coolconfigentsprechenden Befehl, verwenden Sie die Paketmethode. Läuft der Dienst in einem Container, der auf basiert collabora/code, konfigurieren Sie stattdessen dessen Umgebung. Vermeiden Sie es, ein Passwort auf dem Host festzulegen und zu erwarten, dass es einen bereits laufenden Container ändert.

Bei der Installation eines Linux-Pakets muss das Passwort interaktiv festgelegt werden.

1. Öffnen Sie ein Terminal auf dem Collabora-Server oder stellen Sie eine Verbindung über SSH mit einem Konto mit sudo-Zugriff her.
2. Laufen sudo coolconfig set-admin-password.
3. Geben Sie bei Aufforderung den Benutzernamen und das Passwort der Administratorkonsole ein und bestätigen Sie anschließend das Passwort. Das Terminal sollte das Passwort während der Eingabe nicht anzeigen.
4. Falls Ihre Installation nach einer Konfigurationsänderung einen Neustart des Dienstes erfordert, führen Sie den entsprechenden Befehl aus sudo systemctl restart coolwsd. Überprüfen Sie den Dienststatus mit dem Befehl sudo systemctl status coolwsd.
5. Öffnen Sie die URL der Admin-Konsole und melden Sie sich mit den soeben festgelegten Anmeldeinformationen an.

Das dokumentierte Dienstprogramm fragt interaktiv nach Benutzername und Passwort und speichert das Passwort als gesalzenen Hash in der Konfigurationsdatei. Dies ist der direkten Eingabe des Passworts in der Befehlszeile oder dem manuellen Schreiben in eine XML-Datei vorzuziehen. Führen Sie den Befehl als administrative Aktion auf dem Collabora-Host aus, nicht auf dem Nextcloud-Host, es sei denn, Collabora ist dort ebenfalls installiert.

Falls coolconfigdie Datei nicht gefunden wird, überprüfen Sie, ob es sich um eine paketbasierte Collabora-Installation handelt und ob Sie sich auf dem richtigen Server befinden. Ein CODE-Container verfügt über einen eigenen Konfigurationsmechanismus. Wenn der Befehl erfolgreich ausgeführt wird, die Authentifizierung aber weiterhin fehlschlägt, überprüfen Sie Hostname und Port, versuchen Sie es erneut mit dem exakt festgelegten Benutzernamen und prüfen Sie die Dienstprotokolle, bevor Sie Änderungen an anderen Proxy- oder WOPI-Einstellungen vornehmen.

Für das CODE-Docker-Image müssen beide Umgebungsvariablen festgelegt werden.

Das offizielle CODE-Image liest beim Start des Containers die Umgebungsvariablen usernameaus password. Fügen Sie beide Werte zur Containerkonfiguration hinzu; die Angabe eines Passworts allein reicht nicht aus. Für Docker Compose könnte eine Zuordnung wie folgt aussehen:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      username: collabora_admin
      password: ${COLLABORA_ADMIN_PASSWORD}

Speichern Sie das eigentliche Passwort in einer geschützten Umgebungsdatei oder einem geheimen Deployment-Speicher, anstatt es in ein Quellcode-Repository einzuchecken oder in eine öffentliche Supportanfrage einzufügen. Eine Compose- .envDatei ist zwar praktisch für die Variablenersetzung, enthält aber dennoch sensible Daten: Beschränken Sie den Lesezugriff. Jeder mit Zugriff auf den Docker-Daemon kann in der Regel die Containerkonfiguration einsehen, daher ersetzen Umgebungsvariablen nicht die Zugriffskontrollen auf dem Host.

Speichern Sie die Compose-Datei und erstellen Sie den Container neu, damit Docker beim Start die aktualisierte Umgebung übergibt. Für einen Dienst mit dem Namen ` <service-name> collabora` ist dies üblicherweise ` docker compose up -d --force-recreate collabora<service-name>`. Ein einfacher Neustart des Containers ersetzt nicht die beim Erstellen des Containers gespeicherten Umgebungswerte. Überprüfen Sie Ihre Compose-Version und den Dienstnamen, bevor Sie den Befehl ausführen, und vermeiden Sie die Anzeige eines Passworts im Shell-Verlauf.

Bei einer direkten docker runBereitstellung entsprechen die Einstellungen Umgebungsvariablen, die mit übergeben werden -e, wie z. B. ` -e username=collabora_adminpassword` und `password` -e password=.... Verwenden Sie Ihren eigenen Ansatz zur Geheimnisverwaltung, um den Wert anzugeben; kopieren Sie kein Beispielpasswort aus einem Tutorial in einen öffentlich zugänglichen Dienst.

Öffnen Sie die Administratorkonsole und überprüfen Sie die Anmeldung.

Der dokumentierte Konsolenpfad lautet [URL einfügen /browser/dist/admin/admin.html]. Auf dem Standardport lautet die vollständige URL [URL einfügen] https://your-collabora-host:9980/browser/dist/admin/admin.html. Falls TLS an einem Reverse-Proxy terminiert, verwenden Sie den öffentlichen HTTPS-Hostnamen und -Port, der von diesem Proxy freigegeben wird. Die Adresse kann abweichen, wenn Ihr Administrator einen anderen Port oder ein anderes URL-Routing konfiguriert hat.

Melden Sie sich an und vergewissern Sie sich, dass die Konsole ihre Überwachungsinformationen lädt. Das SDK-Handbuch beschreibt die Live-Sitzungsüberwachung, einschließlich geöffneter Dokumente und Benutzer. Da die Konsole Betriebsdetails offenlegen und administrative Aktionen wie das Schließen von Dokumentsitzungen ermöglichen kann, beschränken Sie den Zugriff auf vertrauenswürdige Administratoren, verwenden Sie HTTPS und vermeiden Sie es, den Verwaltungsendpunkt öffentlich im Internet zugänglich zu machen. Implementieren Sie Netzwerkbeschränkungen an der Firewall oder am Reverse-Proxy, sofern Ihre Bereitstellung dies unterstützt.

Prüfen Sie bei einer Paketinstallation, ob der Dienst fehlerfrei funktioniert sudo systemctl status coolwsd. Untersuchen Sie bei Docker den Containerstatus mit dem Befehl `docker container status` docker compose psund die aktuellen Protokolle mit `docker logs` docker compose logs --tail=100 collabora. Ein fehlerfreier Dienst allein beweist nicht, dass das Passwort korrekt ist; die abschließende Prüfung erfolgt durch eine erfolgreiche Anmeldung an der Admin-Konsolen-URL.

Häufige Missverständnisse und was man stattdessen tun sollte

„Die Admin-Konsole verwendet mein Nextcloud-Passwort.“

Standardmäßig nicht. Die Anmeldeinformationen für die Collabora-Administrationskonsole werden auf dem Collabora-Server konfiguriert, unabhängig von den Nextcloud-Benutzerkonten. Vorgehensweise: coolconfig set-admin-passwordBei einer Paketinstallation verwenden oder die CODE-Containerumgebung aktualisieren und den Container neu erstellen.

„Ich habe die Docker Compose-Datei geändert, sodass der laufende Container das neue Passwort hat.“

Das Bearbeiten der Datei ändert die gespeicherte Umgebung eines bestehenden Containers nicht. Maßnahme: Erstellen Sie den entsprechenden Compose-Dienst neu und testen Sie anschließend die neuen Anmeldeinformationen. Geben Sie das Passwort nicht in der Befehlsausgabe und der Versionskontrolle an.

„Wenn die URL der Admin-Konsole geöffnet werden kann, ist der Server gesichert.“

Der Seitenzugriff beweist lediglich, dass die Route antwortet; er beweist nicht, dass sichere Anmeldeinformationen konfiguriert oder der Netzwerkzugriff eingeschränkt ist. Laut SDK-Handbuch ist die Konsole deaktiviert, wenn der erforderliche Benutzername oder das Passwort nicht festgelegt ist. Außerdem werden dort administrative Überwachungsfunktionen beschrieben. Empfehlung: Legen Sie ein eindeutiges Passwort fest, stellen Sie sicher, dass eine Authentifizierung erforderlich ist, und beschränken Sie den Zugriff auf den Konsolenendpunkt.

„In der Administratorkonsole können Sie die Zugangsdaten für die Dokumentenbearbeitung festlegen.“

Das Konsolenpasswort schützt die Verwaltungsschnittstelle. Es ersetzt weder die WOPI-Hostkonfiguration noch das von Ihrer Dateiplattform verwendete Identitätssystem. Empfehlung: Lassen Sie die WOPI- und Reverse-Proxy-Einstellungen unverändert, es sei denn, Sie beheben Probleme mit diesen separaten Verbindungen.

Wenn die Anmeldung weiterhin fehlschlägt.

• Prüfen Sie, ob Collabora als Host-Dienst oder in einem CODE-Container ausgeführt wird, und verwenden Sie dann nur den entsprechenden Konfigurationspfad.
• Überprüfen Sie die genaue öffentliche Konsolen-URL, einschließlich HTTPS, Port und /browser/dist/admin/admin.html.
• Prüfen Sie bei Docker, usernameob beide Komponenten passwordin der effektiven Servicekonfiguration vorhanden sind, und erstellen Sie den Container nach den Änderungen neu.
• Führen Sie bei einer Paketinstallation den interaktiven coolconfigBefehl auf dem Collabora-Host erneut aus und überprüfen Sie coolwsdStatus und Protokolle.
• Falls ein Reverse-Proxy im Spiel ist, bitten Sie dessen Administrator, zu überprüfen, ob die Route zur Admin-Konsole und der erforderliche WebSocket-Datenverkehr korrekt weitergeleitet werden. Schwächen Sie die Authentifizierung nicht, um ein Proxy-Problem zu umgehen.

Sobald Sie sich anmelden können und der Dienst einwandfrei funktioniert, speichern Sie die neuen Anmeldeinformationen in Ihrem zugelassenen Passwortmanager und dokumentieren Sie, welcher Host oder Container sie verwaltet. Die Konfiguration der Collabora-Administrationskonsole kann je nach Version und Paketierungsmethode variieren. Das oben erwähnte SDK-Handbuch 24.04 ist versionsspezifisch. Verwenden Sie daher die entsprechende Dokumentation für eine neuere oder herstellerspezifische Bereitstellung.