Skip to main content
The Docusnap Enterprise Gateway consists of two parts: a Windows service that runs your jobs, and a window through which you set that service up. The installer installs both in a single pass.
After registration, configuration, log and diagnostics are also available in the browser under Scan › Gateways. Both interfaces work on the same configuration, see Managing Gateways.

​
Getting and running the installer

The installer DocusnapEnterpriseGatewaySetup.exe is 64-bit and installs the service and the window together, machine-wide and with an elevation prompt. You find it under Scan › Gateways through the Download Gateway button. In the installer you decide on the Npcap driver: it is preselected and required for network scans, but you can deselect it. The installer also installs missing prerequisites (.NET Framework 4.8, the Visual C++ redistributables). Afterwards the service Docusnap Enterprise Gateway starts automatically with Windows, and two shortcuts of the same name—in the Start menu and on the desktop—open the window. The gateway is not yet bound to a subscription. If the window fails to start, a Windows error dialog reports this and names the path of the file Configuration.log, which holds the details. The window then closes.

​
Signing in and registering

Before registration, only the Registration tab can be used in the window; the other four tabs are greyed out and are enabled by the registration.
1

Sign in

The gateway opens the sign-in page in your default browser. If the browser does not respond within 60 seconds, the sign-in counts as failed.
2

Choose subscription and assignment

In the Registration tab you set Subscription, Organization, Site and Platform. The Display Name is required and prefilled with the fully qualified computer name; while it is empty, Register stays disabled.
The Subscription cannot be changed after registration. Changing it requires deregistering and registering again—which deletes all credentials stored on the gateway, see Storing Credentials Locally.
3

Enter IP ranges

Through IP Range you define the network ranges this gateway serves—Start IP, End IP and a Description. Only IPv4 addresses are accepted.
4

Register

Register signs the gateway in to Docusnap365. On success the service restarts and the other four tabs become available.
If there is exactly one subscription and exactly one organization at the first sign-in, the gateway registers itself—the tab is skipped, and the Display Name stays the computer name.
The Gateway ID, under which the gateway is listed in Docusnap365, is composed of the computer name, the domain name and a machine-specific key from the Windows registry. A cloned system yields the same gateway ID as its original as long as that key was copied along—relevant for golden images and virtual-machine templates.
After registration the gateway appears in the browser overview, see Managing Gateways.
Deregistering deletes all credentials stored on the gateway—the local files and the associated keys in Docusnap365. Jobs are kept.
If only the removal from Docusnap365 fails during deregistration, the gateway deletes its local configuration anyway. It is then deregistered locally but not in Docusnap365, see Deregistering or deleting the gateway. The gateway reports this as a warning, together with the number of credentials that could not be deleted. If deregistration stops before the gateway is removed from Docusnap365, the local credentials may already be deleted; the gateway reports this as well. It then stays registered, but without these credentials. If the gateway reports during registration or deregistration that the sign-in to Docusnap365 has expired, sign in again and repeat the operation. You save changes to organization, site, platform and the IP ranges through Save. The operation requires a running service with an internet connection and can take up to half a minute, because the gateway waits until the service has applied the new configuration. If the service does not apply it, the gateway reports that the service did not apply the settings.

​
Registration status and service

The General tab shows the state of registration and service:
Registered only means that a connection string is stored—not whether the connection is currently up. Whether the gateway is actually reachable is shown reliably by the overview in Managing Gateways in the browser.
Through Log On As you set the account the service runs under—name and password, or Use System Account for LocalSystem. Saving stops the service, changes the account and starts it again; a running job execution is aborted. The gateway reports separately whether the account was saved and whether the service started afterwards. “Service account saved, service logon failed (error 1069): wrong password or missing ‘Log on as a service’ right.” means the account is set but the service is not running. Check the password and the account’s Windows user right “Log on as a service”.
This account needs full access to the Storage Directory that you set in the Settings tab—otherwise the scan scripts cannot be updated, see Setting the Storage Directory. Which rights the account needs on the target systems, which ports must be open and which firewall rules are required, check against your environment.
Once registered and connected, you continue working with the gateway in the browser—see Managing Gateways. Credentials that must never leave this network you create in the Credentials tab, see Storing Credentials Locally. For the first scan job see Creating a Scan Job.