Zum Hauptinhalt springen
Das Docusnap Enterprise Gateway besteht aus zwei Teilen: einem Windows-Dienst, der Ihre Aufträge ausführt, und einem Fenster, über das Sie diesen Dienst einrichten. Der Installer richtet beide in einem Durchgang ein.
Konfiguration, Protokoll und Diagnose stehen nach der Registrierung auch im Browser unter Scan › Gateways bereit. Beide Oberflächen greifen auf dieselbe Konfiguration zu, siehe Gateways verwalten.

​
Installer laden und ausführen

Der Installer DocusnapEnterpriseGatewaySetup.exe ist 64-bittig und installiert Dienst und Fenster gemeinsam, maschinenweit und mit Rechteanforderung. Sie finden ihn unter Scan › Gateways über die Schaltfläche Gateway herunterladen. Im Installer entscheiden Sie über den Npcap-Treiber: Er ist vorbelegt und wird für Netzwerk-Scans benötigt, lässt sich aber abwählen. Fehlende Voraussetzungen (.NET Framework 4.8, die Visual-C++-Redistributables) installiert der Installer selbständig mit. Danach läuft der Dienst Docusnap Enterprise Gateway automatisch mit Windows, und zwei Verknüpfungen mit demselben Namen – im Startmenü und auf dem Desktop – öffnen das Fenster. Das Gateway ist damit noch an keine Subscription gebunden. Lässt sich das Fenster nicht starten, meldet ein Windows-Fehlerdialog das und nennt den Pfad der Datei Configuration.log, in der die Einzelheiten stehen. Das Fenster beendet sich danach.

​
Anmelden und registrieren

Vor der Registrierung ist im Fenster nur der Tab Registrierung bedienbar; die übrigen vier Tabs sind ausgegraut und werden erst durch die Registrierung freigeschaltet.
1

Anmelden

Das Gateway öffnet die Anmeldeseite im Standardbrowser. Antwortet der Browser nicht innerhalb von 60 Sekunden, gilt die Anmeldung als gescheitert.
2

Subscription und Zuordnung wählen

Im Tab Registrierung bestimmen Sie Subscription, Organisation, Standort und Plattform. Der Anzeigename ist Pflicht und mit dem voll qualifizierten Rechnernamen vorbelegt; solange er leer ist, bleibt Registrieren gesperrt.
Die Subscription lässt sich nach der Registrierung nicht mehr ändern. Ein Wechsel verlangt Deregistrieren und Neu-Registrieren – und löscht dabei alle am Gateway gespeicherten Anmeldedaten, siehe Anmeldedaten lokal ablegen.
3

IP-Bereiche eintragen

Über IP-Bereich legen Sie die Netzbereiche fest, die dieses Gateway bedienen soll – Start-IP, End-IP und eine Beschreibung. Geprüft wird ausschließlich auf IPv4.
4

Registrieren

Registrieren meldet das Gateway an Docusnap365 an. Bei Erfolg startet der Dienst neu, und die übrigen vier Tabs werden bedienbar.
Gibt es bei der ersten Anmeldung genau eine Subscription und genau eine Organisation, registriert sich das Gateway von selbst – der Tab wird übersprungen, und der Anzeigename bleibt der Rechnername.
Der Identifikator, unter dem das Gateway in Docusnap365 geführt wird, entsteht aus Rechnername, Domänenname und einer maschinenspezifischen Kennung aus der Windows-Registrierung. Ein geklontes System liefert denselben Identifikator wie sein Original, solange diese Kennung mitkopiert wurde – relevant für Golden Images und Vorlagen virtueller Maschinen.
Nach der Registrierung erscheint das Gateway in der Browser-Übersicht, siehe Gateways verwalten.
Deregistrieren löscht alle am Gateway gespeicherten Anmeldedaten – die lokalen Dateien und die zugehörigen Schlüssel in Docusnap365. Die Aufträge bleiben bestehen.
Scheitert beim Deregistrieren nur die Abmeldung bei Docusnap365, löscht das Gateway seine lokale Konfiguration trotzdem. Es ist dann lokal deregistriert, in Docusnap365 aber nicht, siehe Gateway deregistrieren oder löschen. Das Gateway meldet das als Warnung, ebenso die Zahl der Anmeldedaten, die sich nicht löschen ließen. Bricht das Deregistrieren ab, bevor das Gateway in Docusnap365 abgemeldet ist, können die lokalen Anmeldedaten bereits gelöscht sein; das Gateway meldet das zusätzlich. Es bleibt dann registriert, aber ohne diese Anmeldedaten. Meldet das Gateway beim Registrieren oder Deregistrieren, dass die Anmeldung an Docusnap365 abgelaufen ist, melden Sie sich erneut an und wiederholen den Vorgang. Änderungen an Organisation, Standort, Plattform und den IP-Bereichen speichern Sie über Speichern. Der Vorgang setzt einen laufenden Dienst mit Internetverbindung voraus und kann bis zu einer halben Minute dauern, weil das Gateway wartet, bis der Dienst die neue Konfiguration übernommen hat. Bleibt die Übernahme aus, meldet das Gateway, dass der Dienst die Einstellungen nicht übernommen hat.

​
Registrierungsstatus und Dienst

Der Tab Allgemein zeigt den Zustand von Registrierung und Dienst:
Registriert sagt nur, dass eine Verbindungszeichenfolge hinterlegt ist – nicht, ob die Verbindung gerade steht. Ob das Gateway tatsächlich erreichbar ist, zeigt zuverlässig die Übersicht in Gateways verwalten im Browser.
Über Anmelden als setzen Sie das Konto, unter dem der Dienst läuft – Name und Passwort, oder Systemkonto verwenden für LocalSystem. Das Speichern stoppt den Dienst, ändert das Konto und startet ihn neu; eine laufende Ausführung bricht dabei ab. Das Gateway meldet getrennt, ob das Konto gespeichert wurde und ob der Dienst danach gestartet ist. „Dienstkonto gespeichert, Anmeldung des Dienstes fehlgeschlagen (Fehler 1069): Passwort falsch oder Recht ‘Anmelden als Dienst’ fehlt.“ heißt: Das Konto ist gesetzt, der Dienst läuft aber nicht. Prüfen Sie das Passwort und das Windows-Benutzerrecht „Anmelden als Dienst“ des Kontos.
Dieses Konto braucht Vollzugriff auf das Ablageverzeichnis, das Sie im Tab Einstellungen festlegen – sonst lassen sich die Scan-Skripts nicht aktualisieren, siehe Das Ablageverzeichnis festlegen. Welche Rechte das Konto auf den Zielsystemen braucht, welche Ports offen sein müssen und welche Firewall-Regeln nötig sind, prüfen Sie gegen Ihre Umgebung.

​
Gateway-Dienst unter eigenem Konto betreiben

Der Installer richtet den Dienst Docusnap Enterprise Gateway unter dem Systemkonto (LocalSystem) ein. Ein eigenes Konto brauchen Sie, wenn Ihre Richtlinien Dienste unter dem Systemkonto ausschließen – etwa im Tiering-Modell mit einem gruppenverwalteten Dienstkonto (gMSA).

​
Woran Sie das Problem erkennen

Fehlt dem Konto der Zugriff auf die Ordner des Gateways, startet der Dienst nicht oder hält kurz nach dem Start wieder an; im Tab Allgemein steht er dann auf Gestoppt. Meldet das Fenster beim Setzen des Kontos „Dienstkonto gespeichert, Anmeldung des Dienstes fehlgeschlagen (Fehler 1069): Passwort falsch oder Recht ‘Anmelden als Dienst’ fehlt.“, fehlt dem Konto das Benutzerrecht Anmelden als Dienst, oder das Passwort stimmt nicht.

​
Welche Rechte das Konto braucht

Dazu braucht das Konto das Windows-Benutzerrecht Anmelden als Dienst. Registrierung und lokal abgelegte Anmeldedaten sind nicht an das Windows-Konto gebunden; sie bleiben beim Wechsel des Kontos gültig. Führt der Weg ins Internet über einen Proxy mit Anmeldung, meldet sich der Dienst dort mit diesem Konto an.

​
Konto einrichten

1

Rechte vergeben

Vergeben Sie dem Konto die Rechte aus der Tabelle. Existiert C:\ProgramData\Docusnap\Temp noch nicht, legen Sie den Ordner an.
2

Konto setzen

Setzen Sie das Konto in der Windows-Diensteverwaltung beim Dienst Docusnap Enterprise Gateway oder im Fenster des Gateways unter Allgemein › Anmelden als. Die Windows-Diensteverwaltung vergibt dabei auch das Recht Anmelden als Dienst; über Anmelden als muss es vorher vergeben sein.
3

Dienst neu starten

Starten Sie den Dienst im Tab Allgemein über Stop und Start oder in der Windows-Diensteverwaltung neu. Anmelden als startet den Dienst nach dem Speichern selbst.

​
Weiterführend

Registriert und verbunden, arbeiten Sie mit dem Gateway im Browser weiter – siehe Gateways verwalten. Anmeldedaten, die dieses Netz nie verlassen sollen, legen Sie im Tab Anmeldedaten an, siehe Anmeldedaten lokal ablegen. Für den ersten Scanauftrag siehe Scanauftrag anlegen.