HALBs

PreviousStatus NextDevice

Last updated 25 days ago

Was this helpful?

Create

post

Create a new entry for the HALB Virtual Server settings

Query parameters

noInstallbooleanoptional

Set it to true if HALB Devices should be initialized after being added. (optional)

Body

Create a new HALB Virtual Server

descriptionstring | nullableoptional

The HALB Virtual Server description.

publicAddressstring | nullableoptional

The HALB Virtual Server Public Address.

virtualIPv4string | nullableoptional

The IPv4 of the HALB Virtual Server.

subnetMaskstring | nullableoptional

The Subnet Mask of the HALB Virtual Server.

virtualIPv6string | nullableoptional

The IPv6 of the HALB Virtual Server.

prefixIPV6integer · int32 | nullableoptional

The IPv6 Prefix of the HALB Virtual Server.

enableTunnelingboolean | nullableoptional

Enable/Disable the RDP/UDP of the HALB Virtual Server.

maxTCPConnectionsinteger · int32 | nullableoptional

The Maximum allowed TCP Connections to the HALB Virtual Server.

vrrpAuthenticationPasswordstring | nullableoptional

The VRRP Authentication password.

clientIdleTimeoutinteger · int32 | nullableoptional

The client inactivity timeout.

gatewayConnectionTimeoutinteger · int32 | nullableoptional

The Gateway connection timeout.

clientQueueTimeoutinteger · int32 | nullableoptional

The client queue timeout.

gatewayIdleTimeoutinteger · int32 | nullableoptional

The Gateway inactivity timeout.

sessionRateinteger · int32 | nullableoptional

The amount of TCP connections per second.

gatewayHealthCheckIntervalsinteger · int32 | nullableoptional

The Gateway Health check intervals in seconds.

vrrpVirtualRouterIDinteger · int32 | nullableoptional

The Virtual Router ID of HALB Virtual Server (if not set, the router ID will be automatically computed).

vrrpBroadcastIntervalinteger · int32 | nullableoptional

The VRRP broadcast interval in minutes.

vrrpHealthScriptCheckIntervalinteger · int32 | nullableoptional

The VRRP health script check interval in seconds.

vrrpHealthScriptCheckTimeoutinteger · int32 | nullableoptional

The VRRP health script check timeout in seconds.

vrrpAdvertisementIntervalinteger · int32 | nullableoptional

The VRRP Advertisement interval in seconds.

enableOSUpdatesboolean | nullableoptional

Enable/Disable OS updates.

keepLBProxyConfigboolean | nullableoptional

Enable/Disable keeping of existing loadbalancing settings.

keepVRRPConfigboolean | nullableoptional

Enable/Disable keeping of existing VRRP/keepalive settings.

lbGatewaysstring[] | nullableoptional

The list of the Non-SSL Gateways for HALB Virtual Server.

lbGatewayPortinteger · int32 | nullableoptional

The Non-SSL Gateway port.

sslModestring · enumoptional

Load Balancing SSL Mode

Available options:

lbsslGatewaysstring[] | nullableoptional

The list of the SSL Gateways for HALB Virtual Server.

lbsslGatewayPortinteger · int32 | nullableoptional

The SSL Gateway port.

acceptedSSLVersionstring · enumoptional

Accepted SSL Versions

Available options:

cipherStrengthstring · enumoptional

Cipher Strength

Available options:

cipherPreferenceboolean | nullableoptional

Enable or disable 'Use ciphers according to server preference'.

sslCustomCipherstring | nullableoptional

The SSL custom cipher for SSL Gateways.

certificateIDinteger · int32 | nullableoptional

The certificate ID.

deviceManagerGatewaysstring[] | nullableoptional

The list of the Device Management Gateways for HALB Virtual Server.

namestring | nullablerequired

The HALB Virtual Server name.

siteIdinteger · int32optional

The site ID where the HALB settings will be created.

ipVersionstring · enumrequired

IP Version

Available options:

deviceIPsstring[] | nullableoptional

The list of the HALB Device IPs.

enableGatewayPayloadbooleanoptional

Enable/Disable the Non-SSL Gateway configuration of the HALB Virtual Server .

Default: false

enableSSLPayloadbooleanoptional

Enable/Disable the SSL Gateway configuration of the HALB Virtual Server.

Default: false

enableDeviceManagementbooleanoptional

Enable/Disable the Device Management configuration of the HALB Virtual Server.

Default: false

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/HALB' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "description": "text",
    "publicAddress": "text",
    "virtualIPv4": "text",
    "subnetMask": "text",
    "virtualIPv6": "text",
    "prefixIPV6": 1,
    "enableTunneling": true,
    "maxTCPConnections": 1,
    "vrrpAuthenticationPassword": "text",
    "clientIdleTimeout": 1,
    "gatewayConnectionTimeout": 1,
    "clientQueueTimeout": 1,
    "gatewayIdleTimeout": 1,
    "sessionRate": 1,
    "gatewayHealthCheckIntervals": 1,
    "vrrpVirtualRouterID": 1,
    "vrrpBroadcastInterval": 1,
    "vrrpHealthScriptCheckInterval": 1,
    "vrrpHealthScriptCheckTimeout": 1,
    "vrrpAdvertisementInterval": 1,
    "enableOSUpdates": true,
    "keepLBProxyConfig": true,
    "keepVRRPConfig": true,
    "lbGateways": [
      "text"
    ],
    "lbGatewayPort": 1,
    "sslMode": [
      "0 = SSLOffloading",
      "1 = SSLPassthrough"
    ],
    "lbsslGateways": [
      "text"
    ],
    "lbsslGatewayPort": 1,
    "acceptedSSLVersion": [
      "2 = TLSv1",
      "3 = TLSv1_1",
      "4 = TLSv1_2",
      "5 = TLSv1_3"
    ],
    "cipherStrength": [
      "0 = Low",
      "1 = Medium",
      "2 = High",
      "3 = Custom"
    ],
    "cipherPreference": true,
    "sslCustomCipher": "text",
    "certificateID": 1,
    "deviceManagerGateways": [
      "text"
    ],
    "name": "text",
    "siteId": 1,
    "ipVersion": [
      "0 = Version4",
      "1 = Version6",
      "2 = BothVersions"
    ],
    "deviceIPs": [
      "text"
    ],
    "enableGatewayPayload": true,
    "enableSSLPayload": true,
    "enableDeviceManagement": true
  }'

201

401

409

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:06:17.025Z",
  "timeLastMod": "2025-04-06T01:06:17.025Z",
  "name": "text",
  "siteId": 1,
  "description": "text",
  "publicAddress": "text",
  "enableGatewayPayload": true,
  "enableSSLPayload": true,
  "enableHALBInstance": true,
  "enableDeviceManagement": true,
  "ipVersion": [
    "0 = Version4",
    "1 = Version6",
    "2 = BothVersions"
  ],
  "virtualIPV4": "text",
  "subNetMask": "text",
  "virtualIPV6": "text",
  "prefixIPV6": 1,
  "devices": [
    {
      "deviceIP": "text",
      "deviceId": 1
    }
  ],
  "enableUDPTunneling": true,
  "maxTCPConnections": 1,
  "algorithm": [
    "0 = SourceIP",
    "1 = Cookie"
  ],
  "clientIdleTimeout": 1,
  "gatewayConnectionTimeout": 1,
  "clientQueueTimeout": 1,
  "gatewayIdleTimeout": 1,
  "sessionsRate": 1,
  "gatewayHealthCheckInterval": 1,
  "virtualRouterID": 1,
  "vrrpBroadcastInterval": 1,
  "vrrpHealthCheckInterval": 1,
  "vrrpHealthCheckTimeout": 1,
  "osUpdate": true,
  "vrrpAdvertInterval": 1,
  "keepLBProxyConfig": true,
  "keepVRRPConfig": true,
  "clientManagementConfig": {
    "gateways": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "gatewayConfig": {
    "port": 1,
    "gateways": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "sslConfig": {
    "minSSLVersion": [
      "2 = TLSv1",
      "3 = TLSv1_1",
      "4 = TLSv1_2",
      "5 = TLSv1_3"
    ],
    "sslMode": [
      "0 = SSLOffloading",
      "1 = SSLPassthrough"
    ],
    "sslCustomCipher": "text",
    "sslCipherStrength": [
      "0 = Low",
      "1 = Medium",
      "2 = High",
      "3 = Custom"
    ],
    "sslCipherPreference": true,
    "certID": 1,
    "gatewayConfig": {
      "port": 1,
      "gateways": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    }
  }
}

Created

List

get

Retrieve a list of the HALB Virtual Server settings.

Query parameters

Namestringoptional

The name of te HALB Virtual Server

SiteIdinteger · int32optional

The site ID from where to retrieve the HALB Virtual Server Settings (optional)

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/HALB'

200

401

404

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-04-06T01:06:17.025Z",
    "timeLastMod": "2025-04-06T01:06:17.025Z",
    "name": "text",
    "siteId": 1,
    "description": "text",
    "publicAddress": "text",
    "enableGatewayPayload": true,
    "enableSSLPayload": true,
    "enableHALBInstance": true,
    "enableDeviceManagement": true,
    "ipVersion": [
      "0 = Version4",
      "1 = Version6",
      "2 = BothVersions"
    ],
    "virtualIPV4": "text",
    "subNetMask": "text",
    "virtualIPV6": "text",
    "prefixIPV6": 1,
    "devices": [
      {
        "deviceIP": "text",
        "deviceId": 1
      }
    ],
    "enableUDPTunneling": true,
    "maxTCPConnections": 1,
    "algorithm": [
      "0 = SourceIP",
      "1 = Cookie"
    ],
    "clientIdleTimeout": 1,
    "gatewayConnectionTimeout": 1,
    "clientQueueTimeout": 1,
    "gatewayIdleTimeout": 1,
    "sessionsRate": 1,
    "gatewayHealthCheckInterval": 1,
    "virtualRouterID": 1,
    "vrrpBroadcastInterval": 1,
    "vrrpHealthCheckInterval": 1,
    "vrrpHealthCheckTimeout": 1,
    "osUpdate": true,
    "vrrpAdvertInterval": 1,
    "keepLBProxyConfig": true,
    "keepVRRPConfig": true,
    "clientManagementConfig": {
      "gateways": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    },
    "gatewayConfig": {
      "port": 1,
      "gateways": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    },
    "sslConfig": {
      "minSSLVersion": [
        "2 = TLSv1",
        "3 = TLSv1_1",
        "4 = TLSv1_2",
        "5 = TLSv1_3"
      ],
      "sslMode": [
        "0 = SSLOffloading",
        "1 = SSLPassthrough"
      ],
      "sslCustomCipher": "text",
      "sslCipherStrength": [
        "0 = Low",
        "1 = Medium",
        "2 = High",
        "3 = Custom"
      ],
      "sslCipherPreference": true,
      "certID": 1,
      "gatewayConfig": {
        "port": 1,
        "gateways": {
          "ANY_ADDITIONAL_PROPERTY": 1
        }
      }
    }
  }
]

Success

Get

get

Retrieve a specific HALB Virtual Server

Path parameters

idinteger · int32required

The ID of the HALB Virtual Server

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/HALB/{id}'

200

401

404

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:06:17.025Z",
  "timeLastMod": "2025-04-06T01:06:17.025Z",
  "name": "text",
  "siteId": 1,
  "description": "text",
  "publicAddress": "text",
  "enableGatewayPayload": true,
  "enableSSLPayload": true,
  "enableHALBInstance": true,
  "enableDeviceManagement": true,
  "ipVersion": [
    "0 = Version4",
    "1 = Version6",
    "2 = BothVersions"
  ],
  "virtualIPV4": "text",
  "subNetMask": "text",
  "virtualIPV6": "text",
  "prefixIPV6": 1,
  "devices": [
    {
      "deviceIP": "text",
      "deviceId": 1
    }
  ],
  "enableUDPTunneling": true,
  "maxTCPConnections": 1,
  "algorithm": [
    "0 = SourceIP",
    "1 = Cookie"
  ],
  "clientIdleTimeout": 1,
  "gatewayConnectionTimeout": 1,
  "clientQueueTimeout": 1,
  "gatewayIdleTimeout": 1,
  "sessionsRate": 1,
  "gatewayHealthCheckInterval": 1,
  "virtualRouterID": 1,
  "vrrpBroadcastInterval": 1,
  "vrrpHealthCheckInterval": 1,
  "vrrpHealthCheckTimeout": 1,
  "osUpdate": true,
  "vrrpAdvertInterval": 1,
  "keepLBProxyConfig": true,
  "keepVRRPConfig": true,
  "clientManagementConfig": {
    "gateways": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "gatewayConfig": {
    "port": 1,
    "gateways": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  },
  "sslConfig": {
    "minSSLVersion": [
      "2 = TLSv1",
      "3 = TLSv1_1",
      "4 = TLSv1_2",
      "5 = TLSv1_3"
    ],
    "sslMode": [
      "0 = SSLOffloading",
      "1 = SSLPassthrough"
    ],
    "sslCustomCipher": "text",
    "sslCipherStrength": [
      "0 = Low",
      "1 = Medium",
      "2 = High",
      "3 = Custom"
    ],
    "sslCipherPreference": true,
    "certID": 1,
    "gatewayConfig": {
      "port": 1,
      "gateways": {
        "ANY_ADDITIONAL_PROPERTY": 1
      }
    }
  }
}

Success

Delete

delete

Remove the specific HALB Virtual Server settings and un-initialize any HALB Devices used by it.

Path parameters

idinteger · int32required

The ID of the HALB Virtual Server

Query parameters

noUnInstallbooleanoptional

If specified the HALB devices will not be un-initialized.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/HALB/{id}'

204

401

404

No Content

Update

put

Modify the settings of the specific HALB Virtual Server

Path parameters

idinteger · int32required

The ID of the HALB Virtual Server

Body

Update a HALB Virtual Server

descriptionstring | nullableoptional

The HALB Virtual Server description.

publicAddressstring | nullableoptional

The HALB Virtual Server Public Address.

virtualIPv4string | nullableoptional

The IPv4 of the HALB Virtual Server.

subnetMaskstring | nullableoptional

The Subnet Mask of the HALB Virtual Server.

virtualIPv6string | nullableoptional

The IPv6 of the HALB Virtual Server.

prefixIPV6integer · int32 | nullableoptional

The IPv6 Prefix of the HALB Virtual Server.

enableTunnelingboolean | nullableoptional

Enable/Disable the RDP/UDP of the HALB Virtual Server.

maxTCPConnectionsinteger · int32 | nullableoptional

The Maximum allowed TCP Connections to the HALB Virtual Server.

vrrpAuthenticationPasswordstring | nullableoptional

The VRRP Authentication password.

clientIdleTimeoutinteger · int32 | nullableoptional

The client inactivity timeout.

gatewayConnectionTimeoutinteger · int32 | nullableoptional

The Gateway connection timeout.

clientQueueTimeoutinteger · int32 | nullableoptional

The client queue timeout.

gatewayIdleTimeoutinteger · int32 | nullableoptional

The Gateway inactivity timeout.

sessionRateinteger · int32 | nullableoptional

The amount of TCP connections per second.

gatewayHealthCheckIntervalsinteger · int32 | nullableoptional

The Gateway Health check intervals in seconds.

vrrpVirtualRouterIDinteger · int32 | nullableoptional

The Virtual Router ID of HALB Virtual Server (if not set, the router ID will be automatically computed).

vrrpBroadcastIntervalinteger · int32 | nullableoptional

The VRRP broadcast interval in minutes.

vrrpHealthScriptCheckIntervalinteger · int32 | nullableoptional

The VRRP health script check interval in seconds.

vrrpHealthScriptCheckTimeoutinteger · int32 | nullableoptional

The VRRP health script check timeout in seconds.

vrrpAdvertisementIntervalinteger · int32 | nullableoptional

The VRRP Advertisement interval in seconds.

enableOSUpdatesboolean | nullableoptional

Enable/Disable OS updates.

keepLBProxyConfigboolean | nullableoptional

Enable/Disable keeping of existing loadbalancing settings.

keepVRRPConfigboolean | nullableoptional

Enable/Disable keeping of existing VRRP/keepalive settings.

lbGatewaysstring[] | nullableoptional

The list of the Non-SSL Gateways for HALB Virtual Server.

lbGatewayPortinteger · int32 | nullableoptional

The Non-SSL Gateway port.

sslModestring · enumoptional

Load Balancing SSL Mode

Available options:

lbsslGatewaysstring[] | nullableoptional

The list of the SSL Gateways for HALB Virtual Server.

lbsslGatewayPortinteger · int32 | nullableoptional

The SSL Gateway port.

acceptedSSLVersionstring · enumoptional

Accepted SSL Versions

Available options:

cipherStrengthstring · enumoptional

Cipher Strength

Available options:

cipherPreferenceboolean | nullableoptional

Enable or disable 'Use ciphers according to server preference'.

sslCustomCipherstring | nullableoptional

The SSL custom cipher for SSL Gateways.

certificateIDinteger · int32 | nullableoptional

The certificate ID.

deviceManagerGatewaysstring[] | nullableoptional

The list of the Device Management Gateways for HALB Virtual Server.

namestring | nullableoptional

The new name for the HALB Virtual Server.

enabledboolean | nullableoptional

Enable/Disable HALB Virtual Server.

ipVersionstring · enumoptional

IP Version

Available options:

enableGatewayPayloadboolean | nullableoptional

Enable/Disable the Non-SSL Gateway configuration of the HALB Virtual Server .

enableSSLPayloadboolean | nullableoptional

Enable/Disable the SSL Gateway configuration of the HALB Virtual Server.

enableDeviceManagementboolean | nullableoptional

Enable/Disable the Device Management configuration of the HALB Virtual Server.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/HALB/{id}' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "description": "text",
    "publicAddress": "text",
    "virtualIPv4": "text",
    "subnetMask": "text",
    "virtualIPv6": "text",
    "prefixIPV6": 1,
    "enableTunneling": true,
    "maxTCPConnections": 1,
    "vrrpAuthenticationPassword": "text",
    "clientIdleTimeout": 1,
    "gatewayConnectionTimeout": 1,
    "clientQueueTimeout": 1,
    "gatewayIdleTimeout": 1,
    "sessionRate": 1,
    "gatewayHealthCheckIntervals": 1,
    "vrrpVirtualRouterID": 1,
    "vrrpBroadcastInterval": 1,
    "vrrpHealthScriptCheckInterval": 1,
    "vrrpHealthScriptCheckTimeout": 1,
    "vrrpAdvertisementInterval": 1,
    "enableOSUpdates": true,
    "keepLBProxyConfig": true,
    "keepVRRPConfig": true,
    "lbGateways": [
      "text"
    ],
    "lbGatewayPort": 1,
    "sslMode": [
      "0 = SSLOffloading",
      "1 = SSLPassthrough"
    ],
    "lbsslGateways": [
      "text"
    ],
    "lbsslGatewayPort": 1,
    "acceptedSSLVersion": [
      "2 = TLSv1",
      "3 = TLSv1_1",
      "4 = TLSv1_2",
      "5 = TLSv1_3"
    ],
    "cipherStrength": [
      "0 = Low",
      "1 = Medium",
      "2 = High",
      "3 = Custom"
    ],
    "cipherPreference": true,
    "sslCustomCipher": "text",
    "certificateID": 1,
    "deviceManagerGateways": [
      "text"
    ],
    "name": "text",
    "enabled": true,
    "ipVersion": [
      "0 = Version4",
      "1 = Version6",
      "2 = BothVersions"
    ],
    "enableGatewayPayload": true,
    "enableSSLPayload": true,
    "enableDeviceManagement": true
  }'

204

401

404

No Content