Handbuch:Erweiterung/BlueSpiceWikiFarm

PDF-Ausschluss - Start

← Erweiterung

no subpages

PDF-Ausschluss - Ende

Hinweis:Die Erweiterung BlueSpiceWikiFarm muss separat erworben werden und ist kein automatischer Bestandteil von BlueSpice pro.

Whitepaper

BlueSpice at Enterprise Scale

Technisches Briefing für den Lead Architect und das DevOps-/Operations-Team zur Evaluierung der betrieblichen Auswirkungen des Betriebs einer BlueSpice-Farm in einem Umfang von 10.000 Sub-Wikis.

PDF herunterladen

​Wiki farm ist eine Architektur für BlueSpice Wikis, mit der mehrere Wikis zentral verwaltet werden können. Wikis können erstellt, geklont, gelöscht und deaktiviert werden. Dafür wird eine Verwaltungsoberfläche zur Verfügung gestellt. Durch die Architektur wird auch die Wartung der Wikis erleichtert, da sich alle Wikis in der Farm in einem Schwung updaten lassen.

Farmverwaltung

Begriffe

• Wiki farm: Zentrale Verwaltung aller vorhandenen Wikis
• Wurzelwiki: Das Wiki, das als Verwaltungswiki für alle Wiki-Instanzen funktioniert
• Wiki-Instanz: Ein einzelnes Wiki innerhalb der Farm
• Musterwiki: Ein Wiki, das die Inhalte zur Vorbefüllung bereitstellt und durch klonen vervielfältigt werden kann

Zugriff

Die einzelnen Wiki-Instanzen werden auf der Seite Special:FarmManagement im Stammwiki verwaltet.

Diese Seite ist über das Menü „Globale Aktionen“   v5.1.2+ erreichbar.

Globale Aktionen

In der Liste aller Spezialseiten (Spezial:Spezialseiten) findet man die Farmverwaltung im Abschnitt Andere Spezialseiten.

Die Farmverwaltung zeigt eine Auflistung aller vorhanden Wiki-Instanzen mit Informationen zu:

• Name: Link zur Wiki-Instanz
• Global durchsuchbar: Durchsuchbar über alle Wiki-Instanzen.
• Erstellungsdatum
• Stichwörter (Metainformationen)
• Beschreibung (Metainformationen)

Diese Liste kann sortiert und gefiltert werden.

Funktionen

In der Verwaltungsoberfläche lässt sich ein:

• Wiki erstellen
• Wiki klonen
• Wiki bearbeiten
• Wiki abschalten (archivieren)
• Wiki löschen
• Wiki von der globalen Suche ausschließen
• Wiki mit Metainformationen (Beschreibung, Gruppe, Stichwort) versehen

Wiki erstellen

Über die Schaltfläche Wiki erstellen läßt sich eine neue Wiki-Instanz einrichten:

1. Geben Sie den Namen der neuen Wiki-Instanz an.
2. Geben Sie die gewünschten Einstellungen ein. Wenn das Wiki global durchsuchbar ist, wird es von anderen Wiki-Instanzen in der Volltextsuche berücksichtigt.
3. Wählen Sie aus, ob Sie ein Leeres Wiki erstellen möchten oder die Inhalte und Konfigurationen einer bestehenden Instanz kopieren möchten. Bei einer Kopie geben Sie den entsprechenden Pfad-Namen des zu kopierenden Wikis im Feld Quellpfad ein.
4. Klicken Sie Erstellen.

Wiki-Instanzen benötigen eine eindeutige URL, um sie im Browser aufrufbar zu machen. Der Pfad wird automatisch aus dem eingegebenen Namen generiert.

Ein Beispiel:

Die Wiki farm ist unter der URL  https://wiki.bluespice.com aufrufbar.

Beim erstellen der neuen Wiki-Instanz wurde der Websitetitel "hallo welt" gewählt. Daraus generiert sich der Pfad und damit die URL der neuen Wiki-Instanz als  https://wiki.bluespice.com/hallo-welt.

Hinweis:Websitetitel und Pfad können nachträglich nicht geändert werden.

Wiki klonen

Um ein Wiki zu klonen, muss erst ein bereits erstelltes Wiki als Quelle ausgewählt werden. Ein Klick auf den Listeneintrag aktiviert die Schaltfläche Wiki klonen.

Im Gegensatz zum Erstellen eines neuen Wikis werden beim Klonen bereits die Inhalte und Daten mitübergeben.

Folgende Inhalte und Einstellungen werden übernommen:

• Alle Seiten (auch aus den Nicht-Inhaltsnamensräumen wie MediaWiki, Vorlage, Formular, Attribut, usw.)
• Alle hochgeladenen Dateien
• Konfigurationseinstellungen über die Wiki-Spezialseiten (z.B. Benutzer, Benutzergruppen, Rechteverwaltung)

Folgende Einstellungen werden nicht übernommen:

• Benutzereinstellungen (z.B. Benachrichtigungseinstellungen)

Wiki löschen

So löschen Sie eine Wiki-Instanz:

1. Wählen Sie das Wiki aus der Liste.
2. Klicken Sie auf Wiki löschen. Es öffnet sich der entsprechende Dialog. Darin wird lediglich der Pfad des Wiki abgefragt. Dieser entspricht dem Namen der Wiki-Instanz, so wie er in der Farmverwaltung gelistet ist.
3. Geben Sie den Wiki-Namen in genauer Schreibweise (Trennzeichen, Groß- und Kleinschreibung) in das Feld ein.
4. Klicken Sie Löschen. Das Wiki wird komplett gelöscht.

Wiki abschalten (archivieren)

Wenn Sie ein Wiki nicht direkt löschen, sondern die Inhalte vorsichtshalber noch aufbewahren möchten, können Sie dieses auch abschalten und damit archivieren. Das Abschalten bewirkt, dass das Wiki nicht mehr zugänglich ist. Bei dem Versuch, dieses über die URL aufzurufen erfolgt eine Umleitung auf die Farmverwaltung.

Abgeschaltene Wiki-Instanzen bleiben in der Liste der Farmverwaltung, werden aber durchgestrichen dargestellt und der Websitetitel linkt nicht mehr auf die Instanz. Ein abgeschaltetes Wiki kann nachträglich wieder angeschaltet werden.

Metainformationen erstellen

Den einzelnen Wikis können über die Schaltfläche Wiki Metainformationen bearbeiten zusätzliche Metadaten zugeordnet werden. Folgende Meta-Informationen sind möglich:

• Beschreibung
• Gruppe
• Stichwörter

Sind in Gruppe und Stichwörter bereits von anderen Wikis Informationen vorhanden, werden diese auch in einem Dropdown-Menü zur Auswahl angeboten.

Die Beschreibung und die Stichwörter werden in der Liste der Farmverwaltung als Information hinterlegt. Dadurch werden diese auch filterbar und sortierbar. Bei der Gruppe verhält es sich anders, denn diese bewirkt eben eine Gruppierung der Wikis in der Liste. Die Gruppen können ein- und ausgeklappt werden.

Gruppen und Stichwörter anlegen

Gruppen und Stichwörter werden direkt im Dialogfenster für Metainformationen angelegt.

• Gruppe: Wenn Sie für eine Wiki-Instanz eine neue Gruppe brauchen, tippen Sie den Gruppennamen einfach im Textfeld ein und klicken anschließend Fertig.
• Stichwort: Wenn Sie ein neues Stichwort anlegen wollen, tippen Sie das Stichwort im Textfeld ein und schließen Sie das Stichwort mit einem Komma ab.

Zulässige Namen und Pfadangaben

Beim Erstellen und Klonen eines Wikis können Leerzeichen oder Umlaute bei der Eingabe des Websitetitels verwendet werden. Leerzeichen werden im Pfad automatisch zu Bindestrichen und Umlaute entsprechend umgewandelt, z.B. "ü" zu "ue". Auch Groß- und Kleinschreibung ist möglich und wird berücksichtigt.

Beim Löschen einer Wiki-Instanz muss die Eingabe genau mit der Pfadangabe übereinstimmen, damit das Wiki gelöscht werden kann.

Logs

Alle Aktionen werden in einem Logfile (Wiki farm management) auf Spezial:Logs hinterlegt, sodass sie jederzeit nachvollziehbar sind.

Authentifizierung

Neben der Standard-Authentifizierung direkt im Wiki ist auch ein Comfort-Sign-on möglich. Hierbei gibt es Unterschiede zwischen einer On-Premise Installation und der Cloud. Als IdP (Identity-Provider können SAML (Security Assertion Markup Language) oder OIDC (OpenID Connect ) genutzt werden.

SAML

Bei SAML gibt es eine zentrale Vertrauensbeziehung zwischen der Farm als Ganzes und dem IdP – nicht pro Einzelwiki:

• Die Farm selbst tritt als ein Service Provider auf, erreichbar über einen gemeinsamen Endpunkt (/sp/). Dieser SP tauscht mit dem IdP Metadaten aus (Zertifikate, Endpunkt-URLs) und baut darüber die Vertrauensbeziehung ("Trust") auf.
• Die einzelnen Wikis (/wiki1/, /wiki2/, /wiki3/) hängen sich an diesen einen Service Provider an – sie haben keine eigene SAML-Konfiguration und keine eigene Trust-Beziehung zum IdP.
• Praktisch bedeutet das: eine SAML-Konfiguration in simplesamlphp (bzw. in der zentralen Farm-Config) reicht für alle Wikis der Farm aus. Ein zweiter IdP (im Schema "IdP2, nicht in Cloud") lässt sich zwar technisch anbinden, ist aber als Sonderfall zu betrachten und nur On-Premise realisierbar. SAML ist grundsätzlich eher auf einen IdP pro Farm ausgelegt.

OIDC

Bei OIDC verhält sich das anders: Hier registriert sich jedes Wiki einzeln als eigener OAuth/OIDC-Client beim IdP:

• Wiki 1, Wiki 2 und Wiki 3 haben jeweils eine eigene Trust-Beziehung und typischerweise eine eigene Client-Konfiguration (Client-ID/Secret, Redirect-URI) beim IdP – im Schema als "jeweils eigene Config" markiert.
• Es lassen sich auch mehrere IdPs parallel anbinden (im Schema IdP1 für Wiki 1–3, IdP2 zusätzlich für Wiki 3).
• Konsequenz: Es gibt zwei Anmelde-Buttons, wenn zwei IdPs an einem Wiki hängen, und kein automatisches Single-Sign-On über die ganze Farm hinweg. Benutzer müssen sich pro Wiki (bzw. pro IdP) aktiv für einen Login-Button entscheiden, es sei denn, eine Session besteht bereits.
• Eine gemeinsame ("Shared") Konfiguration ist bei OIDC nur möglich, wenn der IdP Wildcarding bei der Redirect-URL unterstützt (d. h. er akzeptiert eine Muster-URL wie https://*.wiki.example.com/callback statt für jedes Wiki einzeln eine exakte Redirect-URI hinterlegen zu müssen). Unterstützt der IdP das nicht, braucht jedes Wiki eine eigene, manuell im IdP hinterlegte Redirect-URI.

SAML vs. OIDC

Kriterium	SAML	OIDC
Trust-Modell	Zentral: ein SP für die gesamte Farm, ein Trust zum IdP	Dezentral: eigene Client-Registrierung pro Wiki-Instanz
Mehrere IdPs gleichzeitig	Unüblich / zusätzlicher Aufwand (Zweit-IdP nur eingeschränkt vorgesehen); nicht möglich in Cloud	Gut unterstützt, auch je Wiki unterschiedliche IdPs möglich
Shared Config über alle Wikis	Einfach möglich, da zentrale server-seitige Konfiguration	Nur möglich, wenn IdP Wildcarding der Redirect-URL unterstützt
Aufwand bei neuer Wiki-Instanz	Kein zusätzlicher IdP-seitiger Aufwand – neues Wiki nutzt den bestehenden Farm-SP/Trust mit	IdP muss die neue Instanz explizit akzeptieren (Issuer-/Client-Konfiguration auf IdP-Seite) – außer bei Wildcarding der Redirect-URL
Login-Erlebnis	Einheitlicher Login über die ganze Farm (ein Trust genügt)	Ggf. mehrere Anmelde-Buttons, kein automatisches Farm-weites Single-Login
Administrationsaufwand bei vielen Wikis	Gering (zentral)	Steigt mit Anzahl Wikis/IdPs (individuelle Konfiguration)
Typischer Einsatzbereich	Ein Unternehmens-IdP, klassisches Enterprise-SSO	Cloud-IdPs (z. B. Azure AD, Okta), heterogene IdP-Landschaft

Vergleich von Comfort Sign-On Optionen On-Premise vs. Cloud

Anmeldungsart	On-Premise	Cloud
SAML	mehrere Identity-Provider möglich	nur 1 Identity-Provider für alle Instanzen
OpenID Connect	unterschiedliche ID-Provider nutzbar (zentral konfigurierbar)	unterschiedliche ID-Provider nutzbar (muss in jeder Instanz separat konfiguriert werden)
Benutzersession	geteilte Benutzersession möglich	keine geteilte Benutzersession, separate Anmeldung in Instanzen erforderlich

Weiterführende Links

• Inhalte zwischen Wiki-Instanzen transferieren

Technische Referenz: BlueSpiceWikiFarm

Automatisch generierter Inhalt, der Übersichten oder verschiedene Möglichkeiten für die Verwaltung und Pflege des Systems bietet. Zudem gibt es auch Spezialseiten mit Funktionen und Informationen für Benutzer.

Ein Uniform Resource Locator (Abk. URL; englisch für „einheitlicher Ressourcenverorter“) identifiziert und lokalisiert eine Ressource, beispielsweise eine Webseite, über die zu verwendende Zugriffsmethode (zum Beispiel das verwendete Netzwerkprotokoll wie HTTP oder FTP) und den Ort (englisch location) der Ressource in Computernetzwerken.

Protokoll zur Verschlüsselung und Authentifizierung der Kommunikation zwischen Webserver und Browser im World Wide Web.