Skip to main content

Add new source to an existing access group

POST /api/v1/access-groups/{id}/source

Sources can be defined as specific resources or as all resources of a certain type (including both existing and newly created ones).

Examples:

  1. All Networks

"source": [
  {
    "type": "NETWORK_SERVICE",
    "allCovered": true
  }
],

This configuration allows all networks, including their applications and IP services, to access this access group’s destination resources.

  1. Specific Network

"source": [
 {
   "type": "NETWORK_SERVICE",
   "parent": "00000000-0000-0000-0000-000000000001",
   "allCovered": true
 }
],

This configuration allows a specific network with ID 00000000-0000-0000-0000-000000000001, including its applications and IP services, to access this access group’s destination resources.

  1. Specific IP Service within a Network

"source": [
  {
    "type": "NETWORK_SERVICE",
    "parent": "00000000-0000-0000-0000-000000000001",
    "children": ["00000000-0000-0000-0000-000000000002"]
    "allCovered": true
  }
],

This configuration allows a specific IP service with ID 00000000-0000-0000-0000-000000000002 within a network with ID 00000000-0000-0000-0000-000000000001 to access this access group’s destination resources.’

Body parameter
{
  "type": "USER_GROUP",
  "allCovered": true,
  "parent": "00000000-0000-0000-0000-000000000000",
  "children": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Parameters

Name

In

Type

Required

Description

id

path

string

true

Access group ID

body

body

AccessItemSourceRequest

true

none

» type

body

string

false

none

» allCovered

body

boolean

false

none

» parent

body

string

false

none

» children

body

[string]

false

none

Enumerated Values

Parameter

Value

» type

USER_GROUP

» type

NETWORK_SERVICE

» type

HOST

Responses

Status

Meaning

Description

Schema

200

OK

OK

AccessGroupResponse

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

In this section: