WSG Service Configuration Mode Commands

The Wireless Security Gateway Configuration Mode is used to define the operating parameters for IPSec-based access control and handling of Encapsulating Security Payload (ESP) packets.


Mode:

Exec > Global Configuration > Context Configuration > WSG-Service Configuration

configure > context context_name > wsg-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-wsg-service)#

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

IMPORTANT:

Any changes made to a WSG service require that the service be restarted to apply any changed parameters. You restart the service by unbinding and binding the IP address to the service context.

bind address

Binds the WSG service to the specified IPv4 or IPv6 address and crypto template (VPC only).

Product:

SecGW (WSG)


Privilege:

Security Administrator


Mode:

Exec > Global Configuration > Context Configuration > WSG-Service Configuration

configure > context context_name > wsg-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-wsg-service)#

Syntax
bind address ip_address crypto-template template_name
no bind address
no

Unbinds the WSG service from the IP address.

ip_address

Specifies the bind-to IP address in IPv4 dotted-decimal or IPv6 colon-separated hexadecimal notation.

template_name

Specifies the name of an existing crypto template as an alphanumeric string of 0 through 127 characters.


Usage:

Bind the WSG service to an IPv4 or IPv6 address.


Example:
The following command binds the WSG service to 10.1.1.1.
bind address 10.1.1.1
crypto template tplt01
deployment-mode

Specifies the deployment mode for the WSG service (VPC only).

Product:

SecGW (WSG)


Privilege:

Security Administrator


Mode:

Exec > Global Configuration > Context Configuration > WSG-Service Configuration

configure > context context_name > wsg-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-wsg-service)#

Syntax
deployment-mode { remote-access | site-to-site }
no deployment-mode
no

Deletes deployment mode from the configuration.

{ remote-access | site-to-site }
Specifies the deployment mode as either:
  • remote-access – support direct user communication with this WSG
  • site-to-site – support bidirectional communication with two or more WSGs

Usage:

Specify remote access or site-to-site communication as the deployment mode for this WSG.


Example:
This command deploys this WSG for remote access:
deployment-mode
remote-access
end

Exits the current configuration mode and returns to the Exec mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
end

Usage:

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
exit

Usage:

Use this command to return to the parent configuration mode.

ip

Specifies the IPv4 access group and address allocation method for this WSG service (VPC only).

Product:

SecGW (WSG)


Privilege:

Security Administrator


Mode:

Exec > Global Configuration > Context Configuration > WSG-Service Configuration

configure > context context_name > wsg-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-wsg-service)#

Syntax
ip { access-group group_name | address { alloc-method { dhcp-proxy | local } | pool
name pool_name }
no ip access-group group_name
no ip address alloc-method pool_name
no ip address pool name pool_name
no

Deletes the specified parameter.

access-group group_name

Specifies an existing IPv4 ACL access group as an alphanumeric string of 1 through 47 characters. For additional information, see ACL Configuration Mode Commands.

address alloc-method { dhcp-proxy | local }
Specifies the method to be used when allocating IPv4 addresses:
  • dhcp-proxy – allocates via a DHCP server
  • local – allocates from a local pool (default)
pool name pool_name

Specifies an existing IPv4 access pool as an alphanumeric string of 1 through 31 characters. Up to 16 named IPv4 pools can be configured. For additional information, see APN Configuration Mode Commands.


Usage:

Use this command to specify the IPv4 access group and IPv4 address allocation method for this WSG service.

This command and its keywords are subject to the following limitations:
  • The WSG service configuration takes precedence over the equivalent configuration in Subscriber mode or the template payload.
  • The WSG service must be restarted to apply the parameters. You restart the service by doing an unbind and bind.
  • Up to 16 named IPv4 pools can be configured. The list is sorted, and the addresses are allocated from the first pool in the list with available addresses.
  • One IPv4 ACL can be configured.
  • The IPv4 pools will only be used for IPv4 calls.

Example:
This command specifies the IPv4 address pool named pool401:
ip address pool name pool401
This command specifies the use of a previously configure DHCPv4 service to allocate IPv4 addresses:
ip address alloc-method
dhcp-proxy
ipv6

Specifies the IPv6 access group and prefix pool for this WSG service (VPC only).

Product:

SecGW (WSG)


Privilege:

Security Administrator


Mode:

Exec > Global Configuration > Context Configuration > WSG-Service Configuration

configure > context context_name > wsg-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-wsg-service)#

Syntax
ipv6 { access-group group_name | address prefix-pool pool_name }
no ipv6 access-group group_name
no ipv6 address prefix-pool
no

Deletes the specified parameter.

access-group group_name

Specifies an existing IPv6 ACL access group as an alphanumeric string of 1 through 47 characters. For additional information, see IPv6 ACL Configuration Mode Commands.

address prefix-pool pool_name

Specifies an existing IPv6 prefix pool as an alphanumeric string of 1 through 31 characters. For additional information, see Subscriber Configuration Mode Commands.


Usage:

Specify the IPv6 access group and prefix pool for this WSG service.

This command and its keywords are subject to the following limitations:
  • The WSG service configuration takes precedence over the equivalent configuration in Subscriber mode or the template payload.
  • The WSG service must be restarted to apply the parameters. You restart the service by doing an unbind and bind.
  • One named IPv6 pool can be configured.
  • One named IPv6 ACL can be configured.
  • The IPv6 pools will only be used for IPv6 calls.

Example:
This command specifies the IPv6 prefix pool named pool601:
ipv6 prefix-pool
name pool601
pre_fragment mtu

Specifies the Maximum Transmission Unit (MTU) size which when exceeded initiates pre-tunnel (before encryption) fragmentation of IPSec Encapsulated Security Payload (ESP) packets within this WSG service (VPC only).

Product:

SecGW (WSG)


Privilege:

Security Administrator


Mode:

Exec > Global Configuration > Context Configuration > WSG-Service Configuration

configure > context context_name > wsg-service service_name

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-wsg-service)#

Syntax
pre_fragment
mtu size
no pre_fragment size
default pre_fragment size
no

Disables this function.

default

Sets the MTU size to the default value of 1400 bytes.

mtu size

Specifies the MTU size in bytes as an integer from 576 through 2048. Default = 1400


Usage:

Specify the MTU size which when exceeded initiates pre-tunnel fragmentation of IPSec ESP packets within this WSG service.

Pre-Tunnel-Fragmentation improves packet processing performance as compared to post-tunnel-fragmentation.

If a clear IPv4 packet is longer than the predefined MTU size, it will be fragmented before the packet is encrypted and transmitted to internet.

If a clear IPv6 packet is longer than the predefined MTU size, it is dropped and an ICMP packet with the maximum length is sent back to the source. The source will then fragment the IPv6 packet and retransmit.


Example:
The following command sets MTU size to 2048 bytes.
pre_fragment
mtu 2048