Parallels REST API
ProductsSupportPartnersDocumentation
  • About
  • API reference
    • Infrastructure
      • Agents
        • Logs
        • Diagnostics
          • Broker
          • Enrollment Server
          • Gateway
          • Guest
          • HALB Device
          • Provider
          • RDS
      • Application Packages
        • MSIX Image
          • Details
      • AVD
        • Custom Host
          • All
        • Gallery
          • Image
        • Host Pool
          • App Package Assigned
          • Assignment
          • Auto Upgrade
            • Messages
          • Create Hosts
          • Existing
          • Optimization
            • Registry
            • Windows Component
            • Windows Scheduled Task
            • Windows Service
          • Recreate Hosts
          • Repair
          • Schedule
            • Disable
            • Messages
            • Reboot
            • Shutdown
            • Startup
            • Target
          • Status
          • FSLogix
            • General
            • Office Container
              • CCD Locations
              • User Exclusion
              • User Inclusion
              • VHD Locations
            • Profile Container
              • CCD Locations
              • Folder Exclusion
              • Folder Inclusion
              • User Exclusion
              • User Inclusion
              • VHD Locations
        • Location
        • Offer
        • Predefined Images
        • Publisher
        • Resource Group
        • Settings
        • SKU
        • Template
          • Enter Maintenance
          • Exit Maintenance
          • Optimization
            • Registry
            • Windows Component
            • Windows Scheduled Task
            • Windows Service
          • Recreate Desktops
          • Repair
          • Status
          • Version
          • VersionStatus
        • Version
        • Virtual Network
        • Workspace
          • Existing
          • Repair
          • Status
        • Default Settings
          • Multi Session
            • Application Package Assigned
            • Auto Upgrade
              • Messages
            • Optimization
              • Registry
              • Windows Component
              • Windows Scheduled Task
              • Windows Service
            • FSLogix
              • General
              • Office Container
                • CCD Locations
                • User Exclusion
                • User Inclusion
                • VHD Locations
              • Profile Container
                • CCD Locations
                • Folder Exclusion
                • Folder Inclusion
                • User Exclusion
                • User Inclusion
                • VHD Locations
          • Single Session
            • Application Package Assigned
            • Auto Upgrade
              • Messages
            • Optimization
              • Registry
              • Windows Component
              • Windows Scheduled Task
              • Windows Service
            • FSLogix
              • General
              • Office Container
                • CCD Locations
                • User Exclusion
                • User Inclusion
                • VHD Locations
              • Profile Container
                • CCD Locations
                • Folder Exclusion
                • Folder Inclusion
                • User Exclusion
                • User Inclusion
                • VHD Locations
        • VM Size
          • Provider
          • Workspace
        • Subnets
      • Certificates
        • Export
        • Generate Lets Encrypt
        • Generate Request
        • Generate Self Signed
        • Import Certificate
        • Import Pfx
        • Import Public Key
        • Renew
        • Retry
        • Revoke
        • Update Intermediate
        • Lets Encrypt Settings
          • EULA
      • Connection Brokers
        • Priority
        • Promote
        • Status
        • Broker Promotion
      • Enrollment Servers
        • Status
      • HALBs
        • Device
        • Status
      • Providers
        • Avd
        • Awsec2
        • Azure
        • Hyperv
        • Hypervfailover
        • Nutanix
        • Remote PC dynamic
        • Remote PC static
          • Remote PC
            • Import
        • Scale
        • Status
        • Vcenter
        • VM
          • AVD Host
            • Schedule
              • Disable
              • Messages
              • Reboot
              • Shutdown
              • Startup
              • Target
            • Session
              • Processes
            • Standalone
            • Status
            • Templated
          • Reset
          • Restart
          • Start
          • Stop
          • Suspend
          • VDI Host
            • Assignment
            • Disconnect
            • LogOff
            • Schedule
              • Disable
              • Messages
              • Reboot
              • Shutdown
              • Startup
              • Target
            • SendMsg
            • Session
              • Processes
            • Status
          • Host
            • Process
              • Kill
            • Status
        • Vmwareesxi
      • RD Session Hosts
        • RDS Default Settings
          • App Package Assigned
          • Auto Upgrade
            • Messages
          • Optimization
            • Registry
            • Windows Component
            • Windows Scheduled Task
            • Windows Service
          • FSLogix
            • General
            • Office Container
              • CCD Locations
              • User Exclusion
              • User Inclusion
              • VHD Locations
            • ProfileContainer
              • CCD Locations
              • Folder Exclusion
              • Folder Inclusion
              • User Exclusion
              • User Inclusion
              • VHD Locations
        • RDS
          • Host
            • AppPackageAssigned
            • CancelDisabledState
            • CancelPendingReboot
            • DisableLogonsAndReconnections
            • Drain
            • DrainUntilReboot
            • EnableLogons
            • InstallRDSRole
            • Optimization
              • Registry
              • WindowsComponent
              • WindowsScheduledTask
              • WindowsService
              • Predefined
                • WindowsComponent
                • WindowsScheduledTask
                • WindowsService
            • Reboot
            • Schedule
              • Disable
              • Messages
              • Reboot
              • Shutdown
              • Startup
              • Target
            • Sessions
              • Disconnect
              • Logoff
              • Processes
                • Kill
              • Sendmsg
            • Shutdown
            • Status
            • FSLogix
              • General
              • OfficeContainer
                • CCDLocations
                • UserExclusion
                • UserInclusion
                • VHDLocations
              • ProfileContainer
                • CCDLocations
                • FolderExclusion
                • FolderInclusion
                • UserExclusion
                • UserInclusion
                • VHDLocations
          • HostPool
            • AppPackageAssigned
            • AutoUpgrade
              • Messages
            • CancelDisabledState
            • CancelPendingReboot
            • CancelPendingShutdown
            • CreateHosts
            • Members
            • RecreateHosts
            • Schedule
              • Disable
              • Messages
              • Reboot
              • Shutdown
              • Startup
              • Target
            • Status
            • FSLogix
              • General
              • OfficeContainer
                • CCDLocations
                • UserExclusion
                • UserInclusion
                • VHDLocations
              • ProfileContainer
                • CCDLocations
                • FolderExclusion
                • FolderInclusion
                • UserExclusion
                • UserInclusion
                • VHDLocations
          • Template
            • EnterMaintenance
            • ExitMaintenance
            • LicenseKey
            • Optimization
              • Registry
              • WindowsComponent
              • WindowsScheduledTask
              • WindowsService
            • RecreateDesktops
            • Status
            • Version
            • VersionStatus
      • SAML IDPs
        • Duplicate
      • Gateway
        • Certificate
        • Private Key
        • Status
        • Gateway Default Settings
        • Tests a URL that leads to a client IP detection service
      • Sites
        • Status
      • Themes
        • Footer URL
        • Group Filter
        • Image
        • Custom Images
      • Tunneling Policies
        • Basic Operations
        • Listing, Updating, and Deleting
      • VDI
        • Host Pool
          • AppPackageAssigned
          • AutoUpgrade
            • Messages
          • CreateHosts
          • Members
          • Optimization
            • Registry
            • WindowsComponent
            • WindowsScheduledTask
            • WindowsService
          • RecreateHosts
          • Schedule
            • Disable
            • Messages
            • Reboot
            • Shutdown
            • Startup
            • Target
          • FSLogix
            • General
            • OfficeContainer
              • CCDLocations
              • UserExclusion
              • UserInclusion
              • VHDLocations
            • ProfileContainer
              • CCDLocations
              • FolderExclusion
              • FolderInclusion
              • UserExclusion
              • UserInclusion
              • VHDLocations
        • Template
          • EnterMaintenance
          • ExitMaintenance
          • LicenseKey
          • Optimization
            • Registry
            • WindowsComponent
            • WindowsScheduledTask
            • WindowsService
          • RecreateDesktops
          • Status
          • Version
          • VersionStatus
        • Optimization
          • Predefined
            • WindowsComponent
            • WindowsScheduledTask
            • WindowsService
        • VDI Default Settings
          • AppPackageAssigned
          • AutoUpgrade
            • Messages
          • Optimization
            • Registry
            • WindowsComponent
            • WindowsScheduledTask
            • WindowsService
          • FSLogix
            • General
            • OfficeContainer
              • CCDLocations
              • UserExclusion
              • UserInclusion
              • VHDLocations
            • ProfileContainer
              • CCDLocations
              • FolderExclusion
              • FolderInclusion
              • UserExclusion
              • UserInclusion
              • VHDLocations
    • Farm settings
      • Administrator Sessions
        • Current Admin Permissions
        • Logoff
        • Logon
      • Administrators
        • Custom Permission
        • Move to Group
        • Power Permission
      • Farm
      • Invitation Emails
        • Invite
      • Licensing
        • Activate
        • Deactivate
      • Mailbox
        • Test
      • Performance Monitor
      • Printing and Scanning
      • Reporting
      • Settings
        • Apply
        • Export
        • Import
      • WebService
        • Settings
          • Import Certificate
        • Version
    • Site settings
      • AD Integration
        • Validate
      • Application Packages
        • Tags
        • Application Package Available Versions
      • Clients
      • Connection and Authentication
        • Connection Settings
          • Clear Session Cache
        • Connection Allowed Devices
        • Custom Routes
      • CPU Optimization
      • FSLogix
        • Profile Container
          • Upload Installer
      • Load Balancing
      • Logon Hours
        • Criteria
          • Devices
          • Gateway IPs
          • Hardware IDs
          • IPs
          • OSes
          • Security Principals
          • Themes
        • Day Plan
        • Order
      • MFA
        • Check Connection
        • Criteria
          • Devices
          • Gateway IPs
          • Hardware IDs
          • IPs
          • OSes
          • Security Principals
        • Deepnet
        • Duplicate
        • Email OTP
        • Radius
        • Radius Attributes
        • Radius Auto Info
        • Safenet
        • TOTP
        • Validate AD Access
        • MFA Default Settings
          • Criteria
            • Devices
            • Gateway IPs
            • Hardware IDs
            • IPs
            • OSes
            • Security Principals
        • Details
      • Notifications
        • Events
        • Resources
        • Notification Scripts
      • Printing
        • Auto Install Fonts
      • Proxy
      • Scanning
      • System
      • Template
      • Tenant Broker
        • Join
        • Status
        • Settings
        • Unjoin
      • URL Redirection
        • Entry
      • Windows Device Groups
        • Inbound Port
    • Publishing
      • PubIished tems
      • Client Filters
      • Copy
      • Filter
      • Folders
        • Sort
      • Gateway Filters
      • Icon
      • IP Filters
      • MAC Filters
      • Move
      • OS Filters
      • Preferred Route
      • Rules
        • Criteria
          • Devices
          • Gateway IPs
          • Hardware IDs
          • IPs
          • OSes
          • Security Principals
          • Themes
      • Status
      • User Filters
      • Apps
        • AVD
        • File Extensions
        • RDS
          • Server Attribute
        • VDI
        • Local
      • Desktops
        • AVD
        • RDS
        • VDI
      • Publised resources Default Settings
    • Policies
      • Assignment
      • Duplicate
      • Export
      • Gateway Filters
      • Import
      • MAC Filters
      • Order
      • Rules
        • Criteria
          • Gateway IPs
          • Hardware IDs
          • IPs
          • OSes
          • Security Principals
      • Secondary Connections
      • User Group
    • RD Sessions
    • Help and support
      • Helpdesk Email Settings
      • Support
        • Download Report
        • Send Support Request
        • Send System Report
        • Overwrite Support Actions
  • Examples
    • Basic Sample
    • RDS Sample
    • Publishing Sample
    • Connection Broker and Secure Gateway Sample
    • Licensing Sample
Powered by GitBook

© 2025 Parallels International GmbH. All rights reserved.

On this page

Was this helpful?

Export as PDF
  1. API reference
  2. Infrastructure

Gateway

PreviousDuplicateNextCertificate

Was this helpful?

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
401
Unauthorized
application/json; api-version=1.0
404
Not Found
application/json; api-version=1.0
get
GET /api/Gateway/{id} HTTP/1.1
Host: 
Accept: */*
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-05-23T10:49:46.576Z",
  "timeLastMod": "2025-05-23T10:49:46.576Z",
  "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
}

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
DELETE /api/Gateway/{id} HTTP/1.1
Host: 
Accept: */*

No content

Update

put

Modify the properties of a RAS Secure Gateway Server.

Path parameters
idinteger · int32Required

ID of the Gateway server to be updated

Body

Update a Secure Gateway settings

enabledboolean | nullableOptional

Enable or disable the specified Secure Gateway.

serverstring | 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 | nullableOptional

One or multiple (separated by comma) IP addresses.

bindV4Addressesstring | 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 | nullableOptional

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

bindV6Addressesstring | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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
PUT /api/Gateway/{id} HTTP/1.1
Host: 
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

  • GETList
  • POSTCreate
  • GETGet
  • PUTUpdate
  • DELETEDelete

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
401
Unauthorized
application/json; api-version=1.0
404
Not Found
application/json; api-version=1.0
get
GET /api/Gateway HTTP/1.1
Host: 
Accept: */*
[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-05-23T10:49:46.576Z",
    "timeLastMod": "2025-05-23T10:49:46.576Z",
    "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

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
POST /api/Gateway HTTP/1.1
Host: 
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": "2025-05-23T10:49:46.576Z",
  "timeLastMod": "2025-05-23T10:49:46.576Z",
  "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
}