Download full document:

vpnintranetapplication

Configuration for SSLVPN intranet application resource.

Properties

(click to see Operations)

NameData TypePermissionsDescription
intranetapplication<String>Read-writeName of the intranet application.
Minimum length = 1
Maximum length = 31
protocol<String>Read-writeProtocol 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-writeDestination IP address, IP range, or host name of the intranet application. This address is the server IP address.
Minimum length = 1
netmask<String>Read-writeDestination subnet mask for the intranet application.
iprange<String>Read-writeIf 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-writeName 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-writeNames of the client applications, such as PuTTY and Xshell.
Minimum length = 1
spoofiip<String>Read-writeIP 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-writeDestination 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-writeInterception 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-writeSource 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-writeSource 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-onlyThe IP address for the application. This address is the real application server IP address.
__count<Double>Read-onlycount parameter

Operations

(click to see Properties)

ADD| DELETE| GET (ALL)| GET| COUNT

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>

Note:

Mandatory parameters are marked in redand 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":{
<b>"intranetapplication":<String_value>,
</b>"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 errorResponse 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 errorResponse 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 errorResponse Headers:

Content-Type:application/json

Response Payload:

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