Einführung
Wenn Sie Fess mehreren internen Abteilungen oder als MSP (Managed Service Provider) mehreren Kunden bereitstellen möchten, ist es ineffizient, für jeden Mandanten eine eigene Fess-Instanz aufzubauen.
In diesem Artikel wird ein Multi-Tenant-Design erläutert, das mit einer einzigen Fess-Instanz mehrere Mandanten (Organisationen, Abteilungen oder Kunden) bedient.
Zielgruppe
Personen, die Suchdienste für mehrere Organisationen oder Abteilungen bereitstellen möchten
Personen, die sich für Multi-Tenant-Design mit Fess interessieren
Personen, die erfahren möchten, wie die Virtual-Host-Funktion genutzt wird
Szenario
Wir gehen von einem Szenario aus, in dem die IT-Abteilung eines Konzerns Suchdienste für drei Tochtergesellschaften bereitstellt.
Jeder Mandant hat die folgenden Anforderungen:
Daten dürfen zwischen Mandanten nicht sichtbar sein (Datenisolation)
Jeder Mandant benötigt ein eigenes Design (Branding)
Jeder Mandant benötigt unabhängige Crawl-Einstellungen
Virtual-Host-Funktion
Mit der Virtual-Host-Funktion von Fess können Sie je nach Hostname, über den zugegriffen wird, unterschiedliche Sucherlebnisse bereitstellen.
Virtual-Host-Konfiguration
Legen Sie den Virtual-Host-Wert in der Administrationsoberfläche fest. Indem Sie diesen Wert mit Crawl-Einstellungen und Labels verknüpfen, können Sie die Datenisolation für jeden Mandanten realisieren.
Designüberlegungen
DNS- / Load-Balancer-Konfiguration
Konfigurieren Sie DNS so, dass die Domain jedes Mandanten auf denselben Fess-Server verweist.
Fess untersucht die HTTP-Header der Anfrage, um festzustellen, auf welchen Virtual Host zugegriffen wird. Standardmäßig wird der Host-Header verwendet. Sie können jedoch mit der Einstellung virtual.host.headers einen beliebigen Header angeben. Das Konfigurationsformat ist Headername:Wert=VirtualHostKey (z. B. Host:search-a.example.com=tenant-a).
Mandantenisolation
Datenisolation
Die Datenisolation zwischen Mandanten wird über das Feld virtual_host der Dokumente realisiert, das durch die Virtual-Host-Funktion bereitgestellt wird.
Isolation über Virtual Host
Wenn Sie den Virtual-Host-Schlüssel im Feld „Virtual Host“ der Crawl-Einstellungen festlegen, erhalten gecrawlte Dokumente ein virtual_host-Feld. Bei der Suche wird dieses Feld automatisch zum Filtern verwendet, sodass Benutzer, die über die Domain eines Mandanten zugreifen, nur die Dokumente dieses Mandanten in den Suchergebnissen sehen.
tenant-a: Dokumente von Unternehmen Atenant-b: Dokumente von Unternehmen Btenant-c: Dokumente von Unternehmen C
Darüber hinaus können Sie durch Festlegen des Feldes „Virtual Host“ bei Labels auch die für jeden Mandanten angezeigten Labels trennen.
Isolation über Rollen
Wenn eine strengere Isolation erforderlich ist, kombinieren Sie die rollenbasierte Suche (siehe Teil 5). Erstellen Sie Rollen für jeden Mandanten und weisen Sie diese den Crawl-Einstellungen und Benutzern zu.
Crawl-Konfiguration
Die Crawl-Konfiguration jedes Mandanten wird unabhängig verwaltet.
| Mandant | Crawl-Ziel | Zeitplan | Label |
|---|---|---|---|
| Unternehmen A | smb://fs-a/docs/ | Täglich um 1:00 | tenant-a |
| Unternehmen B | https://portal-b.example.com/ | Täglich um 2:00 | tenant-b |
| Unternehmen C | smb://fs-c/manuals/ | Täglich um 3:00 | tenant-c |
Mandantenspezifische Themes
Mit der Theme-Funktion von Fess können Sie für jeden Mandanten ein unterschiedliches Design bereitstellen.
Theme-Design
Bereiten Sie Themes vor, die zu den Markenfarben und dem Logo jedes Mandanten passen.
Unternehmen A: Ein solides Design für ein Fertigungsunternehmen (Blautöne)
Unternehmen B: Ein helles Design für den Einzelhandel (Grüntöne)
Unternehmen C: Ein freundliches Design für ein Dienstleistungsunternehmen (Orangetöne)
Verknüpfung von Virtual Hosts und Themes
Durch den Wechsel der Themes für jeden Virtual Host wird den Benutzern jedes Mandanten eine Suchoberfläche mit dem eigenen Unternehmensbranding angezeigt.
Fess bietet integrierte Themes wie simple, docsearch und codesearch sowie die Möglichkeit, benutzerdefinierte Themes zu verwenden.
API-Zugriffsisolation
API-Zugriffstoken pro Mandant
Stellen Sie für jeden Mandanten individuelle Zugriffstoken aus. Durch die Zuordnung von Rollen zu den Token wird die Mandantenisolation auch auf den API-Zugriff angewendet.
Wenn das System eines Mandanten eine API-Integration nutzt (siehe Teil 11), stellt die Verwendung mandantenspezifischer Token sicher, dass kein Zugriff auf Daten anderer Mandanten möglich ist.
Betriebliche Hinweise
Ressourcenmanagement
Da eine einzelne Fess-Instanz mehrere Mandanten bedient, ist eine sorgfältige Ressourcenzuweisung erforderlich.
Crawl-Lastverteilung: Staffeln Sie die Crawl-Zeitpläne der Mandanten, um gleichzeitige Ausführung zu vermeiden
Indexgröße: Überwachen Sie die gesamte Indexgröße aller Mandanten
Arbeitsspeicher: Passen Sie den JVM-Heap entsprechend der Anzahl der Mandanten und Dokumente an
Hinzufügen und Entfernen von Mandanten
Standardisieren Sie das Verfahren zum Hinzufügen neuer Mandanten.
Label erstellen
Rolle erstellen
Crawl-Einstellungen registrieren
Virtual Host konfigurieren
Zugriffstoken ausstellen
DNS-Einstellungen hinzufügen
Beim Entfernen eines Mandanten vergessen Sie nicht, die zugehörigen Indexdaten zu löschen.
Skalierungskriterien
Wenn Sie die folgenden Symptome beobachten, sollten Sie eine Aufteilung oder Skalierung der Fess-Instanzen in Betracht ziehen (siehe Teil 14).
Verschlechterung der Suchantwortzeiten
Crawls werden nicht innerhalb des geplanten Zeitfensters abgeschlossen
Häufige Speichermangel-Fehler
Die Anzahl der Mandanten übersteigt 10
Zusammenfassung
In diesem Artikel wurde das Multi-Tenant-Design unter Verwendung der Virtual-Host-Funktion von Fess erläutert.
Mandantenspezifischer Zugriff über Virtual Hosts
Datenisolation durch Labels und Rollen
Mandantenspezifisches Branding durch Themes
Mandantenisolation über API-Zugriffstoken
Ressourcenmanagement und Skalierungskriterien
Mit einer einzigen Fess-Instanz können Sie effizient mehrere Mandanten bedienen, die Verwaltungskosten niedrig halten und gleichzeitig die Anforderungen jedes Mandanten erfüllen.
Im nächsten Artikel werden Skalierungsstrategien für Suchsysteme behandelt.