The relationship between packages, modules, components and interfaces is summarised in this graph.

Package

A package consists of the files required for the package to function and a cryptographically signed manifest file which is used to validate package files. Typically a package represents an entire product or system of functionality such as Web Proxy Filter product, Script Engine or Logging.  Packages typically contain executable module files (DLLs), help files, and/or other ancilliary files.

Module

A module refers to an executable DLL file within a package that represent distinct parts of your package/product. If you require engine side functionality you will have a module that is loaded and runs in the WinGate engine process. If you need to present a user interface then you may want to have a separate UI module that runs in the WinGate Management Console process. Each module shows up in the Modules panel of the WinGate Management Console and can be enabled or disabled by the administrator if the appropriate setting is in the manifest file for that module.

To expand on the example graph above, you may be providing a product called "Ultimate Monitoring System" that may consist of modules for:

In this example you would have a total of 6 modules in your package.

Modules can be loaded either in the WinGate Engine process (system service on Windows), or in the WinGate Management Console process, or both.

Packages have at least one Module called the Entry Point DLL which is the module loaded by the host framework (either WinGate process and/or WinGate Management Console process) and initialised via the Mandatory module functions.

Modules can have dependency files which are specified in the Manifest file. Specifying a dependency in a manifest file does several things:

  • It ensures the file is protected against tampering by placing a hash of the file inside the signed manifest file. If the hash in the manifest doesn't match the hash of the file on disk, the module won't load.
  • It controls whether a file is synchronised between the WinGate Engine and WinGate Management Console. See Package Synchronisation for more information.

Component

Within a module you have components which are sets of common functionality that you register with WinGate. Although in practice there is normally only one component registered for each module, a module can register any number of components.

Components in turn register interfaces.

Interface

One or more groups of functionality that your components register with WinGate via RegisterInterface, often to make it available for others to use. Using our "Ultimate Monitoring System" example, the Malware scanning engine component may decide to provide a couple of interfaces for client software to use.

The global threat assessment module might expose interfaces for: