Proxy-Setup mit M-Files Web verwenden

In dieser Anleitung erfahren Sie, wie Sie eine Umgebung mit einem Reverse-Proxy und einem Anwendungsserver einrichten. Diese Konfiguration enthält einen separaten Proxy-Server für IIS (Internet Information Services) und einen weiteren Server für die M-Files-Anwendung.

Anwendungsserver konfigurieren

Wenn Sie keine separaten DNS-Namen für Ihre Dokumentenverwaltungen verwenden (auf alle Dokumentenverwaltungen wird mit derselben Adresse zugegriffen), können Sie diesen Abschnitt überspringen.

Um den Server, auf dem M-Files installiert ist, zu konfigurieren, die folgenden Schritte durchführen:

  1. Diese Registry-Einstellung mit Registry-Editor hinzuzufügen:
    Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Motive\M-Files\<Version>\Server\Common
    Wertname VaultDNSConfig
    Wertetyp REG_MULTI_SZ
    Wert https://<Proxy-Server-Adresse>={<GUID der zu verwendenden Dokumentenverwaltung>}

    Beispiel: https://proxyserver.mycompany.com={F565EDFE-939E-4507-B078-D06902888C98}
    Beschreibung Fügt eine Zuordnung zwischen der Dokumentenverwaltung und dem Proxy-Server hinzu.
  2. Diesen Registry-Schlüssel hinzufügen, damit jede Dokumentenverwaltung den Standard-Webclient steuern kann:
    Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Motive\M-Files\<Version>\Server\Common
    Wertname NewWebAsDefault
    Wertetyp REG_SZ
    Wert False
    Beschreibung Das neue Web ist nicht der Standard-Client für diesen Server. Jede Dokumentenverwaltung kann den Standard-Webclient steuern.
  3. Den M-Files Server Service neu starten.
  4. Optional: M-Files Web als Standard-Client für die Dokumentenverwaltung festlegen (siehe Standard-Webclient für eine Dokumentenverwaltung ändern).
  5. Den M-Files Server-Service auf dem Proxy-Server neu starten.

Proxy-Server konfigurieren

Hinweis: Wenn Sie nur das klassische M-Files Web einrichten möchten, ist nur der erste Schritt notwendig.

So konfigurieren Sie den Server, der als Reverse-Proxy verwendet wird:

  1. Den Proxy-Server mit den Anweisungen unter Configuring the Classic M-Files Web on a Separate Server Computer einrichten.

    Bei der Einrichtung folgende Punkte beachten:

    • M-Files Server muss dieselbe Version aufweisen wie die Installation auf dem Anwendungsserver.
    • Es können keine Dokumentenverwaltungen an die M-Files Server-Installation auf dem Proxy-Server angehängt werden.
    • Wenn Sie viele Dokumentenverwaltungen mit separaten DNS-Namen verwenden, muss die IIS-Site (Internet Information Services) auf dem Proxy-Server allen Dokumentenverwaltungen öffentlich antworten. Mit anderen Worten: Die IIS-Site muss über die erforderlichen Bindungen verfügen.
  2. M-Files Admin öffnen.
  3. Stellen Sie eine Verbindung mit der M-Files Server Instanz des Proxy-Computers her.
    In den meisten Fällen werden M-Files Admin M-Files Server und auf demselben Proxy-Computer installiert. Das bedeutet, dass Sie mit M-Files Admin lokal eine Verbindung zu M-Files Server herstellen können.
    IIS muss auf demselben Proxy-Computer laufen wie die M-Files Server Instanz, mit der Sie verbunden sind.
  4. M-Files Web gemäß den Anweisungen in M-Files Web einrichten oder Webclients und M-Files Mobile einrichten konfigurieren.
    Bei der Konfiguration die folgenden Teilschritte beachten:
    1. Sicherstellen, dass die Adresse der Site, die im Web- und Mobile-Nutzung einrichten Dialogfeld angegeben ist, mit der in Schritt 1 unter Anwendungsserver konfigurieren verwendeten Adresse übereinstimmt.
      Dies ist auch die Adresse, mit der die Benutzer eine Verbindung zum M-Files Web-Client herstellen.
    2. Proxy-Server-Einrichtung verwenden aktivieren.
    3. Unter Adresse der Site-Bindung eine Site-Bindung eingeben, die der M-Files-Anwendungsserver verwenden kann, um den IIS-Proxy-Servercomputer zu erreichen.

      Es ist nicht notwendig, HTTPS oder Port 443 zu verwenden. Sie können auch HTTP und alle anderen auf dem IIS-Server verfügbaren Ports oder Bindungen verwenden. Wenn der IIS-Proxy beispielsweise ein selbstsigniertes Zertifikat für die Website-Bindung verwendet, müssen Sie HTTP verwenden, weil M-Files in diesem Zusammenhang keine selbstsignierten Zertifikate unterstützt.

      Wenn Sie viele Dokumentenverwaltungen oder viele DNS-Namen für die IIS-Sites haben, empfehlen wir, dass Sie die IP-Adresse des IIS-Servers als Adresse der Site-Bindung verwenden. Hierzu kann es erforderlich sein, eine entsprechende Bindung auf der IIS-Site zu erstellen.

      Beispiel: Die private IP des IIS-Servers lautet 10.0.0.1. Sie haben den Port 8080 daran gebunden und die Bindung nicht auf eine bestimmte IP beschränkt. http://10.0.0.1:8080 als Adresse der Site-Bindung festlegen.

    4. Unter App-Serveradresse die Serveradresse des Servers eingeben, auf dem M-Files installiert ist.
      Zum Beispiel: http://appserver.mycompany.com:7767 oder http://192.168.1.2:7767, wobei die IP-Adresse durch die tatsächliche IP-Adresse des M-Files-Server-Computers ersetzt werden kann. Für diese Verbindung immer das HTTP-Protokoll verwenden. Wenn Sie den gRPC-Webport für den M-Files-Server geändert haben, hier stattdessen den von Ihnen festgelegten Port verwenden. Weitere Informationen zu gRPC in M-Files finden Sie unter Setting Up M-Files to Use gRPC.
  5. Mithilfe von M-Files Admin eine Verbindung zu M-Files Server auf dem Anwendungsserver herstellen.
  6. Das Dialogfeld Erweiterte Eigenschaften der Dokumentenverwaltung öffnen und die M-Files Web-URL(s) gemäß den IIS-Bindungen hinzufügen.
  7. Nach 20 bis 30 Sekunden die Adresse Ihrer Proxy-Website (in diesem Beispiel https://proxyserver.mycompany.com) in einen Browser eingeben und sicherstellen, dass M-Files Web fehlerfrei geöffnet wird.