Catalyst 6500 Series WebVPN Services Module Command Reference, 1.1
Catalyst 6500 Series Switch WebVPN Module Commands

Table Of Contents

Commands for the Catalyst 6500 Series Switch WebVPN Module

clear webvpn nbns

clear webvpn platform

clear webvpn session

clear webvpn stats

crypto key export rsa pem

crypto key generate

crypto key import rsa pem

crypto pki authenticate

crypto pki certificate

crypto pki crl request

crypto pki enroll

crypto pki export pem

crypto pki export pkcs12

crypto pki import pem

crypto pki import pkcs12

crypto pki profile enrollment

crypto pki trustpoint

debug webvpn

do

nbns-list

policy group

port-forward

show webvpn context

show webvpn dispatch

show webvpn gateway

show webvpn install

show webvpn nbns

show webvpn platform buffers

show webvpn platform context

show webvpn platform crash-info

show webvpn platform gateway

show webvpn platform mac address

show webvpn platform policy

show webvpn platform version

show webvpn platform vlan

show webvpn policy

show webvpn session

show webvpn stats

snmp-server enable

svc

url-list

webvpn context

webvpn gateway

webvpn policy ssl

webvpn policy tcp


Commands for the Catalyst 6500 Series Switch WebVPN Module


This chapter contains an alphabetical listing of commands for the Catalyst 6500 series WebVPN Module.

For additional WebVPN Services Module information, refer to the following documentation:

Catalyst 6500 Series Switch WebVPN Services Module Installation and Verification Note

Catalyst 6500 Series Switch WebVPN Services Module Configuration Note

Catalyst 6500 Series Switch WebVPN Services Module System Message Guide

clear webvpn nbns

To reset the NetBIOS name service (NBNS) cache on the WebVPN Services Module, use the clear webvpn nbns command.

clear webvpn nbns [context {name | all}]

Syntax Description

context

(Optional) Clears the statistics for a specific context.

name

Specifies the name of the context.

all

Specifies all contexts.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

To reset all the statistics counters that the WebVPN Services Module maintains, use the clear webvpn nbns command without options.

Examples

This example shows how to reset the statistics counters that are maintained in the different system components on the WebVPN Services Module:

webvpn# clear webvpn nbns context context1

clear webvpn platform

To reset the platform extenstions on the WebVPN Services Module, use the clear webvpn platform command.

clear webvpn platform {conn | session | stats [type] | tunnel stats}

Syntax Description

conn

Clears global connection.

session

Clears session information.

stats

Clears statistics information.

type

(Optional) See the "" for available options.

tunnel stats

Clears tunnel counters.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The available options for stats type are as follows:

crypto—Clears crypto statistics information.

crypto module moduleClears crypto statistics for the specified module type.

fdu—Clears FDU statistics information.

ipc—Clears IPC statistics information.

ipc module moduleClears IPC statistics for the specified module type.

module moduleClears statistics for the specified module type.

The available options for the module variable are as follows:

all—All CPUs

fdu—FDU CPU

ssl1—SSL1 CPU

tcp1—TCP1 CPU

tcp2—TCP2 CPU

pki [pki_type]Clears PKI statistics information.

The available options for the pki_type variable are as follows:

auth—Certificate authentication and authorization statistics.

cache—Peer certificate cache statistics.

cert-header—Certificate header insertion statistics.

expiring—Certificate expiration warning statistics.

ipc—Interprocessor communication statistics.

memory—Memory usage statistics.

pki module moduleClears PKI statistics for the specified module type.

ssl—Clears SSL statistics information.

tcp—Clears TCP statistics information.

Examples

This example shows how to reset the platform counters that are maintained in the different system components on the WebVPN Services Module:

webvpn# clear webvpn platform 

clear webvpn session

To clear the WebVPN session, use the clear webvpn session command.

clear webvpn session {context {name | all} | user name {context {name | all}}}

Syntax Description

context

Clears the statistics for a specific context.

name

Specifies the name of the context.

all

Specifies all contexts.

user name

Specifies the user name.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

To reset all the statistics counters that the WebVPN Services Module maintains, use the clear webvpn nbns command without options.

Examples

This example shows how to reset the session counters that are maintained in the different system components on the WebVPN Services Module:

webvpn# clear webvpn session

clear webvpn stats

To reset the statistics counters that are maintained in the different system components on the WebVPN Services Module, use the clear webvpn stats command.

clear webvpn stats [cifs [context {name | all}] | context {name | all} | mangle [context {name | all}] | port-forward [context {name | all}] | tunnel [context {name | all}]]

Syntax Description

cifs

(Optional) WebVPN CIFS statistics

context

(Optional) Clears the statistics for a specific context.

name

(Optional) Specifies the name of the context.

all

(Optional) Specifies all contexts.

mangle

(Optional) Clears the WebVPN mangling statistics.

port-forward

(Optional) Clears the WebVPN port-forwarding statistics.

tunnel

(Optional) Clears the WebVPN tunnel statistics.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

To reset all the statistics counters that the WebVPN Services Module maintains, use the clear ssl-proxy stats command without options.

Examples

This example shows how to reset the statistics counters that are maintained in the different system components on the WebVPN Services Module:

webvpn# clear webvpn stats cifs
webvpn# clear webvpn stats context context1
webvpn# clear webvpn stats mangle context all
webvpn# clear webvpn stats tunnel 

This example shows how to clear all the statistic counters that the WebVPN Services Module maintains:

webvpn# clear webvpn stats 
webvpn# 

crypto key export rsa pem

To export a PEM-formatted RSA key to the WebVPN Services Module, use the crypto key export rsa pem command.

crypto key export rsa keylabel pem {terminal | url url} {{3des | des} pass_phrase}

Syntax Description

keylabel

Name of the key.

terminal

Displays the request on the terminal.

url url

Specifies the URL location. Valid values for url are as follows:

archive:—Exports to archive: file system

flash:—Exports to flash: file system

ftp:—Exports to ftp: file system

http:—Exports to http: file system

https:—Exports to https: file system

null:—Exports to null: file system

nvram:—Exports to nvram: file system

rcp:—Exports to rcp: file system

scp:—Exports to scp: file system

system:—Exports to system: file system

tftp:—Exports to tftp: file system

3des

Specifies the 168-bit DES (3DES) encryption algorithm.

des

Specifies the 56-bit DES-CBC encryption algorithm.

pass_phrase

Pass phrase.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The pass phrase can be any phrase including spaces and punctuation except for a question mark (?), which has special meaning to the Cisco IOS parser.

Pass-phrase protection associates a pass phrase with the key. The pass phrase is used to encrypt the key when it is exported. When this key is imported, you must enter the same pass phrase to decrypt it.

Examples

This example shows how to export a key from the WebVPN Services Module:

wwbvpn(config)# crypto key export rsa test-keys pem url scp: 3des password
% Key name:test-keys
   Usage:General Purpose Key
Exporting public key...
Address or name of remote host []? 7.0.0.7
Destination username [ssl-proxy]? lab
Destination filename [test-keys.pub]? 

Password:

Writing test-keys.pub Writing file to scp://lab@7.0.0.7/test-keys.pub
Password:
!
Exporting private key...
Address or name of remote host []? 7.0.0.7
Destination username [ssl-proxy]? lab
Destination filename [test-keys.prv]? 

Password:

Writing test-keys.prv Writing file to scp://lab@7.0.0.7/test-keys.prv
Password:
wwbvpn(config)# 

crypto key generate

To generate RSA key pairs, use the crypto key generate command.

crypto key generate rsa {usage-keys|general-keys} {label key-label} [exportable] [modulus size]

Syntax Description

general-keys

Generate a general purpose RSA key pair for signing and encryption

usage-keys

Generate seperate RSA key pairs for signing and encryption

label key-label

Specifies the key.

exportable

(Optional) Specifies that the key is allowed to be exported.

modulus size

(Optional ) Specifies the modulus length in bits; valid values are 512, 768, 1024, 1536, and 2048 bits. See the "Usage Guidelines" section for more information.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The WebVPN Services Module supports up to eight levels of certificate authority (one root certificate authority and up to seven subordinate certificate authorities).

You can specify that a key is exportable during key generation. Once the key is generated as either exportable or not exportable, it cannot be modified for the life of the key.


Note The WebVPN Services Module supports modulus lengths of 512, 768, 1024, 1536, and 2048 bits. Although you can specify 512 or 768, we recommend a minimum modulus length of 1024. A longer modulus takes longer to generate and takes longer to use, but it offers better security.


After you generate a key pair, you can test the SSL service by generating a self-signed certificate.

Examples

This example shows how to generate special-usage RSA keys:

crypto key generate rsa usage-keys

The name for the keys will be: myrouter.example.com
Choose the size of the key modulus in the range of 360 to 2048 for your Signature Keys. 
Choosing a key modulus greater than 512 may take a few minutes.
How many bits in the modulus[512]? <return>

Generating RSA keys.... [OK].
Choose the size of the key modulus in the range of 360 to 2048 for your Encryption Keys. 
Choosing a key modulus greater than 512 may take a few minutes.
How many bits in the modulus[512]? <return>

Generating RSA keys.... [OK].

This example shows how to generate general-purpose RSA keys:


Note You cannot generate both special-usage and general-purpose keys; you can generate only one or the other.


webvpn(config)# crypto key generate rsa general-keys label kp1 exportable 

The name for the keys will be: kp1
Choose the size of the key modulus in the range of 360 to 2048 for your
  General Purpose Keys. Choosing a key modulus greater than 512 may take
  a few minutes.

How many bits in the modulus [512]: 1024
Generating RSA keys.... [OK]. 

crypto key import rsa pem

To import a PEM-formatted RSA key from an external system, use the crypto key import rsa pem command.

crypto key import rsa keylabel pem [usage-keys] {terminal | url url} [exportable] passphrase}

Syntax Description

keylabel

Name of the key.

usage-keys

(Optional) Specifies that two special-usage key pairs should be generated, instead of one general-purpose key pair.

terminal

Displays the request on the terminal.

url url

Specifies the URL location. Valid values are as follows:

archive:—Imports from archive: file system.

cns:—Imports from cns: file system.

flash:—Imports from flash: file system.

ftp:—Imports from ftp: file system.

http:—Imports from http: file system.

https:—Imports from https: file system.

null:—Imports from null: file system.

nvram:—Imports from nvram: file system.

rcp:—Imports from rcp: file system.

scp:—Imports from scp: file system.

system:—Imports from system: file system.

tftp:—Imports from tftp: file system.

exportable

(Optional) Specifies that the key can be exported.

passphrase

Pass phrase.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The pass phrase can be any phrase including spaces and punctuation except for a question mark (?), which has special meaning to the Cisco IOS parser.

Pass-phrase protection associates a pass phrase with the key. The pass phrase is used to encrypt the key when it is exported. When this key is imported, you must enter the same pass phrase to decrypt it.

Examples

This example shows how to import a PEM-formatted RSA key from an external system and export the PEM-formatted RSA key to the WebVPN Services Module:

wwbvpn(config)# crypto key import rsa newkeys pem url scp: password
% Importing public key or certificate PEM file...
Address or name of remote host []? 7.0.0.7
Source username [ssl-proxy]? lab
Source filename [newkeys.pub]? test-keys.pub

Password:
Sending file modes:C0644 272 test-keys.pub
Reading file from scp://lab@7.0.0.7/test-keys.pub!
% Importing private key PEM file...
Address or name of remote host []? 7.0.0.7
Source username [ssl-proxy]? lab
Source filename [newkeys.prv]? test-keys.prv

Password:
Sending file modes:C0644 963 test-keys.prv
Reading file from scp://lab@7.0.0.7/test-keys.prv!% Key pair import succeeded.

wwbvpn(config)#

crypto pki authenticate

To obtain the certificate that contains the public key of the certificate authority, use the crypto pki authenticate command.

crypto pki authenticate trustpoint-label

Syntax Description

trustpoint-label

Name of the trustpoint label.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The trustpoint-label argument is case-sensitive.

For each trustpoint, you must obtain a certificate that contains the public key of the certificate authority; multiple trustpoints can use the same certificate authority.


Note Contact the certificate authority to obtain the correct fingerprint of the certificate and verify the fingerprint displayed on the console.


Examples

This example shows how to obtain the certificate of the certificate authority:

webvpn(config)# crypto pki authenticate PROXY1
Certificate has the following attributes:
Fingerprint: A8D09689 74FB6587 02BFE0DC 2200B38A 
% Do you accept this certificate? [yes/no]: y
Trustpoint CA certificate accepted.
webvpn(config)# end
webvpn#

crypto pki certificate

To configure and define the PKI implementation on the WebVPN Services Module, use the crypto pki certificate command.

crypto pki certificate {chain name | map map_name | query | validate trustpoint-label}

Syntax Description

chain

Identifies certificates.

name

CA server name.

map

Defines certificate attributes map.

map_name

CA map tag name.

query

Obtains certificates from the CA after reboot.

validate

Validates a certificate chain.

trustpoint-label

Trustpoint label name.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The crypto pki certificate chain command puts you into certificate chain configuration mode. When you are in certificate chain configuration mode, you can delete certificates using the certificate command. You need to be in certificate chain configuration mode to delete certificates.

The crypto pki certificate validate command validates the router's own certificate for a given trustpoint. Use this command as a sanity check after enrollment to verify that the trustpoint is properly authenticated, a certificate has been requested and granted for the trustpoint, and that the certificate is currently valid. A certificate is valid if it is signed by the trustpoint certification authority (CA), not expired, and so on.

crypto pki crl request

To configure and define the PKI implementation on the WebVPN Services Module, use the crypto pki crl request command.

crypto pki crl request name

Syntax Description

name

Specifies the name of the CA. This is the same name used when the CA was declared with the crypto pki trustpoint command.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

A CRL lists all the certificates of the network device that have been revoked. Revoked certificates will not be honored by your module; therefore, any IPSec device with a revoked certificate cannot exchange IP Security traffic with your module.

The first time your module receives a certificate from a peer, it will download a CRL from the CA. Your module then checks the CRL to make sure the certificate of the peer has not been revoked. (If the certificate appears on the CRL, it will not accept the certificate and will not authenticate the peer.)

A CRL can be reused with subsequent certificates until the CRL expires. If your module receives the certificate of a peer after the applicable CRL has expired, it will download the new CRL.

If your module has a CRL which has not yet expired, but you suspect that the contents of the CRL are out of date, use the crypto pki crl request command to request that the latest CRL be immediately downloaded to replace the old CRL.

This command is not saved to the configuration.

Examples

This example shows how to specify the timeout in seconds for each request:

wwbvpn(config)# crypto pki crl request 

crypto pki enroll

To request a certificate for the trustpoint, use the crypto pki enroll command.

crypto pki enroll trustpoint-label

Syntax Description

trustpoint-label

Name of the trustpoint label.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The trustpoint-label argument is case-sensitive.

You must obtain a signed certificate from the certificate authority for each trustpoint.

You have the option to create a challenge password that is not saved with the configuration. This password is required if your certificate needs to be revoked, so you must remember this password.


Note If your module or switch reboots after you have entered the crypto pki enroll command, but before you have received the certificates, you must reenter the command and notify the certificate authority administrator.


Examples

This example shows how to request a certificate:

webvpn(config)# crypto pki enroll PROXY1
%
% Start certificate enrollment.. 

% The subject name in the certificate will be: C=US; ST=California; L=San Jose; O=Cisco; 
OU=Lab; CN=host1.cisco.com
% The subject name in the certificate will be: host.cisco.com
% The serial number in the certificate will be: 00000000
% The IP address in the certificate is 10.0.0.1

% Certificate request sent to Certificate Authority
% The certificate request fingerprint will be displayed.
% The 'show crypto pki certificate' command will also show the fingerprint.
Fingerprint:  470DE382 65D8156B 0F84C2AF 4538B913 

webvpn(config)# end

crypto pki export pem

To export privacy-enhanced mail (PEM) files from the WebVPN Services Module, use the crypto pki export pem command.

crypto pki export trustpoint_label pem {terminal {des | 3des} {url url}} pass_phrase

Syntax Description

trustpoint-label

Name of the trustpoint.

terminal

Displays the request on the terminal.

des

Specifies the 56-bit DES-CBC encryption algorithm.

3des

Specifies the 168-bit DES (3DES) encryption algorithm.

url url

Specifies the URL location. Valid values for url are as follows:

archive:—Exports to archive: file system

flash:—Exportsto flash: file system

ftp:—Exports to the FTP: file system

http:—Exports to HTTP: file system

https:—Exports to HTTPS: file system

null:—Exports to the NULL: file system

nvram:—Exports to the NVRAM: file system

rcp:—Exports to the RCP: file system

scp:—Exports to the SCP: file system

system:—Exports to the system: file system

tftp:—Exports to the TFTP: file system

pass-phrase

Pass phrase that is used to protect the private key.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The pass_phrase can be any phrase including spaces and punctuation except for a question mark (?), which has special meaning to the Cisco IOS parser.

Pass-phrase protection associates a pass phrase with the key. The pass phrase is used to encrypt the key when it is exported. When this key is imported, you must enter the same pass phrase to decrypt it.

A key that is marked as unexportable cannot be exported.

You can change the default file extensions when prompted. The default file extensions are as follows:

public key (.pub)

private key (.prv)

certificate (.crt)

CA certificate (.ca)

signature key (-sign)

encryption key (-encr)

Examples

This example shows how to export a PEM-formatted file on the WebVPN Services Module:

wwbvpn(config)# crypto pki export TP5 pem url tftp://10.1.1.1/TP5 password

Related Commands

crypto pki import pem

crypto pki export pkcs12

To export a PKCS12 file from the WebVPN Services Module, use the crypto pki export pkcs12 command.

crypto pki export trustpoint_label pkcs12 file_system [pkcs12_filename] pass_phrase

Syntax Description

trustpoint_label

Specifies the trustpoint label.

file_system

Specifies the file system. Valid values for file_system are as follows

archive:—Exports to archive: file system.

cns:—Exports to cns: file system.

flash:—Exports to flash: file system.

ftp:—Exports to ftp: file system.

http:—Exports to http: file system.

https:—Exports to https: file system.

null:—Exports to null: file system.

nvram:—Exports to nvram: file system.

rcp:—Exports to rcp: file system.

scp:—Exports to scp: file system.

system:—Exports to system: file system.

terminal—Outputs the PKCS12 file to the terminal.

tftp:—Exports to tftp: file system.

pkcs12_filename

(Optional) Specifies the name of the PKCS12 file to import.

pass_phrase

Specifies the pass phrase of the PKCS12 file.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

Imported key pairs cannot be exported.

If you are using SSH, we recommend using SCP (secure file transfer) when exporting a PKCS12 file. SCP authenticates the host and encrypts the transfer session.

If you do not specify the pkcs12_filename value, you will be prompted to accept the default filename (the default filename is the trustpoint_label value) or enter the filename. For the ftp: or tftp: value, include the full path in the pkcs12_filename value.

You will receive an error if you enter the pass phrase incorrectly.

If there is more than one level of CA, the root CA and all the subordinate CA certificates are exported in the PKCS12 file.

Examples

This example shows how to export a PKCS12 file using SCP:

wwbvpn(config)# crypto ca export TP1 pkcs12 scp: sky is blue
Address or name of remote host []? 10.1.1.1
Destination username [ssl-proxy]? admin-1
Destination filename [TP1]? TP1.p12

Password:

Writing TP1.p12 Writing pkcs12 file to scp://admin-1@10.1.1.1/TP1.p12

Password:
!
CRYPTO_PKI:Exported PKCS12 file successfully.
wwbvpn(config)#

crypto pki import pem

To import a PEM-formatted file to the WebVPN Services Module, use the crypto pki import pem command.

crypto pki import trustpoint_label pem [exportable] {terminal | url url | usage-keys} pass_phrase

Syntax Description

trustpoint-label

Name of the trustpoint.

exportable

(Optional) Specifies the key that can be exported.

terminal

Displays the request on the terminal.

url url

Specifies the URL location. Valid values for url are as follows:

archive:—Imports from archive: file system.

flash:—Imports from flash: file system.

ftp:—Imports from the FTP: file system.

http:—Importsfrom HTTP: file system.

https:—Imports from HTTPS: file system.

null:—Imports from the NULL: file system.

nvram:—Imports from the NVRAM: file system.

rcp:—Imports from the RCP: file system.

scp:—Imports from the SCP: file system.

system:—Imports from the system: file system.

tftp:—Imports from the TFTP: file system.

usage-keys

Specifies that two special-usage key pairs should be generated, instead of one general-purpose key pair.

pass_phrase

Pass phrase.


Defaults

This command has no default settings.

Command History

Global configuration

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

You will receive an error if you enter the pass phrase incorrectly.The pass phrase can be any phrase including spaces and punctuation except for the question mark (?), which has special meaning to the Cisco IOS parser.

Pass-phrase protection associates a pass phrase with the key. The pass phrase is used to encrypt the key when it is exported. When this key is imported, you must enter the same pass phrase to decrypt it.

When importing RSA keys, you can use a public key or its corresponding certificate.

The crypto ca import pem command imports only the private key (.prv), the server certificate (.crt), and the issuer CA certificate (.ca). If you have more than one level of CA in the certificate chain, you need to import the root and subordinate CA certificates before this command is used for authentication. Use the cut-and-paste feature or TFTP to import the root and subordinate CA certificates.

Examples

This example shows how to import a PEM-formatted file from the WebVPN Services Module:

wwbvpn(config)# crypto pki import TP5 pem url tftp://10.1.1.1/TP5 password
% Importing CA certificate...
Address or name of remote host [10.1.1.1]? 
Destination filename [TP5.ca]? 
Reading file from tftp://10.1.1.1/TP5.ca
Loading TP5.ca from 10.1.1.1 (via Ethernet0/0.168): !
[OK - 1976 bytes]

% Importing private key PEM file...
Address or name of remote host [10.1.1.1]? 
Destination filename [TP5.prv]? 
Reading file from tftp://10.1.1.1/TP5.prv
Loading TP5.prv from 10.1.1.1 (via Ethernet0/0.168): !
[OK - 963 bytes]

% Importing certificate PEM file...
Address or name of remote host [10.1.1.1]? 
Destination filename [TP5.crt]? 
Reading file from tftp://10.1.1.1/TP5.crt
Loading TP5.crt from 10.1.1.1 (via Ethernet0/0.168): !
[OK - 1692 bytes]
% PEM files import succeeded.
wwbvpn(config)# end
webvpn#
*Apr 11 15:11:29.901: %SYS-5-CONFIG_I: Configured from console by console

Related Commands

crypto pki export pem

crypto pki import pkcs12

To import a PKCS12 file to the WebVPN Services Module, use the crypto ca import pkcs12 command.

crypto pki import trustpoint_label pkcs12 file_system [pkcs12_filename] pass_phrase

Syntax Description

trustpoint_label

Specifies the trustpoint label.

file_system

Specifies the file system. Valid values for file_system are as follows:

archive:—Exports to archive: file system.

cns:—Exports to cns: file system.

flash:—Exports to flash: file system.

ftp:—Exports to ftp: file system.

http:—Exports to http: file system.

https:—Exports to https: file system.

null:—Exports to null: file system.

nvram:—Exports to nvram: file system.

rcp:—Exports to rcp: file system.

scp:—Exports to scp: file system.

system:—Exports to system: file system.

terminal—Outputs the PKCS12 file to the terminal.

tftp:—Exports to tftp: file system.

pkcs12_filename

(Optional) Specifies the name of the PKCS12 file to import.

pass_phrase

Specifies the pass phrase of the PKCS12 file.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

If you are using SSH, we recommend using SCP (secure file transfer) when importing a PKCS12 file. SCP authenticates the host and encrypts the transfer session.

If you do not specify a value for pkcs12_filename, you will be prompted to accept the default filename (the default filename is the trustpoint_label value) or to enter the filename. For the ftp: or tftp: value, include the full path in the pkcs12_filename value.

You will receive an error if you enter the pass phrase incorrectly.

If there is more than one level of CA, the root CA and all the subordinate CA certificates are exported in the PKCS12 file.

Examples

This example shows how to import a PKCS12 file using SCP:

wwbvpn(config)# crypto ca import TP2 pkcs12 scp: sky is blue
Address or name of remote host []? 10.1.1.1
Source username [ssl-proxy]? admin-1
Source filename [TP2]? /users/admin-1/pkcs12/TP2.p12

Password:password
Sending file modes:C0644 4379 TP2.p12
!
wwbvpn(config)#
*Aug 22 12:30:00.531:%CRYPTO-6-PKCS12IMPORT_SUCCESS:PKCS #12 Successfully Imported.
wwbvpn(config)#

crypto pki profile enrollment

To define an enrollment profile, use the crypto pki profile enrollment command in global configuration mode. To delete all information associated with this enrollment profile, use the no form of this command.

crypto pki profile enrollment label

Syntax Description

label

Certificate enrollment profile tag.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

After entering the crypto pki profile enrollment command, you can use any of the following commands to define the profile parameters:

authentication command—Specifies the HTTP command that is sent to the certification authority (CA) for authentication.

authentication terminal—Specifies manual cut-and-paste certificate authentication requests.

authentication url—Specifies the URL of the CA server to which to send authentication requests.

enrollment command—Specifies the HTTP command that is sent to the CA for enrollment.

enrollment terminal—Specifies manual cut-and-paste certificate enrollment.

enrollment url—Specifies the URL of the CA server to which to send enrollment requests.

parameter—Specifies parameters for an enrollment profile. This command can be used only if the authentication command or the enrollment command is used.


Note The authentication url, enrollment url, authentication terminal, and enrollment terminal commands allow you to specify different methods for certificate authentication and enrollment, such as TFTP authentication and manual enrollment.


Examples

This example shows how to specify the timeout in seconds for each request:

webvpn(config)# crypto pki profile enrollment test
webvpn(ca-profile-enroll)#

crypto pki trustpoint

To enter the configuration submode for the certificate-authority trustpoint and define the certificate-authority trustpoint, use the crypto pki trustpoint command. Use the no form of this command to remove any commands that you have entered in the WebVPN subcommand mode from the configuration.

crypto pki trustpoint trustpoint-label

no crypto pki trustpoint trustpoint-label

Syntax Description

trustpoint-label

(Optional) Name of the trustpoint label.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The trustpoint-label argument is case-sensitive.

After you enter the crypto pki trustpoint command, the prompt changes to the following:

webvpn(ca-trustpoint)# 

After you enter the ca-trustpoint submode, there are commands available to configure the CA trustpoint. Table 2-1 lists the ca-trustpoint submode commands.

Table 2-1 Certificate-Authority Trustpoint Submode Commands 

Command
Purpose and Guidelines
Defaults

authorization {list listname | username {subjectname subjectname}}

Authorization parameters.

list listname—Specifies the AAA authorization list.

username subjectname subjectname—Sets parameters for the different certificate fields that are used to build the AAA username.

The following are options that may be used as the AAA username:

commonname—Certificate common name.

country—Certificate country.

email—Certificate email.

ipaddress—Certificate IP address.

locality—Certificate locality.

organization—Certificate organization.

organizationalunit—Certificate organizational unit.

postalcode—Certificate postal code.

serialnumber—Certificate serial number.

state—Certificate state field.

streetaddress—Certificate street address.

title—Certificate title.

unstructuredname—Certificate unstructured name.

 

auto-enroll [[value] regenerate]]

Automatically enrolls this router identity.

regenerate—(Optional) A new key is generated for the certificate even if the named key already exists.

value = 1-100

 

crl query url

   

default

Sets a command to its defaults.

 

enrollment [http-proxy][mode ra] [retry {period minutes | count count} ] url url

Specifies the enrollment parameters for your certificate authority as follows:

http-proxy—HTTP proxy server for enrollment.

mode ra—Registration authority mode.

retry count count— How many times to poll the CA for the certificate; valid values for count are 1 to 100.

retry period minutes—How long to wait between requests to the CA for the certificate; valid values for minutes are 1 to 60.

url urlA URL or one of the following:

archive:—Enrolls using archive: file system.

flash:—Enrolls using flash: file system.

ftp:—Enrolls using ftp: file system.

http:—Enrolls using http: file system.

https:—Enrolls using https: file system.

null:—Enrolls using null: file system.

nvram:—Enrolls using nvram: file system.

rcp:—Enrolls using rcp: file system.

scp:—Enrolls using scp: file system.

system:—Enrolls using system: file system.

tftp:—Enrolls using tftp: file system.

period minutes—1

count count—10

exit

Exits the ca-trustpoint configuration mode.

 

fqdn {fqdn | none}

Includes the fully qualified domain name.

fqdn—Enter the fully qualified domain name.

none—Do not include the fully qualified domain name.

 

ip-address server-ip-addr

(Optional) Specifies the IP address of the WebVPN gateway that will use this certificate.

 

match certificate map_name [map | override | skip]

Associates a certificate-based access control list (ACL) defined with the crypto pki certificate map command.

map_name—Matches the map_name argument specified in a previously defined crypto pki certificate map map_name command.

allow—Allows expired certificates to be accepted.

override—Overrides fields in a certificate.

skip—Skips a certificate validity check.

 

no

Negates a command or set its defaults.

 

ocsp url url

Enters Online Certificate Status Protocol (OCSP) parameters.

url—All certificates associated with a configured trustpoint will be checked by the OCSP server at the specified HTTP URL.

 

password password

(Optional) Configures a challenge password.

 

primary

Specifies the trustpoint as primary.

 

query certificate

Turns on query mode per specified trustpoint, causing certificates not to be stored locally and to be retrieved from a remote server.

 

rsakeypair key-label

Specifies the key pair to associate with the certificate.

 

regenerate

Regenerates keys on reenrollment.

 

revocation-check {crl | none | ocsp}

(Optional) Specifies how this trustpoint looks up a certificate revocation list when validating a certificate associated with this trustpoint.

crl —Revocation check by CRL.

none—Ignore revocation check.

ocsp—Revocation check by OCSP.

 

root tftp hostname filename

Defines the TFTP protocol to get the root certificate of a given certification authority. This command enables an authenticated root certificate to be stored as a file on the TFTP server.

 

serial-number [none]

Specifies whether or not to include serial number.

Not included

show

Shows this router trustpoint.

 

source interface interface-name

Specifies the address of an interface to be used as the source address for all outgoing TCP connections associated with a trustpoint.

interface-name—Interface address to be used as the source address.

 

subject-name line

(Optional) Configures the host name of the WebVPN gateway.

 

usage {ike | ssl-client | ssl-server}

(Optional) Specifies the intended use for the certificate.

 

vrf vrf

Name of the VPN routing and forwarding instance (VRF) to use for enrollment and obtaining CRLs.

 

You should declare one trustpoint to be used by the module for each certificate.

The trustpoint-label value should match the key-label value of the keys; however, this is not a requirement.

When you specify the IP address of the WebVPN gateway that will use this certificate, some web browsers compare the IP address in the SSL server certificate with the IP address that might appear in the URL. If the IP addresses do not match, the browser may display a dialog box and ask the client to accept or reject this certificate.

When specifying the subject-name line value, use these guidelines:

The subject-name command uses the Lightweight Directory Access Protocol (LDAP) format.

Arguments specified in the subject name must be enclosed in quotation marks if they contain a comma. For example, O="Cisco, Inc."

Some browsers compare the common name (CN) field of the subject name in the SSL server certificate with the hostname that might appear in the URL. If the names do not match, the browser may display a dialog box and ask the client to accept or reject the certificate. Also, some browsers will reject the SSL session setup and close the session if the CN field is not defined in the certificate.

Examples

This example shows how to declare the trustpoint PROXY1 and verify connectivity:

webvpn(config)# crypto pki trustpoint PROXY1
webvpn(ca-trustpoint)# rsakeypair PROXY1
webvpn(ca-trustpoint)# enrollment url http://exampleCA.cisco.com
webvpn(ca-trustpoint)# ip-address 10.0.0.1
webvpn(ca-trustpoint)# password password
webvpn(ca-trustpoint)# serial-number
webvpn(ca-trustpoint)# subject-name C=US; ST=California; L=San Jose; O=Cisco; OU=Lab;
CN=host1.cisco.com
webvpn(ca-trustpoint)# end
webvpn# ping example.cisco.com
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 20.0.0.1, timeout is 2 seconds:
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/4 ms
webvpn#

debug webvpn

To turn on the debug flags in different system components, use the debug webvpn command. Use the no form of this command to turn off the debug flags.

debug webvpn [aaa | cifs | cookie | dns | emweb | http | package | platform [type] | port-forward | sock | timer | trie | tunnel | webservice]

Syntax Description

aaa

Enables WebVPN AAA debugs.

cifs

Enables WebVPN CIFS.

cookie

Enables WebVPN cookie debugs.

dns

Enables DNS debugs.

emweb

Enables EmWeb debugs.

http

Enables HTTP debugs.

package

Enables package debugs.

platform type

See the "Usage Guidelines" for information on the platform type option.

port-forward

Enables port-forward debugs.

sock

Enables socks debugs.

timer

Enables timer debugs.

trie

Enables trie debugs.

tunnel

Enables tunnel debugs.

webservice

Enables web service debugs.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines


Note For the following options, module module has the following values:

fdu—FDU CPU

ssl1—SSL1 CPU

tcp1—TCP1 CPU

tcp2—TCP2 CPU


The platform type has the following options:

The platform app includes the following values:

app [module [module]]—App Record Layer

hdr [module [module]]—App HTTP Header Insertion

module [module]—Module to be debugged

url [module [module]]—App URL Rewrite

The platform app-driver includes the following values:

dispatch—Dispatch events

error—Error events

event {app | next-hop | tcp}—Event debugging

fsm—FSM

mc—Multi-core events

The platform content includes the following values:

detail [module [module]]—Content detail

error [module [module]]—Content error

ipc [module [module]]—Content IPC

module [module]—Module to be debugged

rewriting [module [module]]—Content rewriting

scanning [module [module]]—Content scanning

The platform fdu includes the following values:

cli [module [module]]FDU CLI

hash [module [module]]FDU hash

ipc [module [module]]FDU IPC

module [module]—Module to be debugged

trace [module [module]]FDU trace

The platform flash includes the following values:

module [module]—Module to be debugged

The platform ipc includes the following values:

module [module]—Module to be debugged

The platform pc includes the following values:

module [module]—Module to be debugged

The platform pki includes the following values:

auth—Certificate authentication and authorization

ca-pool—CA Pool

cert—Certificate management

events—Events

history—Certificate history

ipc—IPC messages and buffers

key—Key management

The platform remote includes the following values:

loop count [module [module]]—Remote debug. Valid values for count are from 1 to 65535.

module [module]—Module to be debugged

The platform ssl keyword includes the following values:

alert [module [module]]—SSL alert events

error [module [module]]—SSL error events

handshake [module [module]]—SSL handshake events

module [module]—Module to be debugged

pkt [module [module]]—Debugs the received and transmitted SSL packets


Note Use the TCP debug commands only to troubleshoot basic connectivity issues under little or no load conditions (for instance, when no connection is being established to the virtual server or real server).

If you run TCP debug commands, the TCP module displays large amounts of debug information on the console, which can significantly slow down module performance. Slow module performance can lead to delayed processing of TCP connection timers, packets, and state transitions.


The platform tcp keyword includes the following values:

events [module [module]]—Debugs the TCP events.

module [module]—Module to be debugged.

pkt [module [module]]—Debugs the received and transmitted TCP packets.

state [module [module]]—Debugs the TCP states.

timers [module [module]]—Debugs the TCP timers.

The platform tunnel keyword includes the following values:

hash—Tunnel hash entry

trace—Trace packets for tunnel connection

Examples

This example shows how to turn on tunnel debugging:

webvpn# debug webvpn tunnel 
webvpn# 

This example shows how to turn on App debugging:

webvpn# debug webvpn platform app
webvpn# 

This example shows how to turn on FDU debugging:

webvpn# debug webvpn platform fdu
webvpn# 

This example shows how to turn on IPC debugging:

webvpn# debug webvpn platform ipc
webvpn# 

This example shows how to turn on PKI debugging:

webvpn# debug webvpn platform pki
webvpn# 

This example shows how to turn on SSL debugging:

ssl-proxy# debug webvpn platform ssl
ssl-proxy# 

This example shows how to turn on TCP debugging:

ssl-proxy# debug webvpn platform tcp
ssl-proxy# 

This example shows how to turn off TCP debugging:

ssl-proxy# no debug webvpn platform tcp
ssl-proxy# 

do

To execute EXEC-level commands from global configuration mode or other configuration modes or submodes, use the do command.

do command

Syntax Description

command

EXEC-level command to be executed.


Defaults

This command has no default settings.

Command Modes

Global configuration or any other configuration mode or submode from which you are executing the EXEC-level command.

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines


Caution Do not enter the do command in EXEC mode. Interruption of service may occur.

You cannot use the do command to execute the configure terminal command because entering the configure terminal command changes the mode to configuration mode.

You cannot use the do command to execute the copy or write command in the global configuration mode or any other configuration mode or submode.

Examples

This example shows how to execute the EXEC-level show interfaces command from within global configuration mode:

wwbvpn(config)# do show interfaces serial 3/0

Serial3/0 is up, line protocol is up
  Hardware is M8T-RS232
  MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
  Encapsulation HDLC, loopback not set, keepalive set (10 sec)
  Last input never, output 1d17h, output hang never
  Last clearing of "show interface" counters never
.
.
.
wwbvpn(config)#

nbns-list

To enter the nbnslist submode and configure NetBIOS Name Service (NBNS) servers, use the nbns-list command. Use the no form of this command to remove the specified list from the configuration.

nbns-list name

no nbns-list name

Syntax Description

name

Name for the NBNS list.


Defaults

This command has no default settings.

Command Modes

WebVPN context submode

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The listname argument is case-sensitive and can be a maximum of 64 characters.

After you enter the nbns-list command, the prompt changes to the following:

webvpn(config-webvpn-nbnslist)#

After you enter the nbnslist submode, there are commands available to configure the NBNS servers. Table 2-4 lists the nbnslist submode commands.

Table 2-2 NBNSlist Submode Commands 

Command
Purpose and Guidelines
Defaults

nbns-server ip_addr [master] [timeout timeout][retry retries]

Specifies a NetBIOS name service (NBNS) list and server address for common Internet file system (CIFS) name resolution. You can configure up to three servers.

Note Supported only on Windows 2000 and Samba servers running on Linux.

The ip_addrs value specifies the primary domain controller (PDC) on a Windows network.

The master keyword indicates that this is a master browser. Do not enter the master keyword if this a Windows Internet Naming Service (WINS) server.

The timeout value specifies the initial time in seconds to wait for a response to an NBNS query before sending the query to the next server. The default timeout value is 2 seconds; the range is from 1 to 30.

The retries value specifies the number of times to retry sending a NBNS query to the configured servers. This value represents the number of times to cycle through the list of servers before returning an error. The default retries value is 2; the range is 0 to 10.

Timeout is 2 seconds.

Retries is 2 retries.

exit

Returns to context submode.

 

Examples

This example shows how to enter the nbnslist submode and configure the NBNS list and server address:

webvpn(config)# webvpn context c1
webvpn(config-webvpn-context)# nbns-list list2
webvpn(config-webvpn-nbnslist)# nbns-server 10.1.1.2
webvpn(config-webvpn-nbnslist)# exit
webvpn(config-webvpn-context)#

Related Commands

webvpn context

policy group

To define a group-policy template, associate a group-policy with a particular proxy server, and enter the group-policy submode, use the webvpn policy group command from context subcommand mode. Use the no form of this command to remove any commands that you have entered in the WebVPN subcommand mode from the configuration.

policy group group-policy-name

no policy group group-policy-name

Syntax Description

group-policy-name

Name of the group policy.


Defaults

See the "Usage Guidelines" section for the submode command defaults.

Command Modes

WebVPN context submode

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The group-policy-name argument is case-sensitive.

After you enter the policy group command, the prompt changes to the following:

webvpn(config-webvpn-group)#

Table 2-3 lists the commands available to configure the group-policy template.

Table 2-3 Group-policy Commands

Command
Purpose and Guidelines
Defaults

banner value string

Specifies the banner string for the user or group. The string value may contain 7-bit ASCII values, HTML tags, and escape sequences. This string is presented to the user after login.

No string is specified.

exit

Exits from group-policy configuration mode.

 

filter tunnel {ip-acl | ip-expanded-acl | name}

Defines the tunnel-specific access list.

ip-aclIP access list (standard or extended); valid values are from 1 to 199.

ip-expanded-acl—IP expanded access list (standard or extended); valid values are from 1300 to 2699.

name—Access-list name.

No name is specified.

functions {file-access | file-browse | file-entry| svc-enabled| svc-required}

Specifies the file function as follows:

Note You must enable file-access before you can enable file-browse or file-entry.

file-access—Allows you to access the file servers that are listed on the home page.

file-browse—Allows you to browse file servers. When you disable this option, you are denied entry to a file server.

file-entry—Allows you to alter a file in a file server.

svc-enabled—Allows the user of the group to use tunnel mode. If the SVC fails to install on the end user's PC, the end user can continue to use clientless mode or thin-client mode.

svc-required—Tunnel mode is required. If the SVC fails to install on the end user's PC, the end user cannot use other modes.

All values are disabled.

hide-url-bar

Disables the URL bar on the portal page.

Note This command applies only to clientless mode.

 

nbns-list name

Specifies the NBNS list for CIFS as defined in the context configuration.

Supported only with Windows 2000 servers and Linux/UNIX.

Note This command applies only to clientless mode.

 

no

Negates a command or set its defaults.

 

port-forward name

Specifies the port-forward list as defined in the context configuration. Entering the command again overrides the previous setting. The default is to have no list specified,

Note This command applies only to thin-client mode.

No list specified, and port forwarding is disabled.

timeout {idle | session} seconds

Specifies the end-user idle timeout value and maximum session timeout value for the user or group.

idle seconds—Specifies the end-user inactivity. Valid values for idle timeout are from 0 (disabled) to 3600 seconds.

session seconds—Specifies the total session time, regardless of activity. Valid values for session timeout are from 1 to 1209600 seconds.

idle seconds—2100 seconds (35 minutes)

session seconds—43200 seconds (12 hours)

svc

Specifies the tunnel configuration; see the svc command for additional information.

 

url-list name

Specifies the URL list as defined in the context configuration. Entering the command again overrides the previous setting.

Note This command applies only to clientless mode.

No list is specified.


Examples

This example show how to configure the WebVPN context and the WebVPN group-policy:

webvpn(config)# webvpn context cisco
webvpn(config-webvpn-context)# policy group cisco_tunl
webvpn(config-webvpn-group)# function svc-enabled
webvpn(config-webvpn-group)# timeout idle 36000
webvpn(config-webvpn-group)# timeout session 144000
webvpn(config-webvpn-group)# svc address-pool "cisco_tunl_pool"
webvpn(config-webvpn-group)# svc keep-client-installed
webvpn(config-webvpn-group)# svc rekey time 40000
webvpn(config-webvpn-group)# svc rekey method new-tunnel
webvpn(config-webvpn-group)# svc dpd-interval gateway 0
webvpn(config-webvpn-group)# svc dpd-interval client 300
webvpn(config-webvpn-group)# exit
webvpn(config-webvpn-context)#

port-forward

To enter the port-forwarding submode and configure port-forwarding entries, use the port-forward command. Use the no form of this command to remove the given list from the configuration.

port-forward listname

no port-forward listname

Syntax Description

listname

Name for list of forwarded ports.


Defaults

This command has no default settings.

Command Modes

WebVPN context submode

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The listname argument is case-sensitive and can be a maximum of 64 characters.

After you enter the port-forward command, the prompt changes to the following:

webvpn(config-webvpn-port-fwd)#

After you enter the port-forward submode, there are commands available to configure the port-forwarding services. Table 2-4 lists the port-forwarding submode commands.

Table 2-4 Port-Forwarding Submode Commands 

Command
Purpose and Guidelines
Defaults

default local-port port-number

Specifies the default local port; valid values are from 1 to 65535.

 

exit

Exits WebVPN port-fwd submode and returns to WebVPN context submode.

 

local localport

Specifies the local port that is listened upon; a localport value may be used only once within a given listname. Valid values are from 1 to 65535. After you specify the local port, the following keywords and arguments are available:

remote-server remoteserverSpecifies the DNS name or IP address to connect to on the remote server.

remote-port remoteportSpecifies the port to connect to on the remote server. Valid values are from 1 to 65535.

description descriptionSpecifies an application name or short description to display on the end user applet window. The maximum length of the description value is 64 characters.

 

no

Removes the matching line from the configuration.

 

You can specify multiple entries for a given listname value. The listname value is provided to group the port forwarding entries into a list that can be applied to a username or a group policy.

Specifying no removes the matching line from the configuration; the remote server and remote port do not need to be included.

Examples

This example shows how to enter the port-forwarding submode and configure port-forwarding entries:

webvpn(config-webvpn-context)# port-forward abc
webvpn(config-webvpn-port-fwd)# local-port 25 remote-server "mailman" remote-port 25 
description "SMTP server"
webvpn(config-webvpn-port-fwd)# local-port 110 remote-server "pop3-ny" remote-port 110 
description "POP3-server"
webvpn(config-webvpn-port-fwd)# local-port 143 remote-server "imap-ny" remote-port 143 
description "IMAP server"
webvpn(config-webvpn-port-fwd)# 

Related Commands

url-list
webvpn context

show webvpn context

To display information about a specific context, use the show webvpn context command.

show webvpn context name

Syntax Description

name

Specifies the name of the context.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to collect information about the software-forced reset:

webvpn# show web context tunnel
Admin Status: up
Operation Status: up
TCP Policy not configured
SSL Policy not configured
Certificate authentication type: peer certificate is always accepted
AAA Authentication List: webvpn
AAA Authentication Domain not configured
Default Group Policy: tunnel
Associated WebVPN Gateway: s2
Domain Name and Virtual Host not configured
Maximum Users Allowed: 2560 (default)
NAT Address Range: 10.81.12.4-10.81.12.9 mask 255.255.255.0
VRF Name not configured

webvpn#

show webvpn dispatch

To display WebVPN dispatching information, use the show webvpn dispatch command.

show webvpn dispatch {algorithm | member | stats}

Syntax Description

algorithm

Displays the current content load balancing (CLB) algorithm.

member

Displays CLB member table infomation.

stats

Displays the dispatching statistics.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display the WebVPN dispatching statistics:

webvpn# show webvpn dispatch stat
SSLVPN: Dispatching Statistics:
--------------------------------
  Total packets dispatched = 2827
  Total packets need multiple buffers = 12
  Total packets with no core id = 93
  Total packets with embedded core id = 2722
  Per Core Dispatching Statistics:
  --------------------------------
                      Assigned
  Core-ID Symbolic-ID Connections
  ------- ----------- -----------
    1     SwCidIos          43
    7     SwCidVpn1         51

This example shows how to display the current CLB algorithm:

webvpn# show webvpn dispatch algorithm
SSLVPN: Current CLB algorithm:
-------------------------------
   Weighted Round Robin (Master Weight = 5 Slave Weight = 6)

This example shows how to display CLB member table infomation:

webvpn# show webvpn dispatch member
SSLVPN: CLB Member Table
(Current RR Index 1):
Member-Index  Core-ID  Symbolic-ID  Weight  Quota
------------  -------  -----------  ------  -----
    0           1        SwCidIos      5    3
    1           7        SwCidVpn1     6    2

webvpn#

show webvpn gateway

To display gateway information, use the show webvpn gateway command.

show webvpn gateway [name]

Syntax Description

name

(Optional) Name of the gateway.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display information for all gateways:

webvpn# show webvpn gateway 

Gateway Name                       Admin  Operation
------------                       -----  ---------
s1                                 up     up
s2                                 up     up
gateway1                           down   down
tunnel                             down   down

This example shows how to display information for a specific gateway:

webvpn# show webvpn gateway s1
Admin Status: up
Operation Status: up
IP: 10.1.2.140, port: 443
TCP Policy not configured
SSL Policy not configured
SSL Trustpoint: tp1
  Certificate chain for new connections:
    Certificate:
       Key Label: tp1, 1024-bit, not exportable
       Key Timestamp: 12:09:27 UTC Dec 25 2004
       Serial Number: 0FE5
    Root CA Certificate:
       Serial Number: 01
  rsa-general-purpose certificate
  Certificate chain complete

show webvpn install

To display information on installed WebVPN files and packages, use the show webvpn install command.

show webvpn install {file filename | package {csd | svc}| status {csd | svc}}

Syntax Description

file

Displays the contents of the file.

filename

Name of the file.

package

Displays the contents of the package.

csd

Specifies the Cisco Secure Desktop (CDP).

svc

Specifies the SSL VPN client (SVC).

status

Displays the status of the package.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display status information about the SSL VPN client (SVC):

webvpn# show web install status svc
SSLVPN Package SSL-VPN-Client version installed:
CISCO STC win2k+ 1.0.0
1,1,1
Tue 04/08/2005 15:31:20.43

This example shows how to display information about the files included in the SVC package:

webvpn# show web install package svc
SSLVPN Package SSL-VPN-Client installed:
File: \webvpn\stc\1\binaries\detectvm.class, size: 555
File: \webvpn\stc\1\binaries\java.htm, size: 309
File: \webvpn\stc\1\binaries\main.js, size: 8049
File: \webvpn\stc\1\binaries\ocx.htm, size: 244
File: \webvpn\stc\1\binaries\setup.cab, size: 164216
File: \webvpn\stc\1\binaries\stc.exe, size: 90104
File: \webvpn\stc\1\binaries\stcjava.cab, size: 6154
File: \webvpn\stc\1\binaries\stcjava.jar, size: 4053
File: \webvpn\stc\1\binaries\stcweb.cab, size: 12668
File: \webvpn\stc\1\binaries\update.txt, size: 9
File: \webvpn\stc\1\empty.html, size: 214
File: \webvpn\stc\1\images\alert.gif, size: 2042
File: \webvpn\stc\1\images\buttons.gif, size: 1842
File: \webvpn\stc\1\images\loading.gif, size: 313
File: \webvpn\stc\1\images\title.gif, size: 2739
File: \webvpn\stc\1\index.html, size: 4725
File: \webvpn\stc\2\index.html, size: 325
File: \webvpn\stc\version.txt, size: 63
Total files: 18

This example shows how to display the contents of a specific file:

webvpn# show web install file \webvpn\stc\version.txt
SSLVPN File \webvpn\stc\version.txt installed:
CISCO STC win2k+ 1.0.0
1,1,1
Tue 04/08/2005 15:31:20.43
webvpn#

show webvpn nbns

To display information on WebVPN NBNS cache, use the show webvpn nbns command.

show webvpn nbns context {name | all}

Syntax Description

name

Name of the context.

all

Displays information for all contexts.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display status information about the NBNS cache for a specified context:

webvpn# show web nbns context tunnel 
NetBIOS name        IP Address       Timestamp

0 total entries
webvpn# 

This example shows how to display status information about the NBNS cache for all contexts:

webvpn# show web nbns context all
NetBIOS name        IP Address       Timestamp

0 total entries
NetBIOS name        IP Address       Timestamp

0 total entries
NetBIOS name        IP Address       Timestamp

0 total entries
NetBIOS name        IP Address       Timestamp

0 total entries
NetBIOS name        IP Address       Timestamp

0 total entries
webvpn# 

show webvpn platform buffers

To display information about TCP buffer usage, use the show webvpn platform buffers command.

show webvpn-platform buffers [module module]

Syntax Description

module module

(Optional) Valid values for module are as follows:

all—all CPUs

fdu—FDU CPU

ssl1—SSL1 CPU

tcp1—TCP1 CPU


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display the buffer usage and other information in the TCP subsystem:

webvpn# show webvpn-platform buffers module all
Buffers info for TCP module 1
    TCP data buffers used 3340 limit 88064
    TCP ingress buffer pool size 44032 egress buffer pool size 44032
    TCP ingress data buffers min-thresh 5636096 max-thresh 9017344
    TCP ingress data buffers used Current 0 Max 27
    TCP ingress buffer RED shift 9 max drop prob 10
    Conns consuming ingress data buffers 0
    Buffers with App 0
    TCP egress data buffers used Current 0 Max 115
    Conns consuming egress data buffers 0
    In-sequence queue bufs 0 OOO bufs 0
    Per-flow avg qlen 0 Global avg qlen 0
webvpn# 

Related Commands

webvpn policy tcp

show webvpn platform context

To display information on WebVPN context, use the show webvpn platform context command.

show webvpn platform context name [module module]

Syntax Description

name

Name of the context.

module module

Valid values for module are as follows:

all—all CPUs

fdu—FDU CPU

ssl1—SSL1 CPU

tcp1—TCP1 CPU

tcp2—TCP2 CPU


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display status information about the specified context:

webvpn# show webvpn platform context tunnel
Certificate authentication type: peer certificate is always accepted
Admin Status: up
Operation Status: up
webvpn#

This example shows how to display all module status information about the specified context:

webvpn# show webvpn platform context tunnel module all
FDU Service Entry
    Service ID   : 8               Protocol     : 0
    Virtual IP   : 0.0.0.0    Virtual port : 0
    HTTP-redirect: 0

    Hash Index   : 0               Conn Count   : 0
    Bound ID     : 0               State        : DOWN
Service ID 8
  IP address : 116.117.110.110 Port : 0
  MSS : 1460
  SYN timeout (s): 75
  Idle timeout (s) : 600
  FIN wait timeout (s) : 75
  Reassembly timeout (s) : 60
  Connection Rx Buffer Size : 32768
  Connection Tx Buffer Size : 65536
  TOS Carryover Disabled

Service entry in cpu 1:
    Cipher suites: 0xF
    Versions: 0x3
    Options: 0x6
    Current Certificate Index:  0x0 0x0 0x0 0x0 0x0 0x0 0x0
    Certificate Index at 0 location:   0x0 0x0 0x0 0x0 0x0 0x0 0x0
    Certificate Index at 1 location:   0x0 0x0 0x0 0x0 0x0 0x0 0x0
    Flags: 0x202
    Handshake timeout: 0 secs
    Session timeout: 0 secs
    Session cache size: 262144

show webvpn platform crash-info

To collect information about the software-forced reset from the WebVPN Services Module, use the show webvpn platform crash-info command.

show webvpn platform crash-info [brief | details]

Syntax Description

brief

(Optional) Collects a small subset of software-forced reset information, limited to processor registers.

details

(Optional) Collects the full set of software-forced reset information, including exception and interrupt stacks dump (this operation can take up to 10 minutes to complete printing).


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to collect a small subset of software-forced reset information:

webvpn# show webvpn platform crash-info brief

===== SSLVPN SERVICE MODULE - START OF CRASHINFO COLLECTION =====


------------- COMPLEX 0 [VPN_IOS] ----------------------

NVRAM CHKSUM: 0xDABB
NVRAM MAGIC: 0xC8A514F0
NVRAM VERSION: 1

++++++++++ CORE 0 (VPN (slave)) ++++++++++++++++++++++++

   HW_CID: 0
   APPLICATION VERSION: SVCWEBVPN Software (SVCWEBVPN-K9Y9-M), Version 12.3(7.11
)VA(0.117)  INTERIM SOFTWARE \nCompiled Wed 13-Apr-05 02:20 by integ
   APPROXIMATE TIME WHEN CRASH HAPPENED: 02:56:38 UTC Sep 1 2005
   THIS CORE DIDN'T CRASH
   TRACEBACK: 374110 375C0C
   CPU CONTEXT  -----------------------------

$0 : 00000000, AT : 01050000, v0 : 00000000, v1 : 01050000
a0 : 0104F3E0, a1 : 0208A390, a2 : 00000000, a3 : 00000000
t0 : 00000000, t1 : 032B8BC8, t2 : 00000001, t3 : FFFF00FF
t4 : 00368100, t5 : 74696F6E, t6 : 00000000, t7 : 39353438
s0 : 01050000, s1 : 01051F40, s2 : 028E16E0, s3 : 00BA0000
s4 : 00BA0000, s5 : 00BA0000, s6 : 01050000, s7 : 01050000
t8 : 0D0D0D0D, t9 : 00000000, k0 : 00400001, k1 : 00000000
gp : 00FC65E0, sp : 028E16D0, s8 : 00000000, ra : 00374160
LO : F88923EA, HI : DA46BB94, BADVADDR : B60ED79D
EPC : 00374110, ErrorEPC : BFC00C70, SREG : 3400FD03
Cause 00004000 (Code 0x0): Interrupt exception

CACHE ERROR registers  -------------------

CacheErrI: 00000000, CacheErrD: 00000000
ErrCtl: 00000000, CacheErrDPA: 0000000000000000


++++++++++ CORE 1 (IOS (master)) ++++++++++++++++++++++++

   HW_CID: 1
   APPLICATION VERSION: SVCWEBVPN Software (SVCWEBVPN-K9Y9-M), Version 12.3(7.11
)VA(0.117)  INTERIM SOFTWARE \nCompiled Wed 13-Apr-05 02:51 by integ
   APPROXIMATE TIME WHEN CRASH HAPPENED: 02:56:36 UTC Sep 1 2005
   THIS CORE CRASHED
   TRACEBACK: 1C6C7EC 1CC1B20 1CBEC14 1CBEDA8 1CC16EC 1CC1E7C 1CC96C4 1CC9930 1C
C94DC 1CCA570 1CBDF58 1CB69FC 1CB1898 1C7F964 1CE3618 1CE431C
   CPU CONTEXT  -----------------------------

$0 : 00000000, AT : 021D0000, v0 : 00000001, v1 : 00000000
a0 : 0CFA6952, a1 : 00000000, a2 : 00000002, a3 : 00000062
t0 : 00000001, t1 : 00000000, t2 : 00000001, t3 : 00000062
t4 : 00000048, t5 : 0A0D0A0D, t6 : 0A0D0A0A, t7 : 090A0A0A
s0 : 00000000, s1 : 0CFA6950, s2 : 0D583008, s3 : 0CFA6950
s4 : 0CFA6953, s5 : 02270000, s6 : 17394FC8, s7 : 0D4708B8
t8 : 00000005, t9 : 00000001, k0 : 00000000, k1 : 00000000
gp : 021D4080, sp : 0CCE3840, s8 : FFFFFFFF, ra : 01CC1B20
LO : 00000003, HI : 0238A2C0, BADVADDR : 00000000
EPC : 01C6C7EC, ErrorEPC : 01572900, SREG : 3400FD03
Cause 0000000C (Code 0x3): TLB (store) exception

CACHE ERROR registers  -------------------

CacheErrI: 00000000, CacheErrD: 00000000
ErrCtl: 00000000, CacheErrDPA: 0000000000000000

------------- COMPLEX 1 [FDU_TCP_SSL_1] ----------------------

NVRAM CHKSUM: 0x3C34
NVRAM MAGIC: 0xC8A514F0
NVRAM VERSION: 1

++++++++++ CORE 0 (TCP/FDU Processor #1) ++++++++++++++++++++++++

   HW_CID: 2
   APPLICATION VERSION: 2005.03.15 22:14:57 built for mahesh
   APPROXIMATE TIME WHEN CRASH HAPPENED: 11:28:14 UTC Aug 1 2005
   THIS CORE CRASHED
   TRACEBACK: 20A994 20B000 243C54 2444C8 24FF90 21A088 219970 2263B0 2523FC
   CPU CONTEXT  -----------------------------

$0 : 00000000, AT : 00270000, v0 : 0000005C, v1 : 00285760
a0 : 12630E54, a1 : 00000000, a2 : 00000000, a3 : 00000000
t0 : 00000000, t1 : 34007E01, t2 : 34007100, t3 : FFFF00FF
t4 : 0020A9C0, t5 : 82602460, t6 : 00000002, t7 : 00000001
s0 : 12630E54, s1 : 002824DC, s2 : 12630C5C, s3 : 12630C5C
s4 : 002E0000, s5 : 00000003, s6 : 12630C20, s7 : 0026B258
t8 : FFFFFFFF, t9 : 0160A2A0, k0 : 00400001, k1 : 00000000
gp : 00273320, sp : 09DFFD40, s8 : 12630C20, ra : 0020B000
LO : 00000000, HI : 0000004E, BADVADDR : 12630E54
EPC : 0020A994, ErrorEPC : F7EF23EA, SREG : 34007E03
Cause 00008014 (Code 0x5): Address Error (store) exception

CACHE ERROR registers  -------------------

CacheErrI: 00000000, CacheErrD: 00000000
ErrCtl: 00000000, CacheErrDPA: 0000000000000000


++++++++++ CORE 1 (SSL Processor #1) ++++++++++++++++++++++++

   HW_CID: 3
   APPLICATION VERSION: 2005.03.15 22:14:57 built for mahesh
   APPROXIMATE TIME WHEN CRASH HAPPENED: 11:28:14 UTC Aug 1 2005
   THIS CORE DIDN'T CRASH
   TRACEBACK: 449F70 433458 42D0A0 422694
   CPU CONTEXT  -----------------------------

$0 : 00000000, AT : 00490000, v0 : 00000000, v1 : 0E1743D8
a0 : 09E0A534, a1 : 00000002, a2 : 00000002, a3 : 00000002
t0 : 00006100, t1 : 00000000, t2 : B0060100, t3 : FFFF00FF
t4 : 0040A9C0, t5 : A295B1CD, t6 : B22AEDDB, t7 : F9D0B2AC
s0 : 09E0A4E8, s1 : 0048F698, s2 : 00000000, s3 : 0048F600
s4 : 00000000, s5 : 00000000, s6 : 00480000, s7 : 00480000
t8 : 00000002, t9 : 00000001, k0 : 00000000, k1 : 00000000
gp : 004965E0, sp : 123FFF30, s8 : 00000001, ra : 00433458
LO : 999999C9, HI : 0000001F, BADVADDR : 644E427A
EPC : 00449F70, ErrorEPC : FFDF6777, SREG : 34007E03
Cause 0000C000 (Code 0x0): Interrupt exception

CACHE ERROR registers  -------------------

CacheErrI: 00000000, CacheErrD: 00000000
ErrCtl: 00000000, CacheErrDPA: 0000000000000000



===== SSLVPN SERVICE MODULE - END OF CRASHINFO COLLECTION =======

show webvpn platform gateway

To display gateway information WebVPN, use the show webvpn platform gateway command.

show webvpn platform gateway name [debug | module module]

Syntax Description

name

Name of the gateway.

debug

(Optional) Displays debug information for the gateway.

module module

(Optional) Valid values for module are as follows:

all—all CPUs

fdu—FDU CPU

ssl1—SSL1 CPU

tcp1—TCP1 CPU

tcp2—TCP2 CPU


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display status information for a specific gateway:

webvpn# show webvpn platform gateway tunnel
IP: 10.1.2.14, port: 443
rsa-general-purpose certificate trustpoint: mytp
  Certificate chain for new connections:
    Certificate:
       Key Label: mytp, 1024-bit, not exportable
       Key Timestamp: 12:09:27 UTC Dec 25 2004
       Serial Number: 0FE5
    Root CA Certificate:
       Serial Number: 01
  Certificate chain complete
Admin Status: up
Operation Status: up
webvpn# 

This example shows how to display debug information for a specific gateway:

webvpn# show webvpn platform gateway s1 debug
IP: 10.1.2.14, port: 443
rsa-general-purpose certificate trustpoint: mytp
  Certificate chain for new connections:
    Certificate:
       Key Label: mytp, 1024-bit, not exportable
       Key Timestamp: 12:09:27 UTC Dec 25 2004
       Serial Number: 0FE5
    Root CA Certificate:
       Serial Number: 01
  Certificate chain complete
Admin Status: up
Operation Status: up

Service ID: 1        Bound  ID: -1
Virtual IP: 10.1.2.14             Port     : 443
VLAN ID   : 0          MAC Address : 0000.0000.0000
State     : PROXY VALID
Enabled   : Yes
Secondary : No
Client NAT: disable
Server NAT: disable
webvpn#

This example shows how to display status information for all CPUs for a specific gateway:

webvpn# show web platform gateway s1 module all
FDU Service Entry
    Service ID   : 1               Protocol     : 6
    Virtual IP   : 64.102.223.140    Virtual port : 443
    HTTP-redirect: 0

    Hash Index   : 896             Conn Count   : 0
    Bound ID     : -1              State        : UP
Service ID 1
  IP address : 10.1.2.14 Port : 443
  MSS : 1460
  SYN timeout (s): 75
  Idle timeout (s) : 600
  FIN wait timeout (s) : 75
  Reassembly timeout (s) : 60
  Connection Rx Buffer Size : 32768
  Connection Tx Buffer Size : 65536
  TOS Carryover Disabled

Service entry in cpu 1:
    Cipher suites: 0xF
    Versions: 0x3
    Options: 0x6
    Current Certificate Index:  0x0 0x1 0x0 0x0 0x0 0x0 0x0
    Certificate Index at 0 location:   0x0 0x0 0x0 0x0 0x0 0x0 0x0
    Certificate Index at 1 location:   0x0 0x0 0x0 0x0 0x0 0x0 0x0
    Flags: 0x201
    Handshake timeout: 0 secs
    Session timeout: 0 secs
    Session cache size: 262144

webvpn#

show webvpn platform mac address

To display the current MAC address, use the show webvpn platform mac address command.

show webvpn platform mac address

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display the current MAC address that is used in the WebVPN Services Module:

webvpn# show webvpn platform mac address
SVCWEBVPN module MAC address: 000d.29f0.c24c

webvpn#

show webvpn platform policy

To display the SSL or TCP policy information, use the show webvpn platform policy command.

show webvpn platform policy {ssl | tcp} name

Syntax Description

ssl

Specifies the SSL policy.

tcp

Specifies the TCP policy.

name

Name of the SSL or TCP policy.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display SSL policy information on the WebVPN Services Module:

webvpn# show webvpn platform policy ssl 
SSL Policy Name                             Usage-Count

webvpn#

show webvpn platform version

To display the current image version, use the show webvpn platform version command.

show webvpn platform version

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display the image version that is currently running on the WebVPN Services Module:

webvpn# show webvpn platform version 
Cisco IOS Software, SVCWEBVPN Software (SVCWEBVPN-K9Y9-M), Version 12.3(8)VA(1.1)
Copyright (c) 1986-2005 by Cisco Systems, Inc.
Compiled Thu 26-May-05 02:44 by integ

ROM: System Bootstrap, Version 12.2(11)YS1 RELEASE SOFTWARE

webvpn-alpha uptime is 5 days, 19 hours, 51 minutes
System returned to ROM by power-on
System image file is "tftp://10.1.1.1/unknown"
AP Version 1.1(0.97)

webvpn#

show webvpn platform vlan

To display VLAN information, use the show webvpn platform vlan command.

show webvpn platform vlan [vlan-id ]

Syntax Description

vlan-id

(Optional) VLAN ID. Displays information for a specific VLAN; valid values are from 2 to 1005.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display all the VLANs that are configured on the WebVPN Services Module:

webvpn# show webvpn platform vlan
Vlan-id  IP address      NetMask          VRF
-------  ----------      -------          ------
10       10.81.12.3      255.255.255.0    -
20       20.102.223.139  255.255.255.248  -

This example shows how to display information about a specific VLAN on the WebVPN Services Module:

webvpn# show webvpn platform vlan 10
Vlan-id  IP address      NetMask          VRF
-------  ----------      -------          ------
10       10.81.12.3      255.255.255.0    -
------ FDU module info ----
FDU Vlan Entry
    VLAN ID        : 10
    My IP Addr     : 10.81.12.3
    My Net Mask    : 255.255.255.0
    VRF ID         : 0

show webvpn policy

To display the configured WebVPN policies, use the show webvpn policy command.

show webvpn policy {group name context name | tcp [name] | ssl [name]}

Syntax Description

group name context name

Displays the group policies for the specified context.

tcp

Displays the configured TCP policies.

ssl

Displays the configured SSL policies.

name

(Optional) Policy name.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display information about the HTTP header policy:

webvpn# show web policy group tunnel context tunnel
WEBVPN: group policy = tunnel ; context = tunnel
      idle timeout = 2100 sec
      session timeout = 43200 sec
      functions = svc-enabled
      address pool name = "addr"
      dpd client timeout = 300 sec
      dpd gateway timeout = 300 sec
      keep sslvpn client installed = disabled
      rekey interval = 3600 sec
      rekey method = ssl
      lease duration = 43200 sec
webvpn# 

Related Commands

webvpn policy ssl
webvpn policy tcp

show webvpn session

To display information about the WebVPN session, use the show webvpn session command.

show webvpn session {context {name | all} | user name context {name | all}}

Syntax Description

context name

Specifies the context name.

user name

Specifies the user name.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Examples

This example shows how to display session information about the specified context:

webvpn# show webvpn session context c1
WebVPN context name: c1
Client_Login_Name  Client_IP_Address  No_of_Connections  Created  Last_Used
user1              10.2.1.220                 2         04:47:16  00:01:26
user2              10.2.1.221                 2         04:48:36  00:01:56

This example shows how to display session information for a specific user:

webvpn# show webvpn session user user1 context c1
WebVPN user name = user1 ; IP address = 10.2.1.220 ; context = c1
    No of connections: 2
    Created 04:50:21, Last-used 00:00:31
    Client Port: 2503, Server IP Addr: 10.102.31.9, Server Port: 80
    Client Port: 2504
    User Policy Parameters
      Group name = test
    Group Policy Parameters
      url list name = "Cisco test URL list"
      idle timeout = 2100 sec
      session timeout = 43200 sec
      port forward name = "Mail Servers"
      dpd client timeout = 300 sec
      dpd gateway timeout = 300 sec
      keep sslvpn client installed = disabled
      rekey interval = 3600 sec
      rekey method = ssl
      lease duration = 43200 sec

show webvpn stats

To display information about the statistics counter, use the show webvpn stats command.

show webvpn stats [type]

Syntax Description

type

(Optional) See the "Usage Guidelines" section for additional information.


Defaults

This command has no default settings.

Command Modes

EXEC

Command History

Release
Modification

WebVPN Services Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The valid options for type are as follows:

cifs [detail][context {name | all}]

context {name | all}

detail [context {name | all}]

mangle [detail][context {name | all}]

port-forward [detail][context {name | all}]

socket [detail][context {name | all}]

tunnel [detail][context {name | all}]

Examples

This example shows how to display all the statistics counters that are collected on the WebVPN Services Module:

webvpn# show webvpn stats
User session statistics:
    Active user sessions     : 1          AAA pending reqs         : 0
    Peak user sessions       : 6          Peak time                : 17:22:16
    Active user TCP conns    : 2          Terminated user sessions : 29
    Session alloc failures   : 0          Authentication failures  : 3
    VPN session timeout      : 1          VPN idle timeout         : 9
    User cleared VPN sessions: 0          Exceeded ctx user limit  : 0
    Exceeded total user limit: 0

Mangling statistics:
    Relative urls            : 15705      Absolute urls            : 41850
    Non-http(s) absolute urls: 9306       Non-standard path urls   : 1005
    Interesting tags         : 200329     Uninteresting tags       : 398899
    Interesting attributes   : 164642     Uninteresting attributes : 272669
    Embedded script statement: 10226      Embedded style statement : 2800
    Inline scripts           : 34868      Inline styles            : 26475
    HTML comments            : 6018       HTTP/1.0 requests        : 148
    HTTP/1.1 requests        : 8115       Unknown HTTP version     : 0
    GET requests             : 6290       POST requests            : 95
    CONNECT requests         : 0          Other request methods    : 1878
    Through requests         : 6172       Gateway requests         : 2091
    Pipelined requests       : 7          Req with header size >1K : 1
    Processed req hdr bytes  : 5320280    Processed req body bytes : 529871
    HTTP/1.0 responses       : 797        HTTP/1.1 responses       : 6277
    HTML responses           : 1919       CSS responses            : 80
    XML responses            : 2476       JS responses             : 171
    Other content type resp  : 1435       Chunked encoding resp    : 1926
    Resp with encoded content: 0          Resp with content length : 3926
    Close after response     : 1222       Resp with header size >1K: 0
    Processed resp hdr size  : 1870948    Processed resp body bytes: 65670616
    Backend https response   : 245        Chunked encoding requests: 0

CIFS statistics:
  SMB related Per Context:
    TCP VC's                 : 0          UDP VC's                 : 0
    Active VC's              : 0          Active Contexts          : 0
    Aborted Conns            : 0
  NetBIOS related Per Context:
    Name Queries             : 0          Name Replies             : 0
    NB DGM Requests          : 0          NB DGM Replies           : 0
    NB TCP Connect Fails     : 0          NB Name Resolution Fails : 0
  SMB related Global:
    Sessions in use          : 0          Mbufs in use             : 0
    Mbuf Chains in use       : 0          Active VC's              : 0
    Active Contexts          : 0          Browse Errors            : 0
    Empty Browser List       : 0          NetServEnum Errors       : 0
    Empty Server List        : 0          NBNS Config Errors       : 0
    NetShareEnum Errors      : 0
  HTTP related Per Context:
    Requests                 : 24         Request Bytes RX         : 8508
    Request Packets RX       : 0          Response Bytes TX        : 1465966
    Response Packets TX      : 975        Active Connections       : 0
    Active CIFS context      : 0          Requests Dropped         : 0
  HTTP related Global:
    Server User data         : 0          CIFS User data           : 0
    Net Handles              : 0          Active CIFS context      : 0
    Authentication Fails     : 0          Operations Aborted       : 0
    Timers Expired           : 0          Pending Close            : 0
    Net Handles Pending SMB  : 0          File Open Fails          : 0
    Browse Network Ops       : 0          Browse Network Fails     : 0
    Browse Domain Ops        : 0          Browse Domain Fails      : 0
    Browse Server Ops        : 0          Browse Server Fails      : 0
    Browse Share Ops         : 0          Browse Share Fails       : 0
    Browse Dir Ops           : 0          Browse Network Fails     : 0
    File Read Ops            : 0          File Read Fails          : 0
    File Write Ops           : 0          File Write Fails         : 0
    Folder Create Ops        : 0          Folder Create Fails      : 0
    File Delete Ops          : 0          File Delete Fails        : 0
    File Rename Ops          : 0          File Rename Fails        : 0

Socket statistics:
    Sockets in use           : 2          Sock Usr Blocks in use   : 2
    Sock Data Buffers in use : 0          Sock Buf desc in use     : 0
    Select timers in use     : 2          Sock Select Timeouts     : 0
    Sock Tx Blocked          : 49         Sock Tx Unblocked        : 49
    Sock Rx Blocked          : 0          Sock Rx Unblocked        : 0
    Sock UDP Connects        : 0          Sock UDP Disconnects     : 0
    Sock Premature Close     : 0          Sock Pipe Errors         : 5

Port Forward statistics:
  Client                                Server
    in pkts                  : 0          out pkts                 : 0
    in bytes                 : 0          out bytes                : 0
    out pkts                 : 0          in pkts                  : 0
    out bytes                : 0          in bytes                 : 0

Tunnel Statistics:
    Active connections       : 0
    Peak connections         : 1          Peak time                : 5d16h
    Connect succeed          : 6          Connect failed           : 0
    Reconnect succeed        : 1          Reconnect failed         : 0
    DPD timeout              : 0
  Client                                Server
    in  CSTP frames          : 23098      out IP pkts              : 23093
    in  CSTP data            : 23093
    in  CSTP control         : 5
    in  CSTP bytes           : 4956832    out IP bytes             : 4771852
    out CSTP frames          : 32086      in  IP pkts              : 32084
    out CSTP data            : 32084
    out CSTP control         : 2
    out CSTP bytes           : 16136526   in  IP bytes             : 16512477

webvpn#

Most of the counters are self-explanatory. The following descriptions are for the counters that are not self-explanatory:

User session statistics:

Terminated user sessions—Number of sessions that were logged out from the time last clear keyword was executed.

Session alloc failures—Indicates that the system is running out of memory.

Authentication failures—AAA responded with failure status for given username or password .

VPN session timeout—Number of sessions that were cleared because of session timeout expiry.

VPN idle timeout—Number of sessions that were cleared because of idle timeout expiry.

User cleared vpn sessions—Number of sessions that were cleared because of the clear webvpn session command.

Exceeded ctx user limit—Number of sessions that were rejected because of exceeding max-users limit configured under context.

Exceeded total user limit—Number of sessions that were rejected because of exceeding the system user limit (currently 8000).

Mangling statistics:

Close after response—Number of connections that were closed after sending responses because of lack of content length.

CIFS statistics:

SMB-related counters per context:

TCP/UDP VC's—Back-end TCP/UDP connections established successfully so far.

Active VC's—Currently active TCP/UDP connections.

Active Contexts—Currently active SMB contexts.

Aborted Conns—TCP connections aborted by the peer.

NetBIOS-related counters per context:

Name Queries—NBNS name queries sent.

Name Query Replies—NBNS name query replies received. Mismatch indicates that browsers, PDC, and servers could not be contacted.

NBDGM requests—NB datagram service-related get backup browser list queries sent.

NBDGM replies—NB datagram service-related get backup browser list replies received. Request and reply mismatch indicates that browse domain attempt would not work.

NB TCP connect fails—NB TCP connection attempts that resulted in failures. Indicates connectivity issues to PDC and file servers.

SMB-related counters for all contexts:

Sessions in Use—Back-end SMB sessions in use (active)

Mbufs in use—Application buffer descriptors in use.

Mbuf Chains in use—Application buffers in use.

Active VCs—Total active back-end SMB connections in the system.

Active Context—Total active back-end SMB context in the system.

Browse Errors—Indicates failed browse domain attempts.

Empty Browse list—Indicates number of times empty backup browse list replies received.

NetServEnum errors—Indicates number of failed attempts at receiving list of servers in a specific domain.

NetShareEnum errors—Indicates number of failed attempts at receiving list of files and folders in a specific share.

HTTP-related counters per context:

Active Connections—Connections on which CIFS requests are being processed.

Active CIFS Context—CIFS application module context on which CIFS requests are being processed.

HTTP-related counters for all contexts:

Server User Data—Number of entries in the per server username and password cache.

CIFS User Data—Default username and password cache entries.

Net Handles—Total connections in the system (includes active as well as idle).

Active CIFS context—Global count of active CIFS application module contexts.

Authentication fails—CIFS HTTP requests processed without a WebVPN cookie or an expired WebVPN cookie.

Operations Aborted—Back-end operations that were aborted because the HTTP connection was lost. Indicates that CIFS transactions are not completing successfully.

Pending Close—Number of times close is pending, waiting for Tx to unblock and finish sending pending data.

Socket statistics:

Tx Blocked—Number of times that application send was blocked by TCP congestion control.

Tx Unblocked—Number of times that application send resumed after being blocked due to TCP congestion control. If transmit blocked and unblocked do not match after a sufficient period of time, then the transaction is stalled.

Rx Blocked—Number of times application blocked further reception of data from TCP layer. This indicates application buffer starvation or processing limit.

Rx Unblocked—Number of times application resumed further reception of data from TCP layer. If receive blocked and unblocked do not match after a sufficient period of time, then the transaction is stalled.

Premature Close—Number of times that application closed the connection before it could be established.

Select Timeouts—Number of times that application timed out while waiting for a reply in a request and reply exchange or waiting for a TCP connection to be established.

This example shows how to display CIFS statistics on the WebVPN Services Module:

webvpn# show webvpn stats cifs
CIFS statistics:
  SMB related Per Context:
    TCP VC's                 : 0          UDP VC's                 : 0
    Active VC's              : 0          Active Contexts          : 0
    Aborted Conns            : 0
  NetBIOS related Per Context:
    Name Queries             : 0          Name Replies             : 0
    NB DGM Requests          : 0          NB DGM Replies           : 0
    NB TCP Connect Fails     : 0          NB Name Resolution Fails : 0
  SMB related Global:
    Sessions in use          : 0          Mbufs in use             : 0
    Mbuf Chains in use       : 0          Active VC's              : 0
    Active Contexts          : 0          Browse Errors            : 0
    Empty Browser List       : 0          NetServEnum Errors       : 0
    Empty Server List        : 0          NBNS Config Errors       : 0
    NetShareEnum Errors      : 0
  HTTP related Per Context:
    Requests                 : 24         Request Bytes RX         : 8508
    Request Packets RX       : 0          Response Bytes TX        : 1465966
    Response Packets TX      : 975        Active Connections       : 0
    Active CIFS context      : 0          Requests Dropped         : 0
  HTTP related Global:
    Server User data         : 0          CIFS User data           : 0
    Net Handles              : 0          Active CIFS context      : 0
    Authentication Fails     : 0          Operations Aborted       : 0
    Timers Expired           : 0          Pending Close            : 0
    Net Handles Pending SMB  : 0          File Open Fails          : 0
    Browse Network Ops       : 0          Browse Network Fails     : 0
    Browse Domain Ops        : 0          Browse Domain Fails      : 0
    Browse Server Ops        : 0          Browse Server Fails      : 0
    Browse Share Ops         : 0          Browse Share Fails       : 0
    Browse Dir Ops           : 0          Browse Network Fails     : 0
    File Read Ops            : 0          File Read Fails          : 0
    File Write Ops           : 0          File Write Fails         : 0
    Folder Create Ops        : 0          Folder Create Fails      : 0
    File Delete Ops          : 0          File Delete Fails        : 0
    File Rename Ops          : 0          File Rename Fails        : 0

webvpn# 

This example shows how to display the statistics for a specific context:

webvpn# show web stats context tunnel
WebVPN context name : tunnel
User session statistics:
    Active user sessions     : 0          AAA pending reqs         : 0
    Peak user sessions       : 1          Peak time                : 5d16h
    Active user TCP conns    : 0          Terminated user sessions : 5
    Session alloc failures   : 0          Authentication failures  : 0
    VPN session timeout      : 1          VPN idle timeout         : 0
    User cleared VPN sessions: 0          Exceeded ctx user limit  : 0

Mangling statistics:
    Relative urls            : 0          Absolute urls            : 0
    Non-http(s) absolute urls: 0          Non-standard path urls   : 0
    Interesting tags         : 0          Uninteresting tags       : 0
    Interesting attributes   : 0          Uninteresting attributes : 0
    Embedded script statement: 0          Embedded style statement : 0
    Inline scripts           : 0          Inline styles            : 0
    HTML comments            : 0          HTTP/1.0 requests        : 0
    HTTP/1.1 requests        : 111        Unknown HTTP version     : 0
    GET requests             : 106        POST requests            : 5
    CONNECT requests         : 0          Other request methods    : 0
    Through requests         : 0          Gateway requests         : 111
    Pipelined requests       : 0          Req with header size >1K : 0
    Processed req hdr bytes  : 43741      Processed req body bytes : 265
    HTTP/1.0 responses       : 0          HTTP/1.1 responses       : 0
    HTML responses           : 0          CSS responses            : 0
    XML responses            : 0          JS responses             : 0
    Other content type resp  : 0          Chunked encoding resp    : 0
    Resp with encoded content: 0          Resp with content length : 0
    Close after response     : 0          Resp with header size >1K: 0
    Processed resp hdr size  : 0          Processed resp body bytes: 0
    Backend https response   : 0          Chunked encoding requests: 0

CIFS statistics:
  SMB related Per Context:
    TCP VC's                 : 0          UDP VC's                 : 0
    Active VC's              : 0          Active Contexts          : 0
    Aborted Conns            : 0
  NetBIOS related Per Context:
    Name Queries             : 0          Name Replies             : 0
    NB DGM Requests          : 0          NB DGM Replies           : 0
    NB TCP Connect Fails     : 0          NB Name Resolution Fails : 0
  HTTP related Per Context:
    Requests                 : 5          Request Bytes RX         : 1840
    Request Packets RX       : 0          Response Bytes TX        : 1435222
    Response Packets TX      : 938        Active Connections       : 0
    Active CIFS context      : 0          Requests Dropped         : 0

Socket statistics:
    Sockets in use           : 0          Sock Usr Blocks in use   : 0
    Sock Data Buffers in use : 0          Sock Buf desc in use     : 0
    Select timers in use     : 0          Sock Select Timeouts     : 0
    Sock Tx Blocked          : 0          Sock Tx Unblocked        : 0
    Sock Rx Blocked          : 0          Sock Rx Unblocked        : 0
    Sock UDP Connects        : 0          Sock UDP Disconnects     : 0
    Sock Premature Close     : 0          Sock Pipe Errors         : 0

Port Forward statistics:
  Client                                Server
    in pkts                  : 0          out pkts                 : 0
    in bytes                 : 0          out bytes                : 0
    out pkts                 : 0          in pkts                  : 0
    out bytes                : 0          in bytes                 : 0

Tunnel Statistics:
    Active connections       : 0
    Peak connections         : 1          Peak time                : 5d16h
    Connect succeed          : 6          Connect failed           : 0
    Reconnect succeed        : 1          Reconnect failed         : 0
    DPD timeout              : 0
  Client                                Server
    in  CSTP frames          : 23098      out IP pkts              : 23093
    in  CSTP data            : 23093
    in  CSTP control         : 5
    in  CSTP bytes           : 4956832    out IP bytes             : 4771852
    out CSTP frames          : 32086      in  IP pkts              : 32084
    out CSTP data            : 32084
    out CSTP control         : 2
    out CSTP bytes           : 16136526   in  IP bytes             : 16512477

webvpn#

snmp-server enable

To configure the SNMP traps and informs, use the snmp-server enable command. Use the no form of this command to disable SNMP traps and informs.

[no] snmp-server enable {informs | traps {ipsec | isakmp | snmp | tty}}

Syntax Description

informs

Enables SNMP informs.

traps

Enables SNMP traps.

ipsec

Enables IPSec traps. See the "" section for additional options.

isakmp

Enables ISAKMP traps. See the ""section for additional options.

snmp

Enables SNMP traps. See the "" section for additional options.

tty

Enables TCP connection traps.


Defaults

This command has no default setting.

Command Modes

Global configuration

Command History

Release
Modification

SSL Services Module Release 2.1(1)

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The ipsec keyword has the following options:

ipsec crptomap {add | attach | delete | detach}

ipsec too-many-sas

ipsec tunnel {start | stop}

The isakmp keyword has the following options:

isakmp {policy {add | delete} | tunnel {start | stop}}

The snmp keyword has the following options:

snmp [authentication | coldstart | linkdown | linkup | warmstart]

Examples

This example shows how to enable SNMP informs:

wwbvpn(config)# snmp-server enable informs 
wwbvpn(config)# 

This example shows how to enable traps:

wwbvpn(config)# snmp-server enable traps 
wwbvpn(config)# 

This example shows how to enable authentication traps:

wwbvpn(config)# snmp-server enable traps snmp authnetication 
wwbvpn(config)# 

svc

To configure the tunnel capabilities for a group-policy context, use the svc command. Use the no form of this command to remove any of the svc commands that you have entered.

svc command

Syntax Description

command

Specifies the configuration command; see Table 2-5 for a list of available commands.


Defaults

See Table 2-5 for the default settings.

Command Modes

WebVPN group context submode

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The prompt for the svc command is the same as the group-policy prompt.

Table 2-5 lists the commands available to configure tunnel-mode capability for a group context.

Table 2-5 Tunnel-Mode Configuration Commands 

Command
Purpose and Guidelines
Default

address-pool address-pool-name

Assigns addresses from the pool to the remote users.

 

default-domain default-domain-name

Specifies the default domain to be used for the user/group, if tunnel-mode WebVPN is enabled for the user/group.

 

dns-server (primary | secondary} ip-address

Specifies the primary and secondary DNS servers for web browsing. After the SSL VPN client (SVC) is installed, the active web browser is deactivated and a new browser is launched. The DNS server information specified here is for the newly launched browser. Once the connection is closed, the previous DNS settings are reapplied.

 

dpd-interval {client timeout} | {gateway timeout}

Specifies the dead peer detection (DPD) timeout values for the gateway or the client, if tunnel-mode WebVPN is enabled for the user or group. The DPD timer is used to determine if a DPD packet needs to be sent to the peer. The DPD timer is reset every time a Cisco SSL Tunnel Protocol (CSTP) frame is received from the peer.

gateway timeout—Specifies the DPD timeout values for the SG; valid values are from 0 (disabled) to 3600 seconds.

client timeoutSpecifies the DPD timeout values for the client; valid values are from 0 (disabled) to 3600 seconds.

Disabled for the gateway and the client.

homepage url

Configures the URL of the web page to be displayed to the user upon login. The URL string specifies the path of the URL. The maximum length for the URL string is 255 characters. Entering the no form of this command removes the command from the configuration.

No web page is specified.

keep-client-installed

Keeps the SVC installed after the connection is closed.

 

msie-proxy exception {ip-address | dns-name}

Specifies the Microsoft Internet Explorer (MSIE) browser proxy settings.

Note This command is supported only with the MSIE browser.

The exception keyword specifies a single DNS name or IP address for traffic that is not sent through a proxy.

Disabled.

msie-proxy server {ip-address | dns_name}[: port]

Specifies the Microsoft Internet Explorer (MSIE) browser proxy settings.

Note This command is supported only with the MSIE browser.

The server keyword specifies an IP address or DNS name, optionally followed by a colon and port number, that is used by all the proxy settings in the browser (HTTP, Secure, FTP, Gopher) except Socks.

Disabled.

msie-proxy option {auto | bypass-local | none}

Specifies the Microsoft Internet Explorer (MSIE) browser proxy settings.

Note This command is supported only with the MSIE browser.

The option none keyword specifies that the browser does not use a proxy.

The option auto keyword specifies that the browser proxy settings are automatically detected.

The option bypass-local keyword specifies that the local addresses bypass the proxy.

option none

rekey method {new-tunnel | ssl}

no rekey method

Specifies the rekey method. Entering the no form of this command disables rekeying.

new-tunnel—Terminates the existing tunnel and requests a new tunnel.

ssl—Initiates an SSL rehandshake.

If rekeying is enabled, the default method is ssl.

rekey {time interval}

no rekey time

Specifies when the VPN client rekeys the SSL tunnel. This interval is time-based. Entering the no form of this command disables the rekey-time interval.

interval—Valid values are from 0 to 43200 seconds.

21600 seconds (6 hours).

split dns string

Specifies the split-tunnel parameters.

string—Name or IP address of the DNS server.

 

split exclude {ip-address netmask | local-lans}

Allows you to specify the traffic that is sent directly to an external website without being tunneled through the internal network; all other traffic is tunneled.

Note You can specify either the split include or the split exclude command; you cannot specify both keywords. You can specify up to 200 addresses for either the split include or split exclude keyword by entering the command multiple times.

ip-address netmask—Address of traffic that is not tunneled.

local-lans—Specifies that the end user's local LAN traffic is not tunneled.

 

split include ip-address netmask

Allows you to specify the traffic that is tunneled; all other traffic is not tunneled through the internal network.

Note You can specify either the split include or the split exclude command; you cannot specify both keywords. You can specify up to 200 addresses for either the split include or split exclude keyword by entering the command multiple times.

ip-address netmask—Address of traffic that is tunneled.

 

wins-server {primary | secondary} ip-address

Specifies the primary or secondary WINS server.

 

url-list

To enter the URL submode to configure the URL lists, use the url-list command. Use the no form of this command to remove the given list from the configuration.

url-list listname

no url-list listname

Syntax Description

listname

Name for the URL list.


Defaults

This command has no default settings.

Command Modes

WebVPN context submode

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The listname argument is case-sensitive and can be a maximum of 64 characters.

After you enter the url-list command, the prompt changes to the following:

webvpn(config-webvpn-url)#

After you enter the URL submode, there are commands available to configure the URL lists. Table 2-6 lists the URL submode commands.

Table 2-6 URL Submode Commands 

Command
Purpose and Guidelines
Default

exit

Exits WebVPN URL submode and returns to WebVPN context submode.

 

heading text

Specifies the heading text for the group of URLs. Enclose the text value within quotation marks if the heading includes any spaces.

You can specify only one heading per list name.

 

url-text text url-value url[/exchage]

Specifies the text the user sees for the link on their home page; the text must be unique within a given listname. Enclose the text value within quotation marks if the text includes any spaces.

 

The url-value url keyword and argument specifies the URL that the link goes to. To use Outlook Web Access (OWA) for web-based email, append the URL with the /exchange keyword (requires authentication to an Exchange server).

You can specify multiple URLs for a given list name.

This example shows how to configure the URL list:

webvpn(config-webvpn-context)# url-list cisco
webvpn(config-webvpn-url)# url-text cisco url-value http://cisco.com
webvpn(config-webvpn-url)# url-text CNN url-value http://cnn.com
webvpn(config-webvpn-url)# url-text yahoo url-value http://yahoo.com
webvpn(config-webvpn-url)# url-text payroll url-value http://10.1.2.215/payroll
webvpn(config-webvpn-url)# url-text finance url-value https://finance.cisco.com
webvpn(config-webvpn-url)# url-text "OWA server" url-value http://mail.cisco.com/exchange
webvpn(config-webvpn-url)# exit
webvpn(config-webvpn-context)#

Related Commands

webvpn context

webvpn context

To enter the WebVPN context submode and define the virtual WebVPN context, use the webvpn context command. Use the no form of this command to remove any commands that you have entered in the WebVPN subcommand mode from the configuration.

webvpn context [vpn-name]

no webvpn context vpn-name

Syntax Description

vpn-name

(Optional) Name of the WebVPN instance.


Defaults

This command has no default settings.

Command Modes

Global configuration

Command History

Release
Modification

WebVPN Module Release 1.1

Support for this command was introduced on the Catalyst 6500 series switches.


Usage Guidelines

The vpn-name argument is case-sensitive.

After you enter the webvpn context command, the prompt changes to the following:

webvpn(config-webvpn-context)#

After you enter the context submode, there are commands available to configure the context services. Table 2-7 lists the virtual context submode commands.

Table 2-7 Virtual WebVPN Context Submode Commands

Command
Purpose and Guidelines
Defaults

aaa authentication {{domain domain-list} | {list listname}}

Specifies AAA configuration parameters for context.

domain domain-list—Specifies the name of the domain used for authentication.

list listnameSpecifies the name of the authentication list.

 

default-group-policy default-policy-name

Specifies the default group policy that the virtual WebVPN context instance uses. See the policy group command for information on group policies.

 

exit

Exits from the context submode and returns to the global configuration mode.

 

gateway gateway-name {{domain-name domain-name} | {virtual-host hostname}}

Specifies the corresponding virtual gateway instance configured on the secure gateway and the mapping methods (for example, IP address, URL, and domain name) as follows:

gateway-name—Name of the virtual gateway configured on the system.

domain-name domain-name—(Optional) Maps to a specific domain name. The domain-name argument is a ASCII string, which is used to specify a corporate-specific domain name (for example, cisco.com) for the virtual WebVPN instance.

virtual-host hostname—(Optional) Maps to a specific virtual host.

Virtualization is performed through a unique IP address.

inservice

Brings context to inservice.

 

login-message string

no login-message

Specifies the text that prompts the user to login. Limited to 255 characters. Use the no form of this command to return to the default setting.

string is Please enter your username and password.

logo [file filename | none]

Specifies the custom logo image that is displayed on the login and home pages.

file filename—(Optional) Specifies the filename of a file that is uploaded by the administrator to the security gateway.

 

nat-address start-address end-address {netmask netmask}

Specifies the NAT addresses to be used in opening a server connection. The addresses specified in the nat-address command must match one of the subnets configured on the WebVPN subinterfaces.

start-address—Starting IP address that defines the range of addresses in the address pool.

end-address—Ending IP address that defines the range of addresses in the address pool.

netmask netmask—Network mask that indicates which address bits belong to the network and subnetwork fields and which bits belong to the host field. Specify the netmask of the network to which the pool addresses belong.

 

nbns-list name

Enters nbmslist submode and allows you to create the NBNS list name. See the nbns-list command for information on configuring the NBNS list.

 

password-prompt prompt

Configures the initial WebVPN login password prompt. The maximum length of prompt is 16 characters.

prompt is Password:

policy group policy-name

Enters the group submode and allows you to configure group policy settings. See the policy group command for information on configuring the group policy.

 

policy ssl policy-name

Specifies the SSL policy that the SSL protocol uses.

 

policy tcp policy-name

Specifies the TCP policy that the TCP protocol uses.

 

port-forward listname

Enters the port-forwarding submode and allows you to configure the list of ports to which the user has access. See the port-forward command for information on configuring port forwarding.

 

secondary-color color

no secondary-color

Specifies the color of the secondary title bars on the login, home, and file-access pages. See Table 2-8 for valid values.

The default color is purple.

secondary-text-color [black | white]

no secondary-text-color

Specifies the color of the text on the secondary bars. It is restricted to be aligned with the title bar text color; valid values are black and white. Use the no form of this command to return to the default setting.

black

ssl authenticate verify {all | none}

Configures the SSL protocol uses.

authenticate verify—Specifies the SSL certificate verification method.

all—Verifies all the CRLs along with signature authenticity.

none—Does not verify the certificate from the peer.

all

text-color [black | white]

no text-color

Specifies the color of the text on the title bars. It is restricted to just two values to limit the number of icons that need to exist for the toolbar; valid values are black and white. Use the no form of this command to return to the default setting.

white

title string

no title

Specifies the HTML title string in the browser title and on the title bar. Limited to 255 characters. Use the no form of this command to return to the default setting.

string is WebVPN Service.

title-color color

no title-color

Specifies the color of the title bars on the login, home, and file-access pages. See Table 2-8 for valid values.

The default color is purple.

username-prompt prompt

Configures the initial WebVPN login username prompt. The maximum length of prompt is 16 characters.

prompt is Login:

url-list listname

Enters the URL submode and allows you to configure the list of URLs that display on the portal Web page. See the url-list command for information on configuring the URL entries.

 

vrf-name vrf-name

Specifies the VRF domain configured for the virtual WebVPN context.

 

The WebVPN context links the previously configured address resolution, gateway, and authentication configurations.

To configure clientless mode, configure the URL lists and the group policy. To access email using Outlook Web Access (OWA), configure the URL list to point to the Microsoft Exchange server (for example, http://ipaddr/exchange).

To configure thin-client mode, configure the list of ports to forward and configure the group policy.

To configure file sharing using the common Internet file system (CIFS), configure the NetBIOS name service (NBNS) list , the server address, and the group policy.

Table 2-8 shows the valid values for color when entering the title-color color and secondary-color color commands in the WebVPN context. The default color is purple.

The value can be the name of the color that is recognized in HTML (no spaces between words or characters) or a comma-separated red, green, blue (RGB) value. The value is limited to 32 characters.


Note All browsers support the RGB value; however, not all browsers support the color name. If you enter a color name and do not get the expected results, use the RGB value for the color.


Table 2-8 Color Names and RGB Values 

Color Name
R
G
B

AliceBlue

240

248

255

AntiqueWhite

250

235

215

AntiqueWhite1

255

239

219

AntiqueWhite2

238

223

204

AntiqueWhite3

205

192

176

AntiqueWhite4

139

131

120

Aquamarine

127

255

212

Aquamarine1

127

255

212

Aquamarine2

118

238

198

Aquamarine3

102

205

170

Aquamarine4

69

139

116

Azure

240

255

255

Azure1

240

255

255

Azure2

224

238

238

Azure3

193

205

205

Azure4

131

139

139

Beige

245

245

220

Bisque

255

228

196

Bisque1

255

228

196

Bisque2

238

213

183

Bisque3

205

183

158

Bisque4

139

125

107

Black

0

0

0

BlanchedAlmond

255

235

205

Blue

0

0

255

Blue1

0

0

255

Blue2

0

0

238

Blue3

0

0

205

Blue4

0

0

139

BlueViolet

138

43

226

Brown

165

42

42

Brown1

255

64

64

Brown2

238

59

59

Brown3

205

51

51

Brown4

139

35

35

Burlywood

222

184

135

Burlywood1

255

211

155

Burlywood2

238

197

145

Burlywood3

205

170

125

Burlywood4

139

115

85

CadetBlue

95

158

160

CadetBlue1

152

245

255

CadetBlue2

142

229

238

CadetBlue3

122

197

205

CadetBlue4

83

134

139

Chartreuse

127

255

0

Chartreuse1

127

255

0

Chartreuse2

118

238

0

Chartreuse3

102

205

0

Chartreuse4

69

139

0

Chocolate

210

105

30

Chocolate1

255

127

36

Chocolate2

238

118

33

Chocolate3

205

102

29

Chocolate4

139

69

19

Coral

255

127

80

Coral1

255

114

86

Coral2

238

106

80

Coral3

205

91

69

Coral4

139

62

47

CornflowerBlue

100

149

237

Cornsilk

255

248

220

Cornsilk1

255

248

220

Cornsilk2

238

232

205

Cornsilk3

205

200

177

Cornsilk4

139

136

120

Cyan

0

255

255

Cyan1

0

255

255

Cyan2

0

238

238

Cyan3

0

205

205

Cyan4

0

139

139

DarkBlue

0

0

139

DarkCyan

0

139

139

DarkGoldenrod

184

134

11

DarkGoldenrod1

255

185

15

DarkGoldenrod2

238

173

14

DarkGoldenrod3

205

149

12

DarkGoldenrod4

139

101

8

DarkGray

169

169

169

DarkGreen

0

100

0

DarkKhaki

189

183

107

DarkMagenta

139

0

139

DarkOliveGreen

85

107

47

DarkOliveGreen1

202

255

112

DarkOliveGreen2

188

238

104

DarkOliveGreen3

162

205

90

DarkOliveGreen4

110

139

61

DarkOrange

255

140

0

DarkOrange1

255

127

0

DarkOrange2

238

118

0

DarkOrange3

205

102

0

DarkOrange4

139

69

0

DarkOrchid

153

50

204

DarkOrchid1

191

62

255

DarkOrchid2

178

58

238

DarkOrchid3

154

50

205

DarkOrchid4

104

34

139

DarkRed

139

0

0

DarkSalmon

233

150

122

DarkSeaGreen

143

188

143

DarkSeaGreen1

193

255

193

DarkSeaGreen2

180

238

180

DarkSeaGreen3

155

205

155

DarkSeaGreen4

105

139

105

DarkSlateBlue

72

61

139

DarkSlateGray

47

79

79

DarkSlateGray1

151

255

255

DarkSlateGray2

141

238

238

DarkSlateGray3

121

205

205

DarkSlateGray4

82

139

139

DarkTurquoise

0

206

209

DarkViolet

148

0

211

DeepPink

255

20

147

DeepPink1

255

20

147

DeepPink2

238

18

137

DeepPink3

205

16

118

DeepPink4

139

10

80

DeepSkyBlue

0

191

255

DeepSkyBlue1

0

191

255

DeepSkyBlue2

0

178

238

DeepSkyBlue3

0

154

205

DeepSkyBlue4

0

104

139

DimGrey

105

105

105

DodgerBlue

30

144

255

DodgerBlue1

30

144

255

DodgerBlue2

28

134

238

DodgerBlue3

24

116

205

DodgerBlue4

16

78

139

Firebrick

178

34

34

Firebrick1

255

48

48

Firebrick2

238

44

44

Firebrick3

205

38

38

Firebrick4

139

26

26

FloralWhite

255

250

240

ForestGreen

34

139

34

Gainsboro

220

220

220

GhostWhite

248

248

255

Gold

255

215

0

Gold1

255

215

0

Gold2

238

201

0

Gold3

205

173

0

Gold4

139

117

0

Goldenrod

218

165

32

Goldenrod1

255

193

37

Goldenrod2

238

180

34

Goldenrod3

205

155

29

Goldenrod4

139

105

20

Gray0

0

0

0

Gray1

3

3

3

Gray10

26

26

26

Gray100

255

255

255

Gray11

28

28

28

Gray12

31

31

31

Gray13

33

33

33

Gray14

36

36

36

Gray15

38

38

38

Gray16

41

41

41

Gray17

43

43

43

Gray18

46

46

46

Gray19

48

48

48

Gray2

5

5

5

Gray20

51

51

51

Gray21

54

54

54

Gray22

56

56

56

Gray23

59

59

59

Gray24

61

61

61

Gray25

64

64

64

Gray26

66

66

66

Gray27

69

69

69

Gray28

71

71

71

Gray29

74

74

74

Gray3

8

8

8

Gray30

77

77

77

Gray31

79

79

79

Gray32

82

82

82

Gray33

84

84

84

Gray34

87

87

87

Gray35

89

89

89

Gray36

92

92

92

Gray37

94

94

94

Gray38

97

97

97

Gray39

99

99

99

Gray4

10

10

10

Gray40

102

102

102

Gray41

105

105

105

Gray42

107

107

107

Gray43

110

110

110

Gray44

112

112

112

Gray45

115

115

115

Gray46

117

117

117

Gray47

120

120

120

Gray48

122

122

122

Gray49

125

125

125

Gray5

13

13

13

Gray50

127

127

127

Gray51

130

130

130

Gray52

133

133

133

Gray53

135

135

135

Gray54

138

138

138

Gray55

140

140

140

Gray56

143

143

143

Gray57

145

145

145

Gray58

148

148

148

Gray59

150

150

150

Gray6

15

15

15

Gray60

153

153

153

Gray61

156

156

156

Gray62

158

158

158

Gray63

161

161

161

Gray64

163

163

163

Gray65

166

166

166

Gray66

168

168

168

Gray67

171

171

171

Gray68

173

173

173

Gray69

176

176

176

Gray7

18

18

18

Gray70

179

179

179

Gray71

181

181

181

Gray72

184

184

184

Gray73

186

186

186

Gray74

189

189

189

Gray75

191

191

191

Gray76

194

194

194

Gray77

196

196

196

Gray78

199

199

199

Gray79

201

201

201

Gray8

20

20

20

Gray80

204

204

204

Gray81

207

207

207

Gray82

209

209

209

Gray83

212

212

212

Gray84

214

214

214

Gray85

217

217

217

Gray86

219

219

219

Gray87

222

222

222

Gray88

224

224

224

Gray89

227

227

227

Gray9

23

23

23

Gray90

229

229

229

Gray91

232

232

232

Gray92

235

235

235

Gray93

237

237

237

Gray94

240

240

240

Gray95

242

242

242

Gray96

245

245

245

Gray97

247

247

247

Gray98

250

250

250

Gray99

252

252

252

Green

0

255

0

Green1

0

255

0

Green2

0

238

0

Green3

0

205

0

Green4

0

139

0

GreenYellow

173

255

47

Grey

190

190

190

Grey0

0

0

0

Grey1

3

3

3

Grey10

26

26

26

Grey100

255

255

255

Grey11

28

28

28

Grey12

31

31

31

Grey13

33

33

33

Grey14

36

36

36

Grey15

38

38

38

Grey16

41

41

41

Grey17

43

43

43

Grey18

46

46

46

Grey19

48

48

48

Grey2

5

5

5

Grey20

51

51

51

Grey21

54

54

54

Grey22

56

56

56

Grey23

59

59

59

Grey24

61

61

61

Grey25

64

64

64

Grey26

66

66

66

Grey27

69

69

69

Grey28

71

71

71

Grey29

74

74

74

Grey3

8

8

8

Grey30

77

77

77

Grey31

79

79

79

Grey32

82

82

82

Grey33

84

84

84

Grey34

87

87

87

Grey35

89

89

89

Grey36

92

92

92

Grey37

94

94

94

Grey38

97

97

97

Grey39

99

99

99

Grey4

10

10

10

Grey40

102

102

102

Grey41

105

105

105

Grey42

107

107

107

Grey43

110

110

110

Grey44

112

112

112

Grey45

115

115

115

Grey46

117

117

117

Grey47

120

120

120

Grey48

122

122

122

Grey49

125

125

125

Grey5

13

13

13

Grey50

127

127

127

Grey51

130

130

130

Grey52

133

133

133

Grey53

135

135

135

Grey54

138

138

138

Grey55

140

140

140

Grey56

143

143

143

Grey57

145

145

145

Grey58

148

148

148

Grey59

150

150

150

Grey6

15

15

15

Grey60

153

153

153

Grey61

156

156

156

Grey62

158

158

158

Grey63

161

161

161

Grey64

163

163

163

Grey65

166

166

166

Grey66

168

168

168

Grey67

171

171

171

Grey68

173

173

173

Grey69

176

176

176

Grey7

18

18

18

Grey70

179

179

179

Grey71

181

181

181

Grey72

184

184

184

Grey73

186

186

186

Grey74

189

189

189

Grey75

191

191

191

Grey76

194

194

194

Grey77

196

196

196

Grey78

199

199

199

Grey79

201

201

201

Grey8

20

20

20

Grey80

204

204

204

Grey81

207

207

207

Grey82

209

209

209

Grey83

212

212

212

Grey84

214

214

214

Grey85

217

217

217

Grey86

219

219

219

Grey87

222

222

222

Grey88

224

224

224

Grey89

227

227

227

Grey9

23

23

23

Grey90

229

229

229

Grey91

232

232

232

Grey92

235

235

235

Grey93

237

237

237

Grey94

240

240

240

Grey95

242

242

242

Grey96

245

245

245

Grey97

247

247

247

Grey98

250

250

250

Grey99

252

252

252

Honeydew

240

255

240

Honeydew1

240

255

240

Honeydew2

224

238

224

Honeydew3

193

205

193

Honeydew4

131

139

131

HotPink

255

105

180

HotPink1

255

110

180

HotPink2

238

106

167

HotPink3

205

96

144

HotPink4

139

58

98

IndianRed

205

92

92

IndianRed1

255

106

106

IndianRed2

238

99

99

IndianRed3

205

85

85

IndianRed4

139

58

58

Ivory

255

255

240

Ivory1

255

255

240

Ivory2

238

238

224

Ivory3

205

205

193

Ivory4

139

139

131

Khaki

240

230

140

Khaki1

255

246

143

Khaki2

238

230

133

Khaki3

205

198

115

Khaki4

139

134

78

Lavender

230

230

250

LavenderBlush

255

240

245

LavenderBlush1

255

240

245

LavenderBlush2

238

224

229

LavenderBlush3

205

193

197

LavenderBlush4

139

131

134

LawnGreen

124

252

0

LemonChiffon

255

250

205

LemonChiffon1

255

250

205

LemonChiffon2

238

233

191

LemonChiffon3

205

201

165

LemonChiffon4

139

137

112

LightBlue

173

216

230

LightBlue1

191

239

255

LightBlue2

178

223

238

LightBlue3

154

192

205

LightBlue4

104

131

139

LightCoral

240

128

128

LightCyan

224

255

255

LightCyan1

224

255

255

LightCyan2

209

238

238

LightCyan3

180

205

205

LightCyan4

122