key

Function

The key command configures the key used by the HSB devices.

The undo key command deletes the key used by the HSB devices.

By default, the key used by HSB devices is not configured.

Format

key cipher key-string

undo key

Parameters

Parameter	Description	Value
cipher key-string	Indicates the key used by the HSB devices.	The value can be a string of 48 characters in cipher text or a string of 8 to 16 characters in plain text.

Views

HSB service view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To ensure security of HSB information negotiation and service backup and prevent the attacks initiated by using bogus packets or modifying packets, run the key command to configure the key used by HSB devices. The key provides authentication and verification mechanisms.

Precautions

Configuring a shared key for HSB devices is not recommended in a secure network environment, as this configuration will degrade the HSB performance.
The key command must be configured before the service-ip-port command. Otherwise, the key configuration will fail.
The two HSB devices must be configured with the same shared key. Inconsistent keys on two ends will cause frequent interruption of the HSB channel.

Example

# Set the key used by HSB devices to Huawei@123.

<HUAWEI> system-view
[HUAWEI] hsb-service 0
[HUAWEI-hsb-service-0] key cipher Huawei@123