In this section, you will learn how to use a proxy server to connect to the RetailForce Cloud.

Proxy server support is available as of version 1.2.7.

Using Proxy with FiscalService

Attention: Currently, the proxy is only supported under Windows (not Docker).

To use the proxy server, the file appsettings.json in the directory C:\Program Files\RetailForce\Fiscal Webservice must be changed as follows:

{
  "Logging": {
  "LogLevel": {
  "Default": "Information",
  "Microsoft": "Information",
  "Microsoft.AspNetCore": "Information", // for request time and request start information.
  "Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker": "Warning"
},
  "Console": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore.Mvc.Infrastructure.ControllerActionInvoker": "Warning"
    }
  }
},
  "AllowedHosts": "*",
  "AppSettings": {
    "Secret": "-----",
    "Portnumber": 7678,
    "PortnumberHttps": 7677,
    "UseHttps": false,
    "UseHttpsRedirection": false,
    "HttpsCertificateFilename": "development.pfx",
    "HttpsCertificatePassword": "beispiel",
    "LogName": "RetailForce Fiscalisation",
    "LogEventLog": false,
    "LogLevelFilter": "Debug"
  },
  "ProxyConfiguration": {
     "Address": "http://proxyServer:3128",
     "Username": "username",
     "Password": "strongPassword",
   } 
}

ATTENTION: Incorrect changes to this file will cause the FiscalService to stop starting. The contents here are examples, do not copy the entire file.

The red area is for the configuration of the proxy server.

Description:

Value	Description
Address	The address of the proxy server with the http scheme and if needed port. ATTENTION: Only http (no https) is supported.
Username	User name for registration, if no registration is required, omit this entry.
Password	Password for login, if no login is required, omit this entry.
ByPassOnLocal	True if local addresses are not to be sent via the proxy. Default is false. Can normally always be omitted.
ByPassList	List of addresses that should not be sent via the proxy server. Can normally always be omitted.

Using proxy with nuget implementation

When implementing with nuget, the proxy information must be included in the instantiation for 2 calls:

The ProxyInformation can be created by instantiating the ProxyConfiguration class in the RetailForce.Common namespace.

The properties that can be set have the same names as the proxy server settings in the previous chapter.

For the following two instantiations, the proxy configuration must then be specified:

CloudService (optional parameter proxyConfiguration)
FiscalModuleManagement (optional parameter proxyConfiguration)

Using Proxy Server on FiscalClient

Using Proxy with FiscalService

Using proxy with nuget implementation

Comments

Using Proxy with FiscalService

Using proxy with nuget implementation

Related articles