Gateway

List

get

Retrieve a list of all the RAS Secure Gateway Servers.

Query parameters

SiteIdinteger · int32Optional

Site ID of which the RAS Secure Gateway Servers will be retrieved (optional)

ServerstringOptional

Filter the result by server name (optional)

Responses

200

Success

application/json; api-version=1.0

RAS Secure Gateway

idinteger · int32Optional

ID of the object.

adminCreatestring · nullableOptional

User who created the object.

adminLastModstring · nullableOptional

User who last modified the object.

timeCreatestring · date-timeOptional

Time when the object was created.

timeLastModstring · date-timeOptional

Time when the object was last modified.

serverstring · nullableOptional

Server name.

enabledbooleanOptional

Whether the server is enabled or not.

descriptionstring · nullableOptional

Description of the server.

siteIdinteger · int32Optional

ID of the site.

publicAddressstring · nullableOptional

The Public Address of the RAS Secure Gateway.

ipVersionstring · enumOptional

IP Version

Possible values:

iPsstring · nullableOptional

One or multiple (separated by comma) IP addresses.

bindV4Addressesstring · nullableOptional

IPv4 address to bind to.

optimizeConnectionIPv4string · nullableOptional

Optimize connection for the list of IPv4 (comma separated values).

bindV6Addressesstring · nullableOptional

IPv6 address to bind to.

optimizeConnectionIPv6string · nullableOptional

Optimize connection for the list of IPv6 (comma separated values).

inheritDefaultModeSettingsbooleanOptional

Whether default mode settings are enabled or disabled.

inheritDefaultNetworkSettingsbooleanOptional

Whether default network settings are enabled or disabled.

inheritDefaultSslTlsSettingsbooleanOptional

Whether default SSL/TLS settings are enabled or disabled.

inheritDefaultUserPortalSettingsbooleanOptional

Whether default User Portal settings are enabled or disabled.

inheritDefaultWyseSettingsbooleanOptional

Whether default wyse settings are enabled or disabled.

inheritDefaultSecuritySettingsbooleanOptional

Whether default security settings are enabled or disabled.

inheritDefaultWebSettingsbooleanOptional

Whether default web settings are enabled or disabled.

modestring · enumOptional

RAS Secure GateWay Mode

Possible values:

normalModeForwardingbooleanOptional

Whether forwarding requests to HTTP server are enabled or disabled.

forwardGatewayServersstring · nullableOptional

One or multiple (separated by comma) RAS Forwarding Secure Gateway Servers.

preferredBrokerIdinteger · int32Optional

ID of the Preferred Connection Broker.

forwardHttpServersstring · nullableOptional

One or multiple (separated by comma) Forwarding HTTP Servers.

enableGatewayPortbooleanOptional

Whether a custom RAS Secure Gateway port is enabled or disabled.

gatewayPortinteger · int32Optional

A custom RAS Secure Gateway port number.

onlyAllowAcmeHttpbooleanOptional

Whether to ignore all incoming requests except for Acme ones received on 'GatewayPort'

enableRDPbooleanOptional

Whether a custom RDP port is enabled or disabled.

rdpPortinteger · int32Optional

A custom RDP port number.

broadcastbooleanOptional

Whether the 'Broadcast RAS Secure Gateway Address' option is enabled or disabled.

enableRDPUDPbooleanOptional

Whether the 'RDP UDP Data Tunneling' option is enabled or disabled.

enableDeviceManagerPortbooleanOptional

Whether the 'Device Manager Port' option is enabled or disabled.

dosProbooleanOptional

Whether the 'RDP DOS Attack Filter' option is enabled or disabled.

enableSSLbooleanOptional

Whether SSL is enabled or disabled.

sslPortinteger · int32Optional

SSL port number.

minSSLVersionstring · enumOptional

Accepted SSL Versions

Possible values:

cipherStrengthstring · enumOptional

Cipher Strength

Possible values:

cipherstring · nullableOptional

Cipher string.

cipherPreferencebooleanOptional

Enable or disable Use ciphers according to server preference.

certificateIdinteger · int32Optional

The ID of the specific Certificate to be used.

enableHSTSbooleanOptional

Whether HSTS is enabled or disabled.

hstsMaxAgeinteger · int32Optional

Set Maximum Age of HSTS.

hstsIncludeSubdomainsbooleanOptional

Whether HSTS to include subdomains option is enabled or disabled.

hstsPreloadbooleanOptional

Whether HSTS to preload option is enabled or disabled.

enableUserPortalbooleanOptional

Whether User Portal connectivity on the RAS Secure Gateway is enabled or disabled.

userPortalPortinteger · int32Optional

A custom User Portal port number.

launchMethodstring · enumOptional

LaunchMethod

Possible values:

allowLaunchMethodbooleanOptional

Allow users to select a resource launch method.

allowAppsInNewTabbooleanOptional

Allow users to start applications in a new browser tab.

usePreWin2000LoginFormatbooleanOptional

Whether the 'Use Pre Windows 2000 Login Format' option is enabled or disabled.

allowEmbedbooleanOptional

Allow embedding of Web Client into other web pages.

allowFileTransferbooleanOptional

Whether the 'Allow file transfer' option is enabled or disabled. (deprecated)

fileTransferModestring · enumOptional

File Transfer Control modes.

Possible values:

allowClipboardbooleanOptional

Whether the 'Allow Clipboard' option is enabled or disabled. (deprecated)

clipboardDirectionstring[Flag] · enumOptional

Clipboard Direction Type.

Possible values:

allowCORSbooleanOptional

Allow cross-origin resource sharing.

browserCacheTimeInMonthsinteger · int32Optional

How long should the browser preserve the cache (in months).

allowedDomainsForCORSstring[] · nullableOptional

Allowed domains for cross-origin resource sharing.

enableAlternateNLBHostbooleanOptional

Whether alternate NLB Host is enabled or disabled.

alternateNLBHoststring · nullableOptional

Alternate NLB Host name.

enableAlternateNLBPortbooleanOptional

Whether alternate NLB Port is enabled or disabled.

alternateNLBPortinteger · int32Optional

Alternate NLB Port number.

enableWyseSupportbooleanOptional

Whether support for Wyse Thin Client OS is enabled or disabled.

disableWyseCertWarnbooleanOptional

Whether warning if server certificate is not verified is enabled or disabled.

securityModestring · enumOptional

Security Mode

Possible values:

macAllowExceptstring[] · nullableOptional

Lists all the Security 'MAC Allow Except' MAC addresses.

macAllowOnlystring[] · nullableOptional

Lists all the Security 'MAC Allow Only' MAC addresses.

webRequestsURLstring · nullableOptional

The URL for Web requests.

webCookiestring · nullableOptional

The Web Cookie Name used by RAS.

useSecureWebCookiebooleanOptional

Adds the secure attribute to the cookie to the Web Cookie.

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

/api/Gateway

HTTPcURLJavaScriptPython

GET /api/Gateway HTTP/1.1
Accept: */*

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2026-03-10T20:09:04.303Z",
    "timeLastMod": "2026-03-10T20:09:04.303Z",
    "server": "text",
    "enabled": true,
    "description": "text",
    "siteId": 1,
    "publicAddress": "text",
    "ipVersion": [
      "0 = Version4",
      "1 = Version6",
      "2 = BothVersions"
    ],
    "iPs": "text",
    "bindV4Addresses": "text",
    "optimizeConnectionIPv4": "text",
    "bindV6Addresses": "text",
    "optimizeConnectionIPv6": "text",
    "inheritDefaultModeSettings": true,
    "inheritDefaultNetworkSettings": true,
    "inheritDefaultSslTlsSettings": true,
    "inheritDefaultUserPortalSettings": true,
    "inheritDefaultWyseSettings": true,
    "inheritDefaultSecuritySettings": true,
    "inheritDefaultWebSettings": true,
    "mode": [
      "0 = Normal",
      "1 = Forwarding"
    ],
    "normalModeForwarding": true,
    "forwardGatewayServers": "text",
    "preferredBrokerId": 1,
    "forwardHttpServers": "text",
    "enableGatewayPort": true,
    "gatewayPort": 1,
    "onlyAllowAcmeHttp": true,
    "enableRDP": true,
    "rdpPort": 1,
    "broadcast": true,
    "enableRDPUDP": true,
    "enableDeviceManagerPort": true,
    "dosPro": true,
    "enableSSL": true,
    "sslPort": 1,
    "minSSLVersion": [
      "2 = TLSv1",
      "3 = TLSv1_1",
      "4 = TLSv1_2",
      "5 = TLSv1_3"
    ],
    "cipherStrength": [
      "0 = Low",
      "1 = Medium",
      "2 = High",
      "3 = Custom"
    ],
    "cipher": "text",
    "cipherPreference": true,
    "certificateId": 1,
    "enableHSTS": true,
    "hstsMaxAge": 1,
    "hstsIncludeSubdomains": true,
    "hstsPreload": true,
    "enableUserPortal": true,
    "userPortalPort": 1,
    "launchMethod": [
      "0 = ParallelsClientAndWebClient",
      "1 = ParallelsClient",
      "2 = WebClient"
    ],
    "allowLaunchMethod": true,
    "allowAppsInNewTab": true,
    "usePreWin2000LoginFormat": true,
    "allowEmbed": true,
    "allowFileTransfer": true,
    "fileTransferMode": [
      "0 = Disabled",
      "1 = ClientToServer",
      "2 = ServerToClient",
      "3 = Bidirectional"
    ],
    "allowClipboard": true,
    "clipboardDirection": [
      "0 = None",
      "1 = ClientToServer",
      "2 = ServerToClient",
      "3 = Bidirectional"
    ],
    "allowCORS": true,
    "browserCacheTimeInMonths": 1,
    "allowedDomainsForCORS": [
      "text"
    ],
    "enableAlternateNLBHost": true,
    "alternateNLBHost": "text",
    "enableAlternateNLBPort": true,
    "alternateNLBPort": 1,
    "enableWyseSupport": true,
    "disableWyseCertWarn": true,
    "securityMode": [
      "0 = AllowAllExcept",
      "1 = AllowOnly"
    ],
    "macAllowExcept": [
      "text"
    ],
    "macAllowOnly": [
      "text"
    ],
    "webRequestsURL": "text",
    "webCookie": "text",
    "useSecureWebCookie": true
  }
]

Create

post

Create a new RAS Secure Gateway Server.

Query parameters

noInstallbooleanOptional

If this parameter is included, the RAS Secure Gateway software will not be installed on the target server. The parameter should only be included if the server already has the software installed. If you need to install the software, omit this parameter. When installing the Gateway software, your RAS admin credentials will be used to push install the software. These are the credentials you used to connect to the RAS farm. If needed, you can specify different credentials using the Username and Password parameters.

usernamestringOptional

An administrator account to push install the Gateway software on the target server. If this parameter is omitted, your RAS admin username (and password) will be used

passwordstringOptional

The password of the account specified in the Username parameter.

noRestartbooleanOptional

Specifies not to restart the server after the RAS Gateway is installed. If this parameter is omitted, the server will be restarted if required.

noFireWallRulesbooleanOptional

Specifies not to add firewall rules to allow the RD Session Host Agent to communicate. If this parameter is omitted, the firewall rules will not be added.

Body

application/json; api-version=1.0

Create a new Secure Gateway

serverstring · nullableRequired

FQDN or IP address of the server to be added to a site as a RAS Secure Gateway.

siteIdinteger · int32Optional

The site ID to which the Secure Gateway should be added. To obtain the ID of a desired site, use the appropriate command to Get Sites. If the parameter is omitted, the site ID of the Licensing Server will be used.

enableUserPortalboolean · nullableOptional

Enable or disable User Portal connectivity on the Secure Gateway.

Responses

201

Created

application/json; api-version=1.0

401

Unauthorized

application/json; api-version=1.0

409

Conflict

application/json; api-version=1.0

post

/api/Gateway

HTTPcURLJavaScriptPython

POST /api/Gateway HTTP/1.1
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 52

{
  "server": "text",
  "siteId": 1,
  "enableUserPortal": true
}

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2026-03-10T20:09:04.303Z",
  "timeLastMod": "2026-03-10T20:09:04.303Z",
  "server": "text",
  "enabled": true,
  "description": "text",
  "siteId": 1,
  "publicAddress": "text",
  "ipVersion": [
    "0 = Version4",
    "1 = Version6",
    "2 = BothVersions"
  ],
  "iPs": "text",
  "bindV4Addresses": "text",
  "optimizeConnectionIPv4": "text",
  "bindV6Addresses": "text",
  "optimizeConnectionIPv6": "text",
  "inheritDefaultModeSettings": true,
  "inheritDefaultNetworkSettings": true,
  "inheritDefaultSslTlsSettings": true,
  "inheritDefaultUserPortalSettings": true,
  "inheritDefaultWyseSettings": true,
  "inheritDefaultSecuritySettings": true,
  "inheritDefaultWebSettings": true,
  "mode": [
    "0 = Normal",
    "1 = Forwarding"
  ],
  "normalModeForwarding": true,
  "forwardGatewayServers": "text",
  "preferredBrokerId": 1,
  "forwardHttpServers": "text",
  "enableGatewayPort": true,
  "gatewayPort": 1,
  "onlyAllowAcmeHttp": true,
  "enableRDP": true,
  "rdpPort": 1,
  "broadcast": true,
  "enableRDPUDP": true,
  "enableDeviceManagerPort": true,
  "dosPro": true,
  "enableSSL": true,
  "sslPort": 1,
  "minSSLVersion": [
    "2 = TLSv1",
    "3 = TLSv1_1",
    "4 = TLSv1_2",
    "5 = TLSv1_3"
  ],
  "cipherStrength": [
    "0 = Low",
    "1 = Medium",
    "2 = High",
    "3 = Custom"
  ],
  "cipher": "text",
  "cipherPreference": true,
  "certificateId": 1,
  "enableHSTS": true,
  "hstsMaxAge": 1,
  "hstsIncludeSubdomains": true,
  "hstsPreload": true,
  "enableUserPortal": true,
  "userPortalPort": 1,
  "launchMethod": [
    "0 = ParallelsClientAndWebClient",
    "1 = ParallelsClient",
    "2 = WebClient"
  ],
  "allowLaunchMethod": true,
  "allowAppsInNewTab": true,
  "usePreWin2000LoginFormat": true,
  "allowEmbed": true,
  "allowFileTransfer": true,
  "fileTransferMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "allowClipboard": true,
  "clipboardDirection": [
    "0 = None",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "allowCORS": true,
  "browserCacheTimeInMonths": 1,
  "allowedDomainsForCORS": [
    "text"
  ],
  "enableAlternateNLBHost": true,
  "alternateNLBHost": "text",
  "enableAlternateNLBPort": true,
  "alternateNLBPort": 1,
  "enableWyseSupport": true,
  "disableWyseCertWarn": true,
  "securityMode": [
    "0 = AllowAllExcept",
    "1 = AllowOnly"
  ],
  "macAllowExcept": [
    "text"
  ],
  "macAllowOnly": [
    "text"
  ],
  "webRequestsURL": "text",
  "webCookie": "text",
  "useSecureWebCookie": true
}

Get

get

Retrieve a specified RAS Secure Gateway Server.

Path parameters

idinteger · int32Required

ID of the Gateway server to be retrieved

Responses

200

Success

application/json; api-version=1.0

RAS Secure Gateway

idinteger · int32Optional

ID of the object.

adminCreatestring · nullableOptional

User who created the object.

adminLastModstring · nullableOptional

User who last modified the object.

timeCreatestring · date-timeOptional

Time when the object was created.

timeLastModstring · date-timeOptional

Time when the object was last modified.

serverstring · nullableOptional

Server name.

enabledbooleanOptional

Whether the server is enabled or not.

descriptionstring · nullableOptional

Description of the server.

siteIdinteger · int32Optional

ID of the site.

publicAddressstring · nullableOptional

The Public Address of the RAS Secure Gateway.

ipVersionstring · enumOptional

IP Version

Possible values:

iPsstring · nullableOptional

One or multiple (separated by comma) IP addresses.

bindV4Addressesstring · nullableOptional

IPv4 address to bind to.

optimizeConnectionIPv4string · nullableOptional

Optimize connection for the list of IPv4 (comma separated values).

bindV6Addressesstring · nullableOptional

IPv6 address to bind to.

optimizeConnectionIPv6string · nullableOptional

Optimize connection for the list of IPv6 (comma separated values).

inheritDefaultModeSettingsbooleanOptional

Whether default mode settings are enabled or disabled.

inheritDefaultNetworkSettingsbooleanOptional

Whether default network settings are enabled or disabled.

inheritDefaultSslTlsSettingsbooleanOptional

Whether default SSL/TLS settings are enabled or disabled.

inheritDefaultUserPortalSettingsbooleanOptional

Whether default User Portal settings are enabled or disabled.

inheritDefaultWyseSettingsbooleanOptional

Whether default wyse settings are enabled or disabled.

inheritDefaultSecuritySettingsbooleanOptional

Whether default security settings are enabled or disabled.

inheritDefaultWebSettingsbooleanOptional

Whether default web settings are enabled or disabled.

modestring · enumOptional

RAS Secure GateWay Mode

Possible values:

normalModeForwardingbooleanOptional

Whether forwarding requests to HTTP server are enabled or disabled.

forwardGatewayServersstring · nullableOptional

One or multiple (separated by comma) RAS Forwarding Secure Gateway Servers.

preferredBrokerIdinteger · int32Optional

ID of the Preferred Connection Broker.

forwardHttpServersstring · nullableOptional

One or multiple (separated by comma) Forwarding HTTP Servers.

enableGatewayPortbooleanOptional

Whether a custom RAS Secure Gateway port is enabled or disabled.

gatewayPortinteger · int32Optional

A custom RAS Secure Gateway port number.

onlyAllowAcmeHttpbooleanOptional

Whether to ignore all incoming requests except for Acme ones received on 'GatewayPort'

enableRDPbooleanOptional

Whether a custom RDP port is enabled or disabled.

rdpPortinteger · int32Optional

A custom RDP port number.

broadcastbooleanOptional

Whether the 'Broadcast RAS Secure Gateway Address' option is enabled or disabled.

enableRDPUDPbooleanOptional

Whether the 'RDP UDP Data Tunneling' option is enabled or disabled.

enableDeviceManagerPortbooleanOptional

Whether the 'Device Manager Port' option is enabled or disabled.

dosProbooleanOptional

Whether the 'RDP DOS Attack Filter' option is enabled or disabled.

enableSSLbooleanOptional

Whether SSL is enabled or disabled.

sslPortinteger · int32Optional

SSL port number.

minSSLVersionstring · enumOptional

Accepted SSL Versions

Possible values:

cipherStrengthstring · enumOptional

Cipher Strength

Possible values:

cipherstring · nullableOptional

Cipher string.

cipherPreferencebooleanOptional

Enable or disable Use ciphers according to server preference.

certificateIdinteger · int32Optional

The ID of the specific Certificate to be used.

enableHSTSbooleanOptional

Whether HSTS is enabled or disabled.

hstsMaxAgeinteger · int32Optional

Set Maximum Age of HSTS.

hstsIncludeSubdomainsbooleanOptional

Whether HSTS to include subdomains option is enabled or disabled.

hstsPreloadbooleanOptional

Whether HSTS to preload option is enabled or disabled.

enableUserPortalbooleanOptional

Whether User Portal connectivity on the RAS Secure Gateway is enabled or disabled.

userPortalPortinteger · int32Optional

A custom User Portal port number.

launchMethodstring · enumOptional

LaunchMethod

Possible values:

allowLaunchMethodbooleanOptional

Allow users to select a resource launch method.

allowAppsInNewTabbooleanOptional

Allow users to start applications in a new browser tab.

usePreWin2000LoginFormatbooleanOptional

Whether the 'Use Pre Windows 2000 Login Format' option is enabled or disabled.

allowEmbedbooleanOptional

Allow embedding of Web Client into other web pages.

allowFileTransferbooleanOptional

Whether the 'Allow file transfer' option is enabled or disabled. (deprecated)

fileTransferModestring · enumOptional

File Transfer Control modes.

Possible values:

allowClipboardbooleanOptional

Whether the 'Allow Clipboard' option is enabled or disabled. (deprecated)

clipboardDirectionstring[Flag] · enumOptional

Clipboard Direction Type.

Possible values:

allowCORSbooleanOptional

Allow cross-origin resource sharing.

browserCacheTimeInMonthsinteger · int32Optional

How long should the browser preserve the cache (in months).

allowedDomainsForCORSstring[] · nullableOptional

Allowed domains for cross-origin resource sharing.

enableAlternateNLBHostbooleanOptional

Whether alternate NLB Host is enabled or disabled.

alternateNLBHoststring · nullableOptional

Alternate NLB Host name.

enableAlternateNLBPortbooleanOptional

Whether alternate NLB Port is enabled or disabled.

alternateNLBPortinteger · int32Optional

Alternate NLB Port number.

enableWyseSupportbooleanOptional

Whether support for Wyse Thin Client OS is enabled or disabled.

disableWyseCertWarnbooleanOptional

Whether warning if server certificate is not verified is enabled or disabled.

securityModestring · enumOptional

Security Mode

Possible values:

macAllowExceptstring[] · nullableOptional

Lists all the Security 'MAC Allow Except' MAC addresses.

macAllowOnlystring[] · nullableOptional

Lists all the Security 'MAC Allow Only' MAC addresses.

webRequestsURLstring · nullableOptional

The URL for Web requests.

webCookiestring · nullableOptional

The Web Cookie Name used by RAS.

useSecureWebCookiebooleanOptional

Adds the secure attribute to the cookie to the Web Cookie.

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

get

/api/Gateway/{id}

HTTPcURLJavaScriptPython

GET /api/Gateway/{id} HTTP/1.1
Accept: */*

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2026-03-10T20:09:04.303Z",
  "timeLastMod": "2026-03-10T20:09:04.303Z",
  "server": "text",
  "enabled": true,
  "description": "text",
  "siteId": 1,
  "publicAddress": "text",
  "ipVersion": [
    "0 = Version4",
    "1 = Version6",
    "2 = BothVersions"
  ],
  "iPs": "text",
  "bindV4Addresses": "text",
  "optimizeConnectionIPv4": "text",
  "bindV6Addresses": "text",
  "optimizeConnectionIPv6": "text",
  "inheritDefaultModeSettings": true,
  "inheritDefaultNetworkSettings": true,
  "inheritDefaultSslTlsSettings": true,
  "inheritDefaultUserPortalSettings": true,
  "inheritDefaultWyseSettings": true,
  "inheritDefaultSecuritySettings": true,
  "inheritDefaultWebSettings": true,
  "mode": [
    "0 = Normal",
    "1 = Forwarding"
  ],
  "normalModeForwarding": true,
  "forwardGatewayServers": "text",
  "preferredBrokerId": 1,
  "forwardHttpServers": "text",
  "enableGatewayPort": true,
  "gatewayPort": 1,
  "onlyAllowAcmeHttp": true,
  "enableRDP": true,
  "rdpPort": 1,
  "broadcast": true,
  "enableRDPUDP": true,
  "enableDeviceManagerPort": true,
  "dosPro": true,
  "enableSSL": true,
  "sslPort": 1,
  "minSSLVersion": [
    "2 = TLSv1",
    "3 = TLSv1_1",
    "4 = TLSv1_2",
    "5 = TLSv1_3"
  ],
  "cipherStrength": [
    "0 = Low",
    "1 = Medium",
    "2 = High",
    "3 = Custom"
  ],
  "cipher": "text",
  "cipherPreference": true,
  "certificateId": 1,
  "enableHSTS": true,
  "hstsMaxAge": 1,
  "hstsIncludeSubdomains": true,
  "hstsPreload": true,
  "enableUserPortal": true,
  "userPortalPort": 1,
  "launchMethod": [
    "0 = ParallelsClientAndWebClient",
    "1 = ParallelsClient",
    "2 = WebClient"
  ],
  "allowLaunchMethod": true,
  "allowAppsInNewTab": true,
  "usePreWin2000LoginFormat": true,
  "allowEmbed": true,
  "allowFileTransfer": true,
  "fileTransferMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "allowClipboard": true,
  "clipboardDirection": [
    "0 = None",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "allowCORS": true,
  "browserCacheTimeInMonths": 1,
  "allowedDomainsForCORS": [
    "text"
  ],
  "enableAlternateNLBHost": true,
  "alternateNLBHost": "text",
  "enableAlternateNLBPort": true,
  "alternateNLBPort": 1,
  "enableWyseSupport": true,
  "disableWyseCertWarn": true,
  "securityMode": [
    "0 = AllowAllExcept",
    "1 = AllowOnly"
  ],
  "macAllowExcept": [
    "text"
  ],
  "macAllowOnly": [
    "text"
  ],
  "webRequestsURL": "text",
  "webCookie": "text",
  "useSecureWebCookie": true
}

Update

put

Modify the properties of a RAS Secure Gateway Server.

Path parameters

idinteger · int32Required

ID of the Gateway server to be updated

Body

application/json; api-version=1.0

Update a Secure Gateway settings

enabledboolean · nullableOptional

Enable or disable the specified Secure Gateway.

serverstring · min: 1 · max: 255 · nullableOptional

The new Secure Gateway name. The name must be either a valid FQDN or a valid IP address.

descriptionstring · nullableOptional

A user-defined Secure Gateway description.

publicAddressstring · nullableOptional

The Public Address of the Secure Gateway.

ipVersionstring · enumOptional

IP Version

Possible values:

iPsstring · min: 1 · max: 255 · nullableOptional

One or multiple (separated by comma) IP addresses.

bindV4Addressesstring · min: 1 · max: 255 · nullableOptional

IPv4 address to bind to. If '0.0.0.0' is passed, will bind to all available addresses. When using a specific address, it has to be available in the IPv4 address list.

optimizeConnectionIPv4string · max: 255 · nullableOptional

Optimize connection for the list of IPv4 (comma separated values).

bindV6Addressesstring · min: 1 · max: 255 · nullableOptional

IPv6 address to bind to. If '::' is passed, will bind to all available addresses. When using a specific address, it has to be available in the IPv6 address list.

optimizeConnectionIPv6string · max: 255 · nullableOptional

Optimize connection for the list of IPv6 (comma separated values).

inheritDefaultModeSettingsboolean · nullableOptional

Enable or disable default mode settings.

inheritDefaultNetworkSettingsboolean · nullableOptional

Enable or disable default network settings.

inheritDefaultSslTlsSettingsboolean · nullableOptional

Enable or disable default SSL/TLS setting.

inheritDefaultUserPortalSettingsboolean · nullableOptional

Enable or disable default User Portal settings.

inheritDefaultWyseSettingsboolean · nullableOptional

Enable or disable default wyse settings.

inheritDefaultSecuritySettingsboolean · nullableOptional

Enable or disable default security settingsd.

inheritDefaultWebSettingsboolean · nullableOptional

Enable or disable default web settings.

modestring · enumOptional

RAS Secure GateWay Mode

Possible values:

normalModeForwardingboolean · nullableOptional

Forward requests to HTTP server.

forwardGatewayServersstring · max: 255 · nullableOptional

One or multiple (separated by comma) Forwarding Gateway Servers. E.g. localhost:80, web1

autoPreferredBrokerbooleanOptional

Set preferred Connection Broker Automatically.

Default: false

preferredBrokerIdinteger · int32 · nullableOptional

The preferred Connection Broker ID.

forwardHttpServersstring · max: 255 · nullableOptional

One or multiple (separated by comma) Forwarding HTTP Servers. E.g. localhost:81, web1

enableGatewayPortboolean · nullableOptional

Enable or disable a custom RAS Secure Gateway port. To specify a custom port, set this parameter to True and use the GatewayPort parameter to specify the port number.

gatewayPortinteger · int32 · nullableOptional

A custom Gateway port number. For this port to take effect, the EnableGatewayPort parameters must be set to $True.

onlyAllowAcmeHttpboolean · nullableOptional

Whether to ignore all incoming requests except for Acme ones received on 'GatewayPort'

enableRDPboolean · nullableOptional

Enable or disable a custom RDP port. To specify a custom port number, use the RDPPort parameter.

rdpPortinteger · int32 · nullableOptional

A custom RDP port number. For this port to take effect, the EnableRDPPort parameter must be set to True.

broadcastboolean · nullableOptional

Enable or disable the 'Broadcast RAS Secure Gateway Address' option.

enableRDPUDPboolean · nullableOptional

Enable or disable the 'RDP UDP Data Tunneling' option.

enableDeviceManagerPortboolean · nullableOptional

Enable or disable the 'Device Manager Port' option.

dosProboolean · nullableOptional

Enable or disable the 'RDP DOS Attack Filter' option.

enableSSLboolean · nullableOptional

Enable or disable SSL on the port specified in the SSLPort parameter.

sslPortinteger · int32 · nullableOptional

SSL port number. To enable the port, set the EnableSSL port parameter to True.

minSSLVersionstring · enumOptional

Accepted SSL Versions

Possible values:

cipherStrengthstring · enumOptional

Cipher Strength

Possible values:

cipherstring · max: 255 · nullableOptional

Cipher string.

cipherPreferenceboolean · nullableOptional

Enable or disable Use ciphers according to server preference.

autoCertificatebooleanOptional

Set Certificate Automatically.

Default: false

certificateIdinteger · int32 · nullableOptional

The Certificate ID. Certificate Set Priority 2. This value will be ignored if a CertificateObj is specified.

enableHSTSboolean · nullableOptional

Enable or disable HSTS. To specify a custom HSTS Age, set this parameter to True and use the HSTSMaxAge parameter to specify the HSTS maximum age.

hstsMaxAgeinteger · int32 · nullableOptional

Specifies the HSTS maximum age.

hstsIncludeSubdomainsboolean · nullableOptional

Enable or disable the HSTS sub-domains.

hstsPreloadboolean · nullableOptional

Enable or disable the HSTS preload.

enableUserPortalboolean · nullableOptional

Enable or disable User Portal connectivity on the Gateway.

userPortalPortinteger · int32 · nullableOptional

A custom User Portal port number.

launchMethodstring · enumOptional

LaunchMethod

Possible values:

allowLaunchMethodboolean · nullableOptional

Allow users to select a resource launch method.

allowAppsInNewTabboolean · nullableOptional

Allow users to start applications in a new browser tab.

usePreWin2000LoginFormatboolean · nullableOptional

Enable or disable the 'Use Pre Windows 2000 Login Format' option.

allowEmbedboolean · nullableOptional

Allow embedding of Web Client into other web pages.

allowFileTransferboolean · nullableOptionalDeprecated

Deprecated: use FileTransferMode instead. Enable or disable the 'Allow file transfer' option.

fileTransferModestring · enumOptional

File Transfer Control modes.

Possible values:

allowClipboardboolean · nullableOptionalDeprecated

Enable or disable the 'Allow Clipboard' option.

clipboardDirectionstring[Flag] · enumOptional

Clipboard Direction Type.

Possible values:

allowCORSboolean · nullableOptional

Allow cross-origin resource sharing.

allowedDomainsForCORSstring[] · nullableOptional

Allowed domains for cross-origin resource sharing.

browserCacheTimeInMonthsinteger · int32 · nullableOptional

How long should the browser preserve the cache (in months).

enableAlternateNLBHostboolean · nullableOptional

Enable or disable Alternate NLB host name specified in the EnableAlternateNLBHost parameter.

alternateNLBHoststring · min: 1 · max: 255 · nullableOptional

Alternate NLB host name. To enable the host name, set the EnableAlternateNLBHost port parameter to True.

enableAlternateNLBPortboolean · nullableOptional

Enable or disable Alternate NLB on the port specified in the AlternateNLBPort parameter.

alternateNLBPortinteger · int32 · nullableOptional

Alternate NLB port number. To enable the port, set the EnableAlternateNLBPort port parameter to True.

enableWyseSupportboolean · nullableOptional

Enable or disable Wyse ThinOS support.

disableWyseCertWarnboolean · nullableOptional

Enable or disable the warning if server certificate is not verified.

securityModestring · enumOptional

Security Mode

Possible values:

macAllowExceptstring[] · nullableOptional

Specifies the Security 'MAC Allow Except' MAC addresses.

macAllowOnlystring[] · nullableOptional

Specifies the Security 'MAC Allow Only' MAC addresses.

webRequestsURLstring · max: 255 · nullableOptional

Set a URL for Web requests. This is the URL that will open when a user enters the IP address of the RAS Secure Gateway server in a web browser. For the URL to work, the gateway mode must be set to Normal.

webCookiestring · max: 255 · nullableOptional

Set the Web Cookie Name used by RAS.

useSecureWebCookieboolean · nullableOptional

Enable or disable the addition of the secure attribute to the cookie to the Web Cookie.

Responses

204

No Content

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

put

/api/Gateway/{id}

HTTPcURLJavaScriptPython

PUT /api/Gateway/{id} HTTP/1.1
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 2038

{
  "enabled": true,
  "server": "text",
  "description": "text",
  "publicAddress": "text",
  "ipVersion": [
    "0 = Version4",
    "1 = Version6",
    "2 = BothVersions"
  ],
  "iPs": "text",
  "bindV4Addresses": "text",
  "optimizeConnectionIPv4": "text",
  "bindV6Addresses": "text",
  "optimizeConnectionIPv6": "text",
  "inheritDefaultModeSettings": true,
  "inheritDefaultNetworkSettings": true,
  "inheritDefaultSslTlsSettings": true,
  "inheritDefaultUserPortalSettings": true,
  "inheritDefaultWyseSettings": true,
  "inheritDefaultSecuritySettings": true,
  "inheritDefaultWebSettings": true,
  "mode": [
    "0 = Normal",
    "1 = Forwarding"
  ],
  "normalModeForwarding": true,
  "forwardGatewayServers": "text",
  "autoPreferredBroker": false,
  "preferredBrokerId": 1,
  "forwardHttpServers": "text",
  "enableGatewayPort": true,
  "gatewayPort": 1,
  "onlyAllowAcmeHttp": true,
  "enableRDP": true,
  "rdpPort": 1,
  "broadcast": true,
  "enableRDPUDP": true,
  "enableDeviceManagerPort": true,
  "dosPro": true,
  "enableSSL": true,
  "sslPort": 1,
  "minSSLVersion": [
    "2 = TLSv1",
    "3 = TLSv1_1",
    "4 = TLSv1_2",
    "5 = TLSv1_3"
  ],
  "cipherStrength": [
    "0 = Low",
    "1 = Medium",
    "2 = High",
    "3 = Custom"
  ],
  "cipher": "text",
  "cipherPreference": true,
  "autoCertificate": false,
  "certificateId": 1,
  "enableHSTS": true,
  "hstsMaxAge": 1,
  "hstsIncludeSubdomains": true,
  "hstsPreload": true,
  "enableUserPortal": true,
  "userPortalPort": 1,
  "launchMethod": [
    "0 = ParallelsClientAndWebClient",
    "1 = ParallelsClient",
    "2 = WebClient"
  ],
  "allowLaunchMethod": true,
  "allowAppsInNewTab": true,
  "usePreWin2000LoginFormat": true,
  "allowEmbed": true,
  "fileTransferMode": [
    "0 = Disabled",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "clipboardDirection": [
    "0 = None",
    "1 = ClientToServer",
    "2 = ServerToClient",
    "3 = Bidirectional"
  ],
  "allowCORS": true,
  "allowedDomainsForCORS": [
    "text"
  ],
  "browserCacheTimeInMonths": 1,
  "enableAlternateNLBHost": true,
  "alternateNLBHost": "text",
  "enableAlternateNLBPort": true,
  "alternateNLBPort": 1,
  "enableWyseSupport": true,
  "disableWyseCertWarn": true,
  "securityMode": [
    "0 = AllowAllExcept",
    "1 = AllowOnly"
  ],
  "macAllowExcept": [
    "text"
  ],
  "macAllowOnly": [
    "text"
  ],
  "webRequestsURL": "text",
  "webCookie": "text",
  "useSecureWebCookie": true
}

No content

Delete

delete

Delete a RAS Secure Gateway Server.

Path parameters

idinteger · int32Required

ID of the Gateway server to be deleted

Query parameters

noUninstallbooleanOptional

When this parameter is included, the Gateway software will not be removed from the server. If you want to remove the software, omit this parameter. When removing the software, your RAS admin credentials will be used to remotely execute the uninstaller on the target server. You can specify different credentials if needed using the Username and Password parameters.

usernamestringOptional

An administrator account name to remotely uninstall the Gateway software from the server. If this parameter is omitted, your RAS admin username (and password) will be used.

passwordstringOptional

The password of the account specified in the Username parameter.

Responses

204

No Content

401

Unauthorized

application/json; api-version=1.0

404

Not Found

application/json; api-version=1.0

delete

/api/Gateway/{id}

HTTPcURLJavaScriptPython

DELETE /api/Gateway/{id} HTTP/1.1
Accept: */*

No content