Teil 13: Multi-Tenant-Suchplattform

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.

Mandantenkonfiguration
Mandant Domain Suchziel
Unternehmen A (Fertigung) search-a.example.com Produktspezifikationen, Qualitätsmanagement-Dokumente
Unternehmen B (Einzelhandel) search-b.example.com Filialhandbücher, Produktinformationen
Unternehmen C (Dienstleistung) search-c.example.com Kundenservice-Handbücher, FAQ

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.

search-a.example.com → Fess-Server (192.168.1.100)
search-b.example.com → Fess-Server (192.168.1.100)
search-c.example.com → Fess-Server (192.168.1.100)

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 A

  • tenant-b: Dokumente von Unternehmen B

  • tenant-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.

Crawl-Einstellungen nach Mandant
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.

Zugriffstoken-Konfiguration
Mandant Tokenname Zugewiesene Rolle
Unternehmen A tenant-a-api-token tenant-a-role
Unternehmen B tenant-b-api-token tenant-b-role
Unternehmen C tenant-c-api-token tenant-c-role

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.

  1. Label erstellen

  2. Rolle erstellen

  3. Crawl-Einstellungen registrieren

  4. Virtual Host konfigurieren

  5. Zugriffstoken ausstellen

  6. 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.

Referenzen