Systemsteuerung
v3.5
ONLYOFFICE Systemsteuerung: Änderungsprotokoll
Version 3.5.2
Release date: 02/29/2024
- Added the ability to restrict access rights to the application files for the Others group.
- Fixed issue with redirect to the portal main page when opening Control Panel after a day on Ubuntu 22.10.
- Fixed retrieving data error when opening the backup page.
- Fixed issue when backup with Mail is not performed after disabling and enabling encryption (added text about stopping services and the instruction to the Help Center).
- Fixed issue when features are not saved to the new tariff when setting a quota for the portal.
- Edited sources build.
Version 3.5
Release date: 03/14/2023
- Changed API methods for migration, implemented progressQueue.
- Changed settings for connecting third-party storages. Added tooltips for fields. Added the 'Server Side Encryption Method' block for Amazon AWS S3.
- Added logos for dark theme in the Branding section. Logos for the About page are now separate fields in the Advanced tab.
- Added the ability to set the portal memory quota.
Version 3.1.1
Release date: 08/08/2022
- Fixed issue with file indexing.
- Fixed elasticsearch container errors when updating ONLYOFFICE Groups.
- Fixed issue with brand logos after updating in the Docker installation.
- Fixed texts and layout for the Migration feature.
Version 3.1
Release date: 05/25/2022
- Added the Data Import page that allows to import data from Nextcloud, ownCloud and GoogleWorkspace to ONLYOFFICE Workspace.
- Moved Elasticsearch to a separate container.
- Fixed bugs.
Version 3.0
Release date: 06/07/2021
- License agreement dialog when installing docker components added.
- The inactive button with an action for uninstalled components (downloading and installing the available version) fixed.
- Indexing progress display added.
- New checks when restoring data from a local or a 3rd party storage.
- SSOAuth was removed from Control Panel. It's now available as a portal setting in Community Server.
- Bugs 47721, 49101, 49187, 49273, 49272, 49324, 46386, 49585 from the internal bugtracker fixed.
- 3rd party licenses and copyright updated.
Version 2.9.1
Release date: 12/10/2020
- Bug Fixes & Performance Improvements.
Version 2.9
Release date: 10/14/2020
- Control Panel is available in the free Community version with all settings excepting the editors logo replacement;
- Added the vsyscall check to the installation scripts when installing Mail Server on Debian with kernel 4.18.0 and later;
- Redesign of the navigation menu: added Common and Portal settings sections, added icons to menu items;
- Added the advanced rebranding page in the Common Settings;
- Added the possibility to reindex the full-text search;
- Updated
node.js
, updated packages (transition to samlify
for SSO);
- Added the Encryption at rest block in the Storage section;
- Added the Private Room section for the server version only;
- Added the
upgrade
page with a proposal to upgrade to Enterprise Edition;
- Added the
activate
page with a possibility to upload a license file;
- Added the HideAuthPage option to the SSO settings to hide the authorization page. When the HideAuthPage option is enabled, an automatic redirect from the authorization page to the SSO service will occur.
- Added the Sign in to domain option on the authorization page.
- Transition to the new
samlify
library;
- Added the HideAuthPage option to the SSO settings to hide the authorization page. When the HideAuthPage option is enabled, an automatic redirect from the authorization page to the SSO service will occur.
Version 2.7
Release date: 04/25/2019
- Added more fields mapped for the users loaded via LDAP: user photo, birthday, contacts, primary phone number;
- Added the setting to autosync LDAP on schedule;
- Added the possibility to give administrator rights to the user group at the portal via LDAP;
- Updated the rules for LDAP users.
Version 2.5.1
Release date: 04/07/2018
- Fixed the
Server internal error
error when using the groups enclosed inside each other in the AD (bug #37414).
- Fixed the issue when the user data between the Service Provider and the portal was transferred via HTTP only, even when HTTPS was enabled.
Version 2.4.0
Release date: 01/13/2018
- Fixed the
Invalid ssoConfig
error which occurred when the link to the IdP contained the question mark '?', e.g.: IdP Single Sign-On Endpoint URL: https://accounts.google.com/o/saml2/idp?idpid=777777
;
- Fixed the
Invalid authentication token
error which prevented from adding a user to the portal using the AD FS, in case the +
or -
characters were present when sending the encrypted data.
Version 2.3.0
Release date: 12/15/2017
- Added the changelog for Control Panel and link to it;
- Fixed the bug when JWT parameters were not sent when updating Document Server(bug #36270);
- Fixed the bug when
Audit Trail
heading was present at the login history page (bug #36026);
- The current machine is now checked for being linked with the domain name for multiple portals.
- Fixed the bug with the
LDAP Domain not found
error which occurred if the DN record had no DC records (the users with Sun/Oracle DS were affected); now if the LDAP domain could not be specified, the LDAP domain will acquire the unknown
value or the ldap.domain
value from the web.appsettings.config
configuration file;
- Fixed the bug with the
Sizelimit Exceeded
error when trying to get more than 1000 users from the Active Directory;
- Increased the login speed with the Group Membership setting enabled;
- Added additional logging;
- Fixed the bug with LDAP operation hanging when using Mono v5.2.0 and older;
- Fixed the bug with the error when trying to login using the email address entered in the fields different from the
Mail Attribute
;
- Fixed the bug occurring in the enclosed groups, when the users were displayed not in all groups.
Version 2.2.0
Release date: 10/31/2017
- Added the
documentserver-prepare4shutdown.sh
script launch when updating the document-server for the correct edited document saving.
- Dramatically changed LDAP integration, migrated to the single library for the work with LDAP (Novell.Directory.Ldap.NETStandard, Nuget, MIT);
- Login and email are now split into two separate fields;
- Added the support for big data;
- Increased the work speed via the LDAP protocol (the connection to the server and receiving the data is now made once per session, added the limits when only a certain number of results is necessary, fixed the slow login for bit data, removed the sorting out used to find the SID parameter);
- Fixed the user re-creation issue;
- Fixed the duplicate username issue;
- Fixed the already existing email issue;
- Replaced the LDAP user deletion with account deactivation (for further data migration and data safety);
- Instead of re-creating a user with an unknown SID but an existing email the data is updated;
- Added the attempt to save the correct UserName/Login in case a similar one is already taken on the portal.
- Added the AD FS support;
- Replaced the Single Sign-on link at the authorization page with the customizable button, added the button customization to the SSO setting of the Control Panel.
Version 2.1.0
Release date: 07/03/2017
- Added the support of letsencrypt service for the domain certificate generation.
- Added the new
sso.auth
service;
- Added the new SSO settings page;
- Added the support for Shibboleth.
Version 2.0.0
Release date: 05/25/2017
- The Control Panel migrated from
MVC
to Node.js
.
Version 1.6.0
Release date: 12/05/2016
- Added LDAP synchronization for users and groups when saving the settings, after login and using the Sync button;
- Changed email formation for LDAP users;
- Fixed the problem of creation of users with invalid emails;
- Fixed the problem of duplicate users;
- Added icons and hints to the users in the list for the admin;
- Blocked for editing the user profile fields imported using LDAP;
- Added the real LDAP password saving to the database during login in case LDAP Auth is disabled, now the LDAP users will become common portal users when LDAP Auth is disabled;
- Added new API Settings method - Sync LDAP;
- Added new translations;
- Bug fixes.
- Made changes at the Update page for the Control Panel for Windows;
- Updates are performed using the downloaded installation packages for each module.
- The current installed component version numbers are obtained via API request to the Community Server.
- The new versions available for download are obtained via the request to the https://download.onlyoffice.com/install/windows/updates.txt file, where all the latest component version numbers and links for their download are stored in the JSON format.
Einleitung
Single Sign-On (SSO) ist eine Technologie, mit der sich Benutzer nur einmal anmelden und dann ohne erneute Authentifizierung auf mehrere Anwendungen/Dienste zugreifen können.
Enthält ein Webportal mehrere große unabhängige Bereiche (Forum, Chat, Blogs usw.), kann ein Benutzer innerhalb eines der Dienste das Authentifizierungsverfahren durchlaufen und erhält automatisch Zugang zu allen anderen Diensten ohne mehrmalige Eingabe von Zugangsdaten.
SSO wird immer durch den gemeinsamen Betrieb von zwei Anwendungen sichergestellt: einem Identitätsanbieter und einem Dienstanbieter (im Folgenden als "IdP" und "SP" bezeichnet). ONLYOFFICE SSO implementiert nur den SP. Viele verschiedene Anbieter können als IdP fungieren, aber dieser Artikel befasst sich mit der Implementierung von Shibboleth.
Wenn Sie beim Verbinden von ONLYOFFICE Desktop Editoren mit Ihrem ONLYOFFICE Workspace SSO verwenden möchten, deaktivieren Sie Private Räume in der Systemsteuerung.
Vorbereiten des ONLYOFFICE Workspace für das SSO-Setup
- Installieren Sie ONLYOFFICE Workspace v. 11.0.0 für Docker oder eine spätere Version mit SSO-Unterstützung.
- Fügen Sie einen Domainnamen hinzu, z.B. myportal-address.com.
- Gehen Sie in Ihrem Portal zur Systemsteuerung -> HTTPS, erstellen Sie das letsencrypt-Zertifikat für die Traffic-Verschlüsselung und wenden Sie es an (um HTTPS in Ihrem Portal zu aktivieren).
Shibboleth IdP erstellen
Anforderungen
Shibboleth IdP erstellen
Laden Sie das Skript install.sh herunter und führen Sie es aus, um Shibboleth IDP zu erstellen, konfigurieren und starten.
Hier ist, was das Skript macht:
- lädt Docker-Dateien zum Erstellen von Shibboleth-Idp-Images und -Containern von github herunter,
- ändert die Standarddomain idptestbed.edu in den Konfigurationsdateien an die Domain, die beim Ausführen des Skripts angegeben wurde,
- fügt den Zugriff über das SAML-Protokoll für die angegebene ONLYOFFICE SP-Domains hinzu,
- gibt an, welche Attribute für ONLYOFFICE SP erforderlich sind, um Informationen über Benutzer von Shibboleth IDP auszugeben (Einstellung Attributzuordnung),
- erstellt und konfiguriert LDAP und erstellt Benutzer für die Ausgabe,
- ermöglicht das dynamische Laden von Metadaten von ONLYOFFICE SP zu Shibboleth IDP,
- aktiviert Shibboleth SLO, falls erforderlich.
- Laden Sie das install.sh-Skript herunter:
curl -L https://help.onlyoffice.co/Products/Files/HttpHandlers/filehandler.ashx?action=download&fileid=6875651&doc=MW9QWHdCQU9HOTN5dlpBWVQxTGtOem55SjJaNWx4L1ZIdTNkQk53QnpDYz0_IjY4NzU2NTEi0 -o install.sh
- Machen Sie das Skript ausführbar:
chmod +x install.sh
- Führen Sie das Skript aus und ersetzen Sie die Parameter durch Ihre eigenen:
./install.sh -id your-idp-domain.com -sd myportal-address.com --no_slo
Skriptparameter:
- -id - ein Domainname des aktuellen Computers für Shibboleth IDP.
- -sd - ein Domainname, in dem ONLYOFFICE SP bereitgestellt wird.
- --no_slo - deaktiviert Single Logout in Shibboleth IDP (optionaler Parameter).
- Warten Sie, wenn Shibboleth IDP nach der Ausführung des Skripts startet.
- Um zu überprüfen, ob Shibboleth IDP korrekt gestartet wurde, öffnen Sie den Link https://your-idp-domain.com/idp/shibboleth in Ihrem Browser. Eine XML-Datei sollte angezeigt werden.
- Kopieren Sie den Link https://{your_idp_domain}/idp/shibboleth (z.B., https://your-idp-domain.com/idp/shibboleth) und gehen Sie zum ONLYOFFICE-Portal, indem Sie sich als Administrator anmelden. Öffnen Sie die Seite Systemsteuerung -> SSO.
- Stellen Sie sicher, dass Sie als Administrator in Ihrer ONLYOFFICE-Systemsteuerung angemeldet sind, und klicken Sie im Abschnitt PORTALEINSTELLUNGEN in der linken Seitenleiste auf die Registerkarte SSO.
Sie können im ONLYOFFICE-Portal nur einen Enterprise Identity Provider für Ihre Organisation registrieren.
- Aktivieren Sie SSO mit dem Umschalter Authentifizierung mit Einmalanmeldung einschalten und fügen Sie den Link zum Shibboleth-IdP in das Feld URL-Adresse zur IdP Metadaten-XML-Datei ein.
- Drücken Sie die Schaltfläche mit dem Aufwärtspfeil, um die IdP-Metadaten zu laden. Das Formular ONLYOFFICE SP-Einstellungen wird automatisch mit Ihren Daten vom Shibboleth-IdP ausgefüllt.
Da wir SLO beim Ausführen des install.sh-Skripts durch Angabe des Parameters --no_slo
deaktiviert haben, ist das Feld Einzel-Abmeldung-URL des Endpunkts von IdP leer.
- Sobald die IdP-Metadaten geladen sind, werden im Abschnitt Öffentliches Zertifikat des Identity-Providers zwei Zertifikate hinzugefügt. Außerdem sehen Sie das Pop-Up-Fenster mit dem folgenden Text: 'Mehrere ldp Zertifikate zur Verifizierung werden nicht unterstützt. Bitte stellen Sie nur das primäre Zertifikat bereit'.
Sie müssen das zweite Zertifikat in der Liste löschen und nur das erste Zertifikat belassen, das das primäre Zertifikat ist. Verwenden Sie den Link Löschen neben dem zweiten Zertifikat, um es zu entfernen. Wenn Sie das Zertifikat nicht entfernen, können Sie die Einstellungen nicht speichern.
- Im Feld Benutzerdefinierte Beschriftung des Login-Buttons können Sie einen beliebigen Text anstelle des Standardtexts eingeben (Single Sign-On). Dieser Text wird auf der Schaltfläche angezeigt, mit der Sie sich mit dem Single Sign-On-Dienst auf der ONLYOFFICE-Authentifizierungsseite beim Portal anmelden.
- Jetzt müssen Sie selbstsignierte Zertifikate erstellen oder andere Zertifikate im Abschnitt SP-Zertifikate hinzufügen.
Wichtig!Wählen Sie in der Liste Nutzen Sie für die Option zum Signieren und Verschlüsseln aus, da Ihr Shibboleth-IdP automatisch mit dem install.sh-Skript konfiguriert wird, um zu überprüfen, ob die Daten digital signiert und verschlüsselt sind.
Sie sollten fast das gleiche Ergebnis erhalten:
- Legen Sie im Abschnitt Attributzuordnung die Übereinstimmung der Felder im Modul ONLYOFFICE Personen mit den Benutzerattributen fest, die vom Shibboleth-IdP zurückgegeben werden.
First Name |
urn:oid:2.5.4.42 |
Last Name |
urn:oid:2.5.4.4 |
Email |
urn:oid:0.9.2342.19200300.100.1.3 |
Location |
urn:oid:2.5.4.7 |
Title |
urn:oid:2.5.4.12 |
Phone |
urn:oid:0.9.2342.19200300.100.1.41 |
Im Abschnitt Erweiterte Einstellungen können Sie die Option Authentifizierungsseite ausblenden aktivieren, um die Standardauthentifizierungsseite auszublenden und automatisch zum SSO-Dienst weiterzuleiten.
- Klicken Sie auf die Schaltfläche Speichern.
- Der Abschnitt ONLYOFFICE SP-Metadata sollte geöffnet werden.
- Überprüfen Sie, ob unsere Einstellungen öffentlich verfügbar sind, indem Sie auf die Schaltfläche Laden Sie SP Metadaten XML herunter klicken. Der Inhalt der XML-Datei sollte angezeigt werden.
Diese XML-Datei wird normalerweise verwendet, um Shibboleth IDP zu konfigurieren, aber da das install.sh-Skript DynamicHTTPMetadataProvider
aktiviert, müssen wir dies nicht tun (Shibboleth IDP lädt diese XML-Datei bei der ersten Anfrage für die Anmeldung herunter).
Überprüfung der Arbeit des ONLYOFFICE SP mit dem Shibboleth IdP
Das Skript install.sh erstellt 4 Benutzer, die zum Testen der Arbeit des ONLYOFFICE SP mit dem Shibboleth IdP verwendet werden können.
E-Mail |
Nutzername |
Kennwort |
Kommentar |
student1@{your_idp_domain} |
student1 |
password |
Standard |
student2@{your_idp_domain} |
student2 |
password |
Without givenName |
student3@{your_idp_domain} |
student3 |
password |
With umlauts |
staff1@{your_idp_domain} |
staff1 |
password |
Obligatory fields only |
Bei ONLYOFFICE auf der SP-Seite anmelden
- Öffnen Sie die ONLYOFFICE-Authentifizierungsseite auf (z.B., https://myportal-address.com/Auth.aspx).
- Klicken Sie auf die Schaltfläche Single Sign-On (die Beschriftung kann abweichen, wenn Sie bei der Konfiguration von ONLYOFFICE SP einen eigenen Text angegeben haben). Wenn die Schaltfläche fehlt, bedeutet dies, dass SSO nicht aktiviert ist.
- Wenn alle SP- und IdP-Parameter richtig eingestellt sind, werden wir zum Shibboleth IdP-Anmeldeformular weitergeleitet:
- Geben Sie den Benutzernamen und das Kennwort des Shibboleth IdP-Kontos ein (Benutzername: student1, Kennwort: password) und aktivieren Sie das Kästchen Don't Remember Login (Nicht an die Anmeldung erinnern).
- Wenn die Anmeldeinformationen korrekt sind, wird ein neues Fenster geöffnet. Erlauben Sie die Bereitstellung von Informationen für den Dienst, indem Sie auf die Schaltfläche Accept (Annehmen) klicken.
- Wenn alles korrekt ist, werden wir auf die Hauptseite des Portals weitergeleitet (der Benutzer wird automatisch angelegt, wenn er fehlt, oder die Daten werden aktualisiert, wenn er im IDP geändert wird).
Profile für Benutzer, die mit SSO-Authentifizierung hinzugefügt wurden
Die Möglichkeit, mit der SSO-Authentifizierung erstellte Benutzerprofile zu bearbeiten, ist eingeschränkt. Die vom IdP erhaltenen Benutzerprofilfelder sind zur Bearbeitung deaktiviert (d.h. First Name
(Vorname), Last Name
(Nachname), Email
(E-Mail), Title
(Titel) und Location
(Standort)). Sie können diese Felder nur von Ihrem IdP-Konto aus bearbeiten.
Die folgende Abbildung zeigt das Aktionsmenü für einen SSO-Benutzer:
Die folgende Abbildung zeigt ein zur Bearbeitung geöffnetes SSO-Benutzerprofil:
Die mit der SSO-Authentifizierung erstellten Benutzer sind in der Benutzerliste für die Portaladministratoren mit dem SSO-Symbol gekennzeichnet:
Um sich vom Shibboleth-IdP abzumelden (wenn Sie beim Anmelden das Kästchen Don't Remember Login (Nicht an die Anmeldung erinnern) nicht aktiviert haben), gehen Sie zu dem Link, der so aussieht: https://{shibboleth-idp-domain}/idp/profile/Logout