nwtargets

Download Spec

PrivX Network Targets

get /network-access-manager/api/v1/nwtargets

Get network targets

offset

int

Offset from which to start fetching objects

Default
0

limit

int

Maximum number of objects to return

Default
50

sortkey

string

Sorting key

Default
"id"
Enum
  • id
  • name
  • comment
  • user_instructions
  • disabled
  • exclusive_access
  • created
  • updated

sortdir

string

Sorting direction

Default
"ASC"
Enum
  • ASC
  • DESC

name

string

The name of the network target

id

string

uuid

The ID of the network target

Response

ExamplesSchema

Authentication succesful

{
  "count": 123,
  "items": [
    {
      "id": "5bf77342-221c-11ee-be56-0242ac120002",
      "created": "2017-01-01T15:05:05Z",
      "updated": "2017-01-01T15:05:05Z",
      "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "comment": "A comment",
      "name": "string",
      "user_instructions": "string",
      "src_nat": true,
      "roles": [
        {
          "id": "string",
          "name": "string",
          "deleted": true
        }
      ],
      "dst": [
        {
          "selector": {
            "ip": {
              "start": "string",
              "end": "string"
            },
            "port": {
              "start": 123,
              "end": 123
            },
            "proto": "udp"
          },
          "nat": {
            "addr": "string",
            "port": 123
          }
        }
      ],
      "exclusive_access": true,
      "disabled": null,
      "tags": [
        "string"
      ]
    }
  ]
}

post /network-access-manager/api/v1/nwtargets

Create network target

id

string

uuid

A unique identifier for the user

created

string

date-time

When the object was created

Example
"2017-01-01T15:05:05Z"

updated

string

date-time

When the object was updated

Example
"2017-01-01T15:05:05Z"

updated_by

string

uuid

ID of the user who updated the object

Example
"eef4aefc-d64e-4c2c-aba4-4914c86ce059"

author

string

uuid

ID of the user who originally authored the object

Example
"eef4aefc-d64e-4c2c-aba4-4914c86ce059"

comment

string

A comment describing the object

Example
"A comment"

name

string

required

A unique name for the network target

user_instructions

string

User instructions shown in UI

src_nat

boolean

Flag to enable source NATing

roles

array[object]

required

dst

array[object]

required

exclusive_access

boolean

Allow only one ongoing network access session at a time to this network target.

disabled

string

Network target disabled status

tags

array[string]

Tags

Request

{
  "id": "5bf77342-221c-11ee-be56-0242ac120002",
  "created": "2017-01-01T15:05:05Z",
  "updated": "2017-01-01T15:05:05Z",
  "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "comment": "A comment",
  "name": "string",
  "user_instructions": "string",
  "src_nat": true,
  "roles": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "dst": [
    {
      "selector": {
        "ip": {
          "start": "string",
          "end": "string"
        },
        "port": {
          "start": 123,
          "end": 123
        },
        "proto": "udp"
      },
      "nat": {
        "addr": "string",
        "port": 123
      }
    }
  ],
  "exclusive_access": true,
  "disabled": null,
  "tags": [
    "string"
  ]
}

Response

ExamplesSchema

Network target successfully created

{
  "id": "5bf77342-221c-11ee-be56-0242ac120002"
}

post /network-access-manager/api/v1/nwtargets/search

Search network targets

keywords

string

comma or space separated list of search keywords

tags

array[string]

tags to search, network target tags will be searched using case-insensitive exact matching

Request

{
  "keywords": "string",
  "tags": [
    "string"
  ]
}

Response

ExamplesSchema

Network target search succeeded

{
  "count": 123,
  "items": [
    {
      "id": "5bf77342-221c-11ee-be56-0242ac120002",
      "created": "2017-01-01T15:05:05Z",
      "updated": "2017-01-01T15:05:05Z",
      "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
      "comment": "A comment",
      "name": "string",
      "user_instructions": "string",
      "src_nat": true,
      "roles": [
        {
          "id": "string",
          "name": "string",
          "deleted": true
        }
      ],
      "dst": [
        {
          "selector": {
            "ip": {
              "start": "string",
              "end": "string"
            },
            "port": {
              "start": 123,
              "end": 123
            },
            "proto": "udp"
          },
          "nat": {
            "addr": "string",
            "port": 123
          }
        }
      ],
      "exclusive_access": true,
      "disabled": null,
      "tags": [
        "string"
      ]
    }
  ]
}

get /network-access-manager/api/v1/nwtargets/tags

Get list of network targets' tags.

offset

int

Offset from which to start fetching objects

Default
0

limit

int

Maximum number of objects to return

Default
50

sortdir

string

Sorting direction

Default
"ASC"
Enum
  • ASC
  • DESC

query

string

Query string matches the tags

Response

ExamplesSchema

Successfully returned network targets' tags

{
  "count": 123,
  "items": [
    "string"
  ]
}

get /network-access-manager/api/v1/nwtargets/{id}

id

string

uuid

required

Network Target ID

Response

ExamplesSchema

Successful response, returns a user object

{
  "id": "5bf77342-221c-11ee-be56-0242ac120002",
  "created": "2017-01-01T15:05:05Z",
  "updated": "2017-01-01T15:05:05Z",
  "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "comment": "A comment",
  "name": "string",
  "user_instructions": "string",
  "src_nat": true,
  "roles": [
    {
      "id": "string",
      "name": "string",
      "deleted": true
    }
  ],
  "dst": [
    {
      "selector": {
        "ip": {
          "start": "string",
          "end": "string"
        },
        "port": {
          "start": 123,
          "end": 123
        },
        "proto": "udp"
      },
      "nat": {
        "addr": "string",
        "port": 123
      }
    }
  ],
  "exclusive_access": true,
  "disabled": null,
  "tags": [
    "string"
  ]
}

put /network-access-manager/api/v1/nwtargets/{id}

Update a network target

id

string

uuid

A unique identifier for the user

created

string

date-time

When the object was created

Example
"2017-01-01T15:05:05Z"

updated

string

date-time

When the object was updated

Example
"2017-01-01T15:05:05Z"

updated_by

string

uuid

ID of the user who updated the object

Example
"eef4aefc-d64e-4c2c-aba4-4914c86ce059"

author

string

uuid

ID of the user who originally authored the object

Example
"eef4aefc-d64e-4c2c-aba4-4914c86ce059"

comment

string

A comment describing the object

Example
"A comment"

name

string

required

A unique name for the network target

user_instructions

string

User instructions shown in UI

src_nat

boolean

Flag to enable source NATing

roles

array[object]

required

dst

array[object]

required

exclusive_access

boolean

Allow only one ongoing network access session at a time to this network target.

disabled

string

Network target disabled status

tags

array[string]

Tags

Request

{
  "id": "5bf77342-221c-11ee-be56-0242ac120002",
  "created": "2017-01-01T15:05:05Z",
  "updated": "2017-01-01T15:05:05Z",
  "updated_by": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "author": "eef4aefc-d64e-4c2c-aba4-4914c86ce059",
  "comment": "A comment",
  "name": "string",
  "user_instructions": "string",
  "src_nat": true,
  "roles": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "dst": [
    {
      "selector": {
        "ip": {
          "start": "string",
          "end": "string"
        },
        "port": {
          "start": 123,
          "end": 123
        },
        "proto": "udp"
      },
      "nat": {
        "addr": "string",
        "port": 123
      }
    }
  ],
  "exclusive_access": true,
  "disabled": null,
  "tags": [
    "string"
  ]
}

Response

ExamplesSchema

Network target successfully updated

Empty response

delete /network-access-manager/api/v1/nwtargets/{id}

Delete a network target

id

string

uuid

required

Network target ID

Response

ExamplesSchema

Network target successfully deleted

Empty response

put /network-access-manager/api/v1/nwtargets/{id}/disabled

disabled

boolean

disabled flag: true/false

Request

{
  "disabled": true
}