+49 (30) 467086-20 service@microtool.de
Produkte » objectiF RPM » Collaboration » Collaboration einrichten

Ab Version 7.0 möglich

Collaboration einrichten

Ab der Version 7.0 können Sie die Funktionen der Collaboration nutzen, die es Ihnen erlaubt Live-Chats und Videokonferenzen direkt in objectiF RPM durchzuführen. Um diese Funktionen optimal nutzen zu können, benötigen Sie ein gültiges Zertifikat und Sie müssen SignalR und Node.js für den Web-Service einrichten.

Zertifikate

Haben Sie den objectiF RPM Server und den Client bzw. Web Service (Web-Client) auf einem Rechner installiert, benötigen Sie ein gültiges Zertifikat, das nicht selbstsigniert ist.

Wenn objectiF RPM Server und der Client bzw. Web-Service (Web-Client) auf unterschiedlichen Rechnern installiert sind, brauchen Sie ein zusätzliches Zertifikat, das ebenfalls nicht selbstsigniert ist. Für diesen Fall wird empfohlen, SignalR und Node.js dort einzurichten, wo der Web-Service installiert ist.

Selbstsignierte Zertifikate

Es wird empfohlen keine selbstsignierten Zertifikate zu verwenden, da sie als nicht-vertrauenswürdig eingestuft werden. Zu Testzwecken können Sie selbstsignierte Zertifikate verwenden.

Wenn Sie selbst-signierte Zertifikate verwenden möchten, installieren Sie es auf (je)dem Rechner, auf dem der objectiF RPM Client/ Web-Client installiert ist. Der Ort des Zertifikatsspeichers ist LocalMachine. Installieren Sie das Zertifikat unter Vertrauenswürdige Zertifikate.

    Hinweis
    Beachten Sie, dass aktuelle Browserversionen aus Sicherheitsgründen selbstsignierte Zertifikate, die im IIS erstellt wurden, nicht mehr akzeptieren. Alternativ können Sie Open SSL verwenden, um ein selbstsignierte Zertifikat zu erstellen.

    Zertifikat einspielen

    Haben Sie ein gültiges Zertifikat, müssen Sie es noch im Internetinformationsdienste (IIS) hinterlegen.

    1. Öffnen Sie den IIS-Manager.
    2. Markieren Sie den Rechner (oberster Eintrag) auf der linken Seite und öffnen die Serverzertifikate per Doppelklick.
    Mausklick auf Serverzertifikate im IIS Manager
    1. Wählen Sie auf der rechten Seite Importieren.
    unter Aktionen Mausklick auf Importieren
    1. Per Klick auf die […] wählen Sie das Zertifikat aus, geben ein konfiguriertes Passwort an und wählen als Zertifikatsspeicher Webhosting aus.
    2. Bestätigen Sie mit OK.
    Beispiel einer Zertifikatszuweisung
    1. Wählen Sie nun im IIS die WebSite aus und öffnen dessen Konfiguration, indem Sie auf Bindungen klicken.
    2. Im Folgedialog klicken Sie auf Hinzufügen.
    3. Über das Dropdown geben Sie unter Typ https an und tragen einen freien Port ein.
    Hinweis
    Vor allem, wenn Videokonferenzen über den Web-Client stattfinden sollen, ist es notwendig, dass https eingestellt ist. Ist das nicht der Fall, kann der Browser nicht auf die Eingabemedien (Kamera und Mikrofon) zugreifen.
    1. Unter SSL-Zertifikat wählen Sie das importierte Zertifikat aus.
    Hinzufügen einer neuen Bindung und Zuweisung eines Zertifikats
    1. Starten Sie im Anschluss den Web Service, indem Sie rechts unter Website verwalten auf Starten klicken.

    SignalR einrichten

    Mit der Konfiguration des SignalR-Servers werden Chat-Nachrichten und Einladungen zu Videokonferenzen sofort übertragen.

    1. Öffnen Sie den Service-Manager eines Web Services und gehen in die Konfiguration des Services, für den Sie die Collaboration konfigurieren möchten.
    in der Serviceadresse Mausklick auf den Stift
    1. Wechseln Sie in die Registerkarte SignalR und markieren dort die Option SignalR.
      Das Feld SignalR-Adresse wird freigeschaltet.
    2. Geben Sie im Feld SignalR-Adresse hinter dem Hostnamen nach einem Doppelpunkt einen beliebigen freien Port an.
    im Feld SignalR-Adresse Angabe des Ports farblich hervorgehoben
    1. Markieren Sie das Kontrollkästchen HTTPS benutzen, wenn Sie die Collaboration-Funktionen auch im Web-Client nutzen möchten.
    2. Geben Sie unter Thumbprint des Zertifikats den Wert des Thumbprints (Zertifikat für den SignalRServer) an.
    Hinweis
    Wenn der Web-Service (Web-Client) und der Applikationsserver (objectiF RPM Server) auf unterschiedlichen Rechnern installiert sind, geben Sie unter Thumbprint des Zertifikats den Thumbprint des Zertifikats an, der für den Applikationsserver gilt.
    Beispiel einer SignalR-Konfiguration
    1. Klicken Sie auf SignalR einrichten.
      Der SignalR-Server wird mit der angegebenen Konfiguration eingerichtet. Dabei wird der Port freigegeben und die Adresse reserviert. Eine Meldung gibt an, ob SignalR eingerichtet wurde.
    Erfolgsmeldung nach Klick auf Schaltfläche SignalR einrichten

    Node.js einrichten

    Wenn Sie Videokonferenzen durchführen möchten, müssen Sie Node.js einrichten. Das gilt auch, wenn Sie bereits Node.js über die Erweiterungsfunktionen installiert haben.

    1. Wechseln Sie im Service-Manager in die Registerkarte Collaboration.
    2. Klicken Sie auf die Schaltfläche Node.js einrichten.
      Warten Sie bis Sie die Meldung erhalten, dass der Collaboration-Server eingerichtet wurde.
    3. Markieren Sie die Option Collaboration-Server (Node.js).
    4. Geben Sie im Feld Adresse die Adresse an, unter der der Node.js-Server erreichbar sein soll. Sie beginnt mit https:// und danach folgt der Rechnername.
    5. Tragen Sie in das Feld Port den Port ein, unter dem der Node.js-Server erreichbar sein soll.
    Markierung der Option Collaboration-Server(Node.js) in der Registerkarte Collaboration
    1. Tragen Sie unter Zertifikat die benötigten Zertifikatseinstellungen ein:
      • StoreLocation Geben Sie hier den Ort des Zertifikatsspeichers an, in dem das Zertifikat installiert ist.
      • StoreName Geben Sie hier den Namen des Zertifikatsspeichers an, in dem sich das Zertifikat befindet.
      • FindValue Geben Sie hier den Wert des Zertifikatsattributs an, nach dem gesucht werden soll. Der Wert des Attributs richtet sich danach, welches Zertifikatsattribut Sie gewählt haben.
        Wenn Sie bereits den SignalR-Server eingerichtet haben, wird empfohlen als Wert den Thumbprint des Zertifikats zu verwenden. Kopieren Sie den Wert aus der Registerkarte SignalR.
      • x509FindType Geben Sie das Attribut des Zertifikats an, nach dem gesucht werden soll.
    Beispiel einer Node.js-Konfiguration
    1. Klicken Sie auf die Schaltfläche Konfiguration testen, um zu sehen, ob die Einstellungen korrekt sind.
    Hinweis
    Wenn Sie keinen ausreichenden Zugriff auf das Zertifikat besitzen, kann es unter Umständen zu einer Fehlermeldung kommen, so dass einige Eigenschaften nicht abgefragt werden können. In diesem Fall speichern Sie Ihre Änderungen und starten Sie den Service-Manager erneut mit Administrationsrechten. Im Anschluss können Sie den Test erneut durchführen.