topfact6 Systemvoraussetzungen - Kundennetzwerk & Firewall topfact Cloud

Technische Dokumentation>technische Checklisten und Vorgangsbeschreibungen>topfact6 Systemvoraussetzungen und Systemarchitektur>topfact6 Systemvoraussetzungen - Kundennetzwerk & Firewall topfact Cloud
Produkt: topfact6 MyWork
Erstellt am 02.12.2020 12:13, letzte Aktualisierung am 13.02.2024 15:25.
SystemvoraussetzungenCloud

Folgende Systemvoraussetzungen sind für den Betrieb der topfact6 MyWork Cloud nötig.

Diese müssen vor Systemeinrichtung an den Kunden & seine IT Betreuer als Aufgabenpakete übergeben werden.


topfact6 Clientanwendungen

  • Windows 10/11
  • mindestens .NET Framework v4.6.2
  • Lizenzierung als named User - jedem MyWork User muss eine Lizenz namentlich zugeordnet sein


Server für Transfer Service

Als Brückenkopf um aus dem Kundennetzwerk ERP Daten und Dateien ins topfact Archiv hochladen zu können muss der Windows-Dienst "topfactCloud Transfer Service" auf einem dedizierten Server installiert und konfiguriert werden.

Während der Projektphase benötigt die topfact AG Zugriff auf diesen Server um die Installation und Konfiguration des Dienstes durchführen zu können.

Der Kunde und der zuständige IT Betreuuer müssen entscheiden welcher Server hier geeignet ist.


Netzwerk des Kunden

Was muss am Netzwerk des Kunden konfiguriert / geprüft werden?

1. Schreibrechte auf Abhol-Ordner

  • Scan-Abholordner
  • ERP-Abholordner


Da der topfact Cloud Transfer Service aus den Abholordnern des Scanners oder den Abhlordner des ERP Systems die Dateien nach der Übertragung löscht muss der Nutzer bei dem das Cloud Tool läuft schreibende Rechte auf dieses Verzeichnis haben.

Konsequenz: Sonst kann es passieren, dass Dokumente zwar übertragen und archiviert werden - diese aber beim nächsten Durchlauf nicht gelöscht wurden, weiterhin bereitstehen und somit erneut übertragen und mehrfach archiviert werden.


Firewall des Kunden

Was muss an der Netzwerk-Firewall konfiguriert werden?


1. Ausgehende Verbindung zum SQL Server via Port 1433 

  • Es muss die ausgehende Verbindung auf den Port 1433 auf unseren SQL Server db.topfactcloud.de erlaubt werden

2. Ausgehende Verbindung zum Archiv via SSL/TLS Zertifizierung

  • Es muss die ausgehende Verbindung auf https://app.topfactcloud.de erlaubt werden. Hier muss insbesondere das SSL Zertifikat von der korrekten Validierungstelle (DST Root CA X3) überprüft werden können (siehe Screenshots)
  • Das Zertifkat von Serverseite wird aktuell gehalten.
  • Es darf keine Proxy-Validierungstelle von der Firewall vorgeschaltet werden



Probleme entstehen, wenn die Firewall die Validierungstelle durch einen Proxy "überschreibt". siehe Screenshot



Einzelarbeitsplätze PCs

Was muss an den Einzelarbeitsplätzen konfiguriert / geprüft werden?

  • Der topfact MyWork Cloud Client muss installiert werden
  • Die neueste Version kann von der topfact AG oder direkt aus dem TIC Portal heruntergeladen werden


FAQ, Fehler & Fehlermeldungen 

Welche Situationen könnten auftreten und wie können wir sie lösen?

Logs auf den PCs der Clients finden Sie unter %programdata%/topfact AG/Logs/MyWork...


Nutzer kann sich nicht in MyWork anmelden

Problem: Es erscheint ein Fehler "Nutzername & Passwort prüfen", jedoch sind Nutzername und Passwort korrekt.

Ursache: Die Netzwerk Firewall blockiert den Zugriff auf unseren SQL Server (zum Login genutzt)

Lösung: Netzwerk-Firewall muss den Port 1433 auf unseren SQL Server (db.topfactcloud.de) freigegeben werden

Ziel: Nutzer kann sich bei MyWork anmelden und die Anwendung startet


Nutzer sieht kein Archiv nach der Anmeldung

Problem: Es erscheinen Fehlermeldungen bei den Dokumentenstrukturen, ein Archivsymbol ist nicht sichtbar

Ursache1: Der Nutzer bzw. Gruppe ist nicht das passende Archiv-Profil zugeordnet um Lese/Schreibzugriff auf das Archiv zu bekommen

Ursache2: Die Netzwerk Firewall blockiert den Zugriff auf unseren Archiv-Endpunkt (topfactcloud.de) wegen einem Zertifikatsfehler. 

Prüfen: Im Browser auf dem Benutzer-PC folgendes in die Adresszeile kopieren (wenn ein Zertifikatsfehler kommt, ist das die Ursache): https://app.topfactcloud.de/tfa/documentservice.asmx

Prüfen: Ein Indikator ist, wenn in MyWork die Liste der Dialoge unter "MyWork > Datei > Systeminformationen > Dialoge" leer ist. 

Lösung: Die Netzwerk Firewall muss Zugriff auf https://app.topfactcloud.de mit der Zertifikatsausstellungstelle DST Root CA X3 erlauben.

Ziel: Der Nutzer kann in MyWork das Archiv sehen, suchen, Dokumente anzeigen und ohne Fehlermeldung die Dokumentenstrukturen öffnen