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 module—Clears crypto statistics for the specified module type.
•
fdu—Clears FDU statistics information.
•
ipc—Clears IPC statistics information.
•
ipc module module—Clears IPC statistics for the specified module type.
•
module module—Clears 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 module—Clears 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
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
Usage:General Purpose Key
Address or name of remote host []? 7.0.0.7
Destination username [ssl-proxy]? lab
Destination filename [test-keys.pub]?
Writing test-keys.pub Writing file to scp://lab@7.0.0.7/test-keys.pub
Address or name of remote host []? 7.0.0.7
Destination username [ssl-proxy]? lab
Destination filename [test-keys.prv]?
Writing test-keys.prv Writing file to scp://lab@7.0.0.7/test-keys.prv
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
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
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
Sending file modes:C0644 963 test-keys.prv
Reading file from scp://lab@7.0.0.7/test-keys.prv!% Key pair import succeeded.
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.
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
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
Writing TP1.p12 Writing pkcs12 file to scp://admin-1@10.1.1.1/TP1.p12
CRYPTO_PKI:Exported PKCS12 file successfully.
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): !
% 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): !
% 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): !
% PEM files import succeeded.
*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
Sending file modes:C0644 4379 TP2.p12
*Aug 22 12:30:00.531:%CRYPTO-6-PKCS12IMPORT_SUCCESS:PKCS #12 Successfully Imported.
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:
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 url—A 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;
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
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
This example shows how to turn on App debugging:
webvpn# debug webvpn platform app
This example shows how to turn on FDU debugging:
webvpn# debug webvpn platform fdu
This example shows how to turn on IPC debugging:
webvpn# debug webvpn platform ipc
This example shows how to turn on PKI debugging:
webvpn# debug webvpn platform pki
This example shows how to turn on SSL debugging:
ssl-proxy# debug webvpn platform ssl
This example shows how to turn on TCP debugging:
ssl-proxy# debug webvpn platform tcp
This example shows how to turn off TCP debugging:
ssl-proxy# no debug webvpn platform tcp
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
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
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-acl—IP 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 remoteserver—Specifies the DNS name or IP address to connect to on the remote server.
• remote-port remoteport—Specifies the port to connect to on the remote server. Valid values are from 1 to 65535.
• description description—Specifies 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
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
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:
--------------------------------
Core-ID Symbolic-ID Connections
------- ----------- -----------
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
Member-Index Core-ID Symbolic-ID Weight Quota
------------ ------- ----------- ------ -----
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
------------ ----- ---------
This example shows how to display information for a specific gateway:
webvpn# show webvpn gateway s1
IP: 10.1.2.140, port: 443
TCP Policy not configured
SSL Policy not configured
Certificate chain for new connections:
Key Label: tp1, 1024-bit, not exportable
Key Timestamp: 12:09:27 UTC Dec 25 2004
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:
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
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:
Tue 04/08/2005 15:31:20.43
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
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
NetBIOS name IP Address Timestamp
NetBIOS name IP Address Timestamp
NetBIOS name IP Address Timestamp
NetBIOS name IP Address Timestamp
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
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
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
This example shows how to display all module status information about the specified context:
webvpn# show webvpn platform context tunnel module all
Service ID : 8 Protocol : 0
Virtual IP : 0.0.0.0 Virtual port : 0
Hash Index : 0 Conn Count : 0
Bound ID : 0 State : DOWN
IP address : 116.117.110.110 Port : 0
FIN wait timeout (s) : 75
Reassembly timeout (s) : 60
Connection Rx Buffer Size : 32768
Connection Tx Buffer Size : 65536
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
Handshake 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] ----------------------
++++++++++ CORE 0 (VPN (slave)) ++++++++++++++++++++++++
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
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)) ++++++++++++++++++++++++
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
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] ----------------------
++++++++++ CORE 0 (TCP/FDU Processor #1) ++++++++++++++++++++++++
APPLICATION VERSION: 2005.03.15 22:14:57 built for mahesh
APPROXIMATE TIME WHEN CRASH HAPPENED: 11:28:14 UTC Aug 1 2005
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) ++++++++++++++++++++++++
APPLICATION VERSION: 2005.03.15 22:14:57 built for mahesh
APPROXIMATE TIME WHEN CRASH HAPPENED: 11:28:14 UTC Aug 1 2005
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
rsa-general-purpose certificate trustpoint: mytp
Certificate chain for new connections:
Key Label: mytp, 1024-bit, not exportable
Key Timestamp: 12:09:27 UTC Dec 25 2004
Certificate chain complete
This example shows how to display debug information for a specific gateway:
webvpn# show webvpn platform gateway s1 debug
rsa-general-purpose certificate trustpoint: mytp
Certificate chain for new connections:
Key Label: mytp, 1024-bit, not exportable
Key Timestamp: 12:09:27 UTC Dec 25 2004
Certificate chain complete
Service ID: 1 Bound ID: -1
Virtual IP: 10.1.2.14 Port : 443
VLAN ID : 0 MAC Address : 0000.0000.0000
This example shows how to display status information for all CPUs for a specific gateway:
webvpn# show web platform gateway s1 module all
Service ID : 1 Protocol : 6
Virtual IP : 64.102.223.140 Virtual port : 443
Hash Index : 896 Conn Count : 0
IP address : 10.1.2.14 Port : 443
FIN wait timeout (s) : 75
Reassembly timeout (s) : 60
Connection Rx Buffer Size : 32768
Connection Tx Buffer Size : 65536
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
Handshake timeout: 0 secs
Session cache size: 262144
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
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
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"
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 ----
My Net Mask : 255.255.255.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
session timeout = 43200 sec
address pool name = "addr"
dpd client timeout = 300 sec
dpd gateway timeout = 300 sec
keep sslvpn client installed = disabled
rekey interval = 3600 sec
lease duration = 43200 sec
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
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
Created 04:50:21, Last-used 00:00:31
Client Port: 2503, Server IP Addr: 10.102.31.9, Server Port: 80
url list name = "Cisco test URL list"
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
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
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
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
TCP VC's : 0 UDP VC's : 0
Active VC's : 0 Active Contexts : 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
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
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
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
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
in bytes : 0 out bytes : 0
out bytes : 0 in bytes : 0
Peak connections : 1 Peak time : 5d16h
Connect succeed : 6 Connect failed : 0
Reconnect succeed : 1 Reconnect failed : 0
in CSTP frames : 23098 out IP pkts : 23093
in CSTP bytes : 4956832 out IP bytes : 4771852
out CSTP frames : 32086 in IP pkts : 32084
out CSTP bytes : 16136526 in IP bytes : 16512477
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
TCP VC's : 0 UDP VC's : 0
Active VC's : 0 Active Contexts : 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
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
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
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
This example shows how to display the statistics for a specific context:
webvpn# show web stats context tunnel
WebVPN context name : tunnel
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
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
TCP VC's : 0 UDP VC's : 0
Active VC's : 0 Active Contexts : 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
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
in bytes : 0 out bytes : 0
out bytes : 0 in bytes : 0
Peak connections : 1 Peak time : 5d16h
Connect succeed : 6 Connect failed : 0
Reconnect succeed : 1 Reconnect failed : 0
in CSTP frames : 23098 out IP pkts : 23093
in CSTP bytes : 4956832 out IP bytes : 4771852
out CSTP frames : 32086 in IP pkts : 32084
out CSTP bytes : 16136526 in IP bytes : 16512477
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
This example shows how to enable traps:
wwbvpn(config)# snmp-server enable traps
This example shows how to enable authentication traps:
wwbvpn(config)# snmp-server enable traps snmp authnetication
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 timeout—Specifies 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 listname—Specifies 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
|
|