Browser- und Arbeitsplatzanforderungen

Claira läuft im Browser innerhalb von Nuix Discover. Auf dem Arbeitsplatzrechner ist nichts zu installieren — kein Desktop-Agent, kein Plug-in, keine Browser-Erweiterung. Diese Seite richtet sich an das IT- oder Client-Engineering-Team, das Claira auf verwalteten Rechnern zum Laufen bringen muss, sowie an den Claira-Administrator, der diesem Team mitteilen muss, was freigegeben werden soll.

Wird Ihre Discover-Umgebung von Nuix gehostet, sind die ersten beiden Abschnitte die vollständige Anforderung. Läuft Discover auf Ihrer eigenen Infrastruktur, lesen Sie zusätzlich den Abschnitt zum lokalen Betrieb.

Unterstützte Browser

Verwenden Sie die aktuelle stabile Version von einem der folgenden Browser:

• Google Chrome
• Microsoft Edge (Chromium)

Halten Sie die Arbeitsplatzrechner auf dem stabilen Update-Kanal des Herstellers. Claira ist eine Webanwendung und wird gegen aktuelle stabile Browser getestet.

Claira funktioniert derzeit auch in Mozilla Firefox.

Netzwerkzugriff

Claira benötigt eine einzige ausgehende Regel:

• HTTPS über TCP 443 zu *.claira.to

Erlaubt Ihre Ausgangsrichtlinie keine Platzhalter-Ziele, geben Sie mindestens den regionalen Host frei, den Ihre Umgebung verwendet — etwa https://nuix-ca.claira.to für die kanadische oder https://nuix-au.claira.to für die australische Bereitstellung. Das ist dieselbe Adresse, die ein Portal-Administrator beim Einrichten der UI-Erweiterung eingetragen hat.

Mehr ist nicht erforderlich: keine eingehenden Regeln, keine zusätzlichen Ports und keine Änderungen an der Software des Arbeitsplatzrechners.

Wenn Discover von Nuix gehostet wird

Es ist nichts Besonderes erforderlich. Sowohl Claira als auch Ihre Discover-Portal-API sind öffentliche Adressen; der Browser behandelt den Verkehr zwischen ihnen daher als gewöhnliche Anfragen von öffentlich zu öffentlich.

Keine der nachfolgenden Überlegungen zum lokalen Betrieb betrifft Sie. Chrome oder Edge in der aktuellen stabilen Version plus die oben genannte ausgehende Regel sind die vollständige Anforderung.

Wenn Discover lokal betrieben wird

Claira ist eine UI-Erweiterung: Sie wird innerhalb der Discover-Seite geladen und ruft direkt aus dem Browser der sichtenden Person Ihre Discover-Portal-API auf, um Dokumenttext und Originaldateien abzurufen. Dieser Aufruf geht vom Arbeitsplatzrechner an Ihre eigenen Server und muss deshalb auf zwei getrennten Ebenen zugelassen werden.

Zwei Bedingungen müssen erfüllt sein.

1. Ihre Portal-API muss den Claira-Ursprung zulassen (CORS)

Da die Anfrage von einer durch Claira ausgelieferten Seite stammt und auf einen Host in Ihrer Umgebung zielt, behandelt der Browser sie als ursprungsübergreifend und verlangt, dass die Web-Ebene Ihrer Portal-API die Anfrage ausdrücklich erlaubt.

Sowohl bei der Preflight-Anfrage OPTIONS als auch beim anschließenden POST muss die Portal-API zurückgeben:

Access-Control-Allow-Origin: <der Claira-Ursprung>
Access-Control-Allow-Headers: Authorization, Content-Type
Access-Control-Allow-Methods: POST, OPTIONS

Die OPTIONS-Anfrage muss einen 2xx-Status zurückgeben. Der Claira-Ursprung ist die für Ihre UI-Erweiterung konfigurierte Adresse, etwa https://nuix-ca.claira.to.

2. Der Browser muss die Anfrage in Ihr internes Netzwerk zulassen

Dies ist eine neuere Beschränkung in Chromium-Browsern namens Local Network Access (Zugriff auf das lokale Netzwerk) und ist von CORS unabhängig. Sie greift, wenn eine von einer öffentlichen Adresse ausgelieferte Seite versucht, eine private oder interne Adresse zu erreichen.

Genau das ist die Form eines lokalen Betriebs: Claira wird von einer öffentlichen Adresse ausgeliefert, während Ihre Discover-Portal-API auf eine Adresse innerhalb Ihres Netzwerks auflöst. Chrome und Edge blockieren diese Anfrage, noch bevor Ihre Portal-API sie überhaupt sieht.

Der Konsolenfehler lautet üblicherweise:

has been blocked by CORS policy: Permission was denied for this document to access the local address space

Firefox erzwingt Local Network Access noch nicht. „Es funktioniert in Firefox, scheitert aber in Chrome und Edge“ ist das Erkennungsmerkmal genau dieser Beschränkung — es ist kein Fehler in Claira und keiner in Ihrer Portal-API-Konfiguration.

Die folgenden Abhilfen sind nach Präferenz geordnet.

Empfohlen: Claira über einen internen Hostnamen ausliefern

Stellen Sie Claira einen internen Reverse-Proxy voran — einen internen Hostnamen, der über 443 an Ihren regionalen Claira-Host weiterleitet. Der Browser sieht Claira dann auf einer Adresse im privaten Netzwerk, sodass der Übergang von öffentlich zu privat gar nicht erst stattfindet. Anfragen von einer lokalen Adresse an eine andere lokale Adresse sind nicht beschränkt.

Das ist die beständigste Option:

• Auf keinem Arbeitsplatzrechner ist eine Browser-Richtlinie nötig.
• Sie übersteht Browser-Updates und künftige Änderungen an der Beschränkung.
• Es ist eine Änderung in Ihrer Infrastruktur statt einer flottenweiten Richtlinienverteilung.

Nuix bitten, die Berechtigung an den Erweiterungsrahmen zu delegieren

Das ist die architektonisch richtige Lösung. Die einbettende Discover-Seite muss dem geladenen Rahmen der UI-Erweiterung die Berechtigung erteilen, und zwar über allow="local-network-access" an diesem Rahmen.

Nur Nuix kann diese Änderung vornehmen, da die einbettende Seite Nuix gehört. Es lohnt sich, dies anzusprechen: Dieselbe Änderung nützt jedem lokal betriebenen Discover-Kunden mit jeder beliebigen UI-Erweiterung, nicht nur Claira.

Browser-Richtlinie als letztes Mittel

Chrome und Edge bieten beide Gruppenrichtlinien-Einstellungen dafür, verteilbar per Gruppenrichtlinie oder Microsoft Intune. Diese Option funktioniert, ist von den dreien aber am leichtesten falsch umzusetzen.

Zwei Richtlinien sind gemeinsam erforderlich:

Die zweite Richtlinie erwartet den Discover-Host — die Adresse in der Adressleiste des Browsers — und nicht den Claira-Host.

Prüfen Sie die Mindestversionen der Browser gegen das, was tatsächlich auf Ihrer Flotte ausgerollt ist, bevor Sie sich darauf verlassen. Microsoft dokumentiert die Richtlinie zur Rahmen-Delegation als verfügbar ab Edge 146 Stable.

Vorübergehende Deaktivierung, nur zum Testen

LocalNetworkAccessRestrictionsTemporaryOptOut schaltet die Beschränkung ab und eignet sich, um eine Diagnose schnell zu bestätigen.

Weiterführende Dokumentation

• Claira einrichten — die Installation der UI-Erweiterung auf Portalebene, einschließlich der Claira-App-URL.
• Installation prüfen — bestätigen, dass Claira in einem Fall aktiv ist.
• Datenschutz und Sicherheit — Bereitstellungsregionen und Datenverarbeitung.
• Microsoft: Local Network Access in Microsoft Edge.
• MDN: Local network access.

Brauchen Sie Hilfe? Schreiben Sie uns an support@claira.to.