Product Documentation

vpnintranetapplication

Sep 08, 2016

Configuration for SSLVPN intranet application resource.

Properties (click to see Operations)

Name Data Type Permissions Description
intranetapplication
<String>
Read-write
Name of the intranet application.
Minimum length = 1
Maximum length = 31
protocol
<String>
Read-write
Protocol used by the intranet application. If protocol is set to BOTH, TCP and UDP traffic is allowed.
Possible values = TCP, UDP, ANY
destip
<String>
Read-write
Destination IP address, IP range, or host name of the intranet application. This address is the server IP address.
Minimum length = 1
netmask
<String>
Read-write
Destination subnet mask for the intranet application.
iprange
<String>
Read-write
If you have multiple servers in your network, such as web, email, and file shares, configure an intranet application that includes the IP range for all the network applications. This allows users to access all the intranet applications contained in the IP address range.
Minimum length = 1
hostname
<String>
Read-write
Name of the host for which to configure interception. The names are resolved during interception when users log on with the NetScaler Gateway Plug-in.
Minimum length = 1
clientapplication
<String[]>
Read-write
Names of the client applications, such as PuTTY and Xshell.
Minimum length = 1
spoofiip
<String>
Read-write
IP address that the intranet application will use to route the connection through the virtual adapter.
Default value: ON
Possible values = ON, OFF
destport
<String>
Read-write
Destination TCP or UDP port number for the intranet application. Use a hyphen to specify a range of port numbers, for example 90-95.
Minimum length = 1
interception
<String>
Read-write
Interception mode for the intranet application or resource. Correct value depends on the type of client software used to make connections. If the interception mode is set to TRANSPARENT, users connect with the NetScaler Gateway Plug-in for Windows. With the PROXY setting, users connect with the NetScaler Gateway Plug-in for Java.
Possible values = PROXY, TRANSPARENT
srcip
<String>
Read-write
Source IP address. Required if interception mode is set to PROXY. Default is the loopback address, 127.0.0.1.
Minimum length = 1
srcport
<Integer>
Read-write
Source port for the application for which the NetScaler Gateway virtual server proxies the traffic. If users are connecting from a device that uses the NetScaler Gateway Plug-in for Java, applications must be configured manually by using the source IP address and TCP port values specified in the intranet application profile. If a port value is not set, the destination port value is used.
Minimum value = 1
ipaddress
<String>
Read-only
The IP address for the application. This address is the real application server IP address.
__count
<Double>
Read-only
count parameter

Operations (click to see Properties)

Some options that you can use for each operations:

  • Getting warnings in response: NITRO allows you to get warnings in an operation by specifying the "warning" query parameter as "yes". For example, to get warnings while connecting to the NetScaler appliance, the URL is as follows:

    http://<netscaler-ip-address>/nitro/v1/config/login?warning=yes

    If any, the warnings are displayed in the response payload with the HTTP code "209 X-NITRO-WARNING".

  • Authenticated access for individual NITRO operations: NITRO allows you to logon to the NetScaler appliance to perform individual operations. You can use this option instead of creating a NITRO session (using the login object) and then using that session to perform all operations,

    To do this, you must specify the username and password in the request header of the NITRO request as follows:

    X-NITRO-USER:<username>

    X-NITRO-PASS:<password>

    Note: In such cases, make sure that the request header DOES not include the following:

    Cookie:NITRO_AUTH_TOKEN=<tokenvalue>

메모

Mandatory parameters are marked in red and placeholder content is marked in <green>.

add

URL: http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication

HTTP Method: POST

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Content-Type:application/json

Request Payload:

{"vpnintranetapplication":{
      "intranetapplication":<String_value>,
      "protocol":<String_value>,
      "destip":<String_value>,
      "netmask":<String_value>,
      "iprange":<String_value>,
      "hostname":<String_value>,
      "clientapplication":<String[]_value>,
      "spoofiip":<String_value>,
      "destport":<String_value>,
      "interception":<String_value>,
      "srcip":<String_value>,
      "srcport":<Integer_value>
}}

Response:

HTTP Status Code on Success: 201 Created
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

delete

URL: http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication/intranetapplication_value<String>

HTTP Method: DELETE

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

get (all)

URL: http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication

Query-parameters:

attrs

http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication?attrs=property-name1,property-name2

Use this query parameter to specify the resource details that you want to retrieve.

filter

http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication?filter=property-name1:property-val1,property-name2:property-val2

Use this query-parameter to get the filtered set of vpnintranetapplication resources configured on NetScaler.Filtering can be done on any of the properties of the resource.

view

http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication?view=summary

Note: By default, the retrieved results are displayed in detail view (?view=detail).

pagination

http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication?pagesize=#no&pageno=#no

Use this query-parameter to get the vpnintranetapplication resources in chunks.

HTTP Method: GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Accept:application/json

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "vpnintranetapplication": [ {
      "intranetapplication":<String_value>,
      "protocol":<String_value>,
      "destip":<String_value>,
      "netmask":<String_value>,
      "ipaddress":<String_value>,
      "hostname":<String_value>,
      "destport":<String_value>,
      "clientapplication":<String[]_value>,
      "spoofiip":<String_value>,
      "interception":<String_value>,
      "srcip":<String_value>,
      "srcport":<Integer_value>
}]}

get

URL: http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication/intranetapplication_value<String>

Query-parameters:

attrs

http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication/intranetapplication_value<String>?attrs=property-name1,property-name2

Use this query parameter to specify the resource details that you want to retrieve.

view

http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication/intranetapplication_value<String>?view=summary

Note: By default, the retrieved results are displayed in detail view (?view=detail).

HTTP Method: GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Accept:application/json

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "vpnintranetapplication": [ {
      "intranetapplication":<String_value>,
      "protocol":<String_value>,
      "destip":<String_value>,
      "netmask":<String_value>,
      "ipaddress":<String_value>,
      "hostname":<String_value>,
      "destport":<String_value>,
      "clientapplication":<String[]_value>,
      "spoofiip":<String_value>,
      "interception":<String_value>,
      "srcip":<String_value>,
      "srcport":<Integer_value>
}]}

count

URL: http://<netscaler-ip-address>/nitro/v1/config/vpnintranetapplication?count=yes

HTTP Method: GET

Request Headers:

Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
Accept:application/json

Response:

HTTP Status Code on Success: 200 OK
HTTP Status Code on Failure: 4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "vpnintranetapplication": [ { "__count": "#no"} ] }