IPsec commands

ipsec

Syntax

ipsec

Context

config

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

Commands in this context configure Internet Protocol security (IPsec) parameters. IPsec is a structure of open standards that uses cryptographic security services to ensure private, secure communications over IP networks.

static-sa

Syntax

static-sa sa-name [create]

no static-sa

Context

config>ipsec

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command configures an IPsec static security association (SA).

The no form of this command removes the configuration.

Parameters

sa-name

Specifies the SA name, up to 32 characters.

create

Mandatory keyword to create an SA instance.

authentication

Syntax

authentication auth-algorithm ascii-key ascii-string

authentication auth-algorithm hex-key hex-string [hash | hash2]

no authentication

Context

config>ipsec>static-sa

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command configures the authentication algorithm to use for an IPsec manual SA.

The no form of this command removes the configuration.

Default

no authentication

Parameters

auth-algorithm

Specifies the authentication algorithm.

Values

sha1 — The authentication protocol can be either HMAC-MD5-96 or HMAC-SHA-96.

md5 — The authentication protocol can either be HMAC-MD5-96 or HMAC-SHA-96.

ascii-string

Specifies the ASCII key, up to 16 characters for md5 and 20 characters for sha1.

The authentication key is stored an encrypted format. The minimum key length is configured using the config>system>security>password>minimum-length command.

The complexity of the key is configured using the commands in the config>system>security>password>complexity-rules context.

hex-string

Specifies the hexadecimal key, up to 32 hexadecimal nibbles for md5 and up to 40 hexadecimal nibbles for sha1.

hash

Keyword that stores all specified keys in encrypted format in the configuration file. The password must be entered in encrypted form when this keyword is configured. If this keyword is not configured, the key is assumed to be in a non-encrypted form.

hash2

Keyword to store the key in a more complex encrypted form. If this keyword is not used, the less encrypted hash form is assumed.

description

Syntax

description description-string

no description

Context

config>ipsec>static-sa

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command creates a text description, which is stored in the configuration file, to help identify the content of the entity.

The no form of this command removes the string from the configuration.

Parameters

description-string

Specifies the description character string. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. It the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed in double quotes.

direction

Syntax

direction ipsec-direction

no direction

Context

config>ipsec>static-sa

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command configures the direction for an IPsec manual SA.

The no form of this command reverts to the default value.

Default

direction bidirectional

Parameters

ipsec-direction

Specifies the direction.

Values

inbound, outbound, bidirectional

protocol

Syntax

protocol ipsec-protocol

no protocol

Context

config>ipsec>static-sa

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command configures the security protocol to use for an IPsec manual SA.

The no form of this command reverts to the default value.

Default

protocol esp

Parameters

ipsec-protocol

Specifies the security protocol.

Values

ah — Configures to Authentication Header Protocol.

esp — Configures the Encapsulation Security Payload Protocol.

spi

Syntax

spi spi

no spi

Context

config>ipsec>static-sa

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command configures the security parameter index (SPI) key value for an IPsec manual SA.

The no form of this command removes the configured SPI key value.

Parameters

spi

Specifies the SPI value.

Values

256 to 16383