Skip to main content

Create a new user group

Attributes

  • name (string): A unique identifier for the user group.

  • allCovered (boolean): Set to true if all VPN regions are accessible. Any new regions added will automatically be accessible to this group.

  • internetAccess (string): Determines the internet access level for the user group. Supported values:

    • RESTRICTED_INTERNET: Private and trusted internet traffic is tunneled; all other internet traffic is blocked.

    • SPLIT_TUNNEL_OFF: All traffic is tunneled; internet traffic exits from selected Internet Gateways.

    • SPLIT_TUNNEL_ON: Private and trusted internet traffic is tunneled; all other internet traffic uses local internet.

  • maxDevice (integer): The maximum number of devices allowed per user in this group.

  • connectAuth (string): The authentication mode for connections. Supported values:

    • NO_AUTH: No authentication required.

    • ON_PRIOR_AUTH: Authentication is required on prior timeout.

    • EVERY_TIME: Authentication is required each time.

  • allRegionsIncluded (boolean): Set to true to include all current and future regions by default.

  • gatewaysIds (string): The network gateway’s unique identifier. Leave empty if internet access is restricted or Split Tunnel On used for a User Group.

Body parameter
{
  "name": "string",
  "vpnRegionIds": [
    "string"
  ],
  "internetAccess": "SPLIT_TUNNEL_ON",
  "maxDevice": 0,
  "connectAuth": "NO_AUTH",
  "allRegionsIncluded": true,
  "gatewaysIds": [
    "string"
  ]
}

Parameters

Name

In

Type

Required

Description

body

body

UserGroupRequest

true

none

» name

body

string

false

none

» vpnRegionIds

body

[string]

false

none

» internetAccess

body

string

false

none

» maxDevice

body

integer(int32)

false

none

» connectAuth

body

string

false

none

» allRegionsIncluded

body

boolean

false

none

» gatewaysIds

body

[string]

false

none

Enumerated Values

Parameter

Value

» internetAccess

SPLIT_TUNNEL_ON

» internetAccess

SPLIT_TUNNEL_OFF

» internetAccess

RESTRICTED_INTERNET

» connectAuth

NO_AUTH

» connectAuth

ON_PRIOR_AUTH

» connectAuth

EVERY_TIME

Responses

Status

Meaning

Description

Schema

201

Created

Created

UserGroupResponse

To perform this operation, you must be authenticated by means of one of the following methods: oauth

Can't find what you're looking for?

Our support team will be happy to assist you.