09-安全命令参考

17-加密引擎命令

1 加密引擎

1.1 加密引擎配置命令

1.1.1 crypto-engine accelerator disable

1.1.2 display crypto-engine

1.1.3 display crypto-engine statistics

1.1.4 reset crypto-engine statistics

1 加密引擎

1.1 加密引擎配置命令

1.1.1 crypto-engine accelerator disable

crypto-engine accelerator disable命令用来关闭硬件加密引擎。

undo crypto-engine accelerator disable命令用来开启硬件加密引擎。

【命令】

crypto-engine accelerator disable

undo crypto-engine accelerator disable

加密引擎包括硬件加密引擎和软件加密引擎两种类型。硬件加密引擎可以是集成在CPU上的协处理器或者硬件加密卡；软件加密引擎指设备上的软件加密算法。

开启硬件加密引擎加密功能，是指开启硬件加密引擎来加速加密过程。

当硬件加密引擎加密功能处于开启状态时，设备会优先选择使用硬件加密引擎对数据进行加密处理，如果硬件加密引擎不支持某种加密算法，则设备会使用软件加密引擎进行加密处理；如果硬件加密引擎加密功能关闭，则设备只能使用软件加密引擎进行加密处理。

硬件加密引擎的开启或关闭状态的改变对业务模块的影响由业务模块决定，例如，对于IPsec业务来说，硬件加密引擎状态的改变只对新建立的IPsec SA有影响，已建的IPsec SA仍旧使用之前选择的加密引擎来处理。因此，建议在开启或关闭硬件加密引擎之后，使用reset ipsec sa命令将当前已有的IPsec SA删除，使得所有新建立的IPsec SA都将使用新选择的加密引擎处理流程来处理。

硬件加密引擎加密功能仅允许在测试、调试或故障排除的环境下关闭，正常情况下不建议关闭该功能。

【举例】

# 关闭硬件加密引擎。

<Sysname> system-view

[Sysname] crypto-engine accelerator disable

1.1.2 display crypto-engine

display crypto-engine命令用来显示加密引擎的基本信息，包括各个加密引擎的名称、支持的算法能力等信息。

【命令】

display crypto-engine

若设备没有硬件加密引擎，则只会显示软件加密引擎信息。

【举例】

# 显示加密引擎的基本信息。

<Sysname> display crypto-engine

Crypto engine name: cavium crypto driver

Crypto engine state: Enabled

Crypto engine type: Hardware

Slot ID: 0

CPU ID：0

Crypto engine ID: 0

Symmetric algorithms: des-ecb 3des-cbc 3des-ecb aes-cbc aes-ecb aes-ctr camellia_cbc sha1 sha2-256 sha2-384 sha2-512 md5-hmac sha1hmac sha2-256-hmac sha2-384-hmac sha2-512-hmac

Asymmetric algorithms: dh-group1 dh-group2 dh-group5 dh-group14 dh-group24

Random number generation function: Supported

Crypto engine name: Software crypto engine

Crypto engine state: Enabled

Crypto engine type: Software

Slot ID: 0

CPU ID：0

Crypto engine ID: 1

Symmetric algorithms: des-cbc des-ecb 3des-ecb aes-ecb sha1 sha2-256 sha1-hmac sha2-256-hmac

Asymmetric algorithms:

Random number generation function: Supported

# 显示加密引擎的基本信息。（设备上无硬件加密引擎的情况）

<Sysname> display crypto-engine

Crypto engine name: Software crypto engine

Crypto engine state: Enabled

Crypto engine type: Software

Slot ID: 0

CPU ID：0

Crypto engine ID: 0

Symmetric algorithms: des-cbc des-ecb 3des-ecb aes-ecb sha1 sha2-256 sha1-hmac sha2-256-hmac

Asymmetric algorithms:

Random number generation function: Supported

表1-1 display crypto-engine命令显示信息描述表

字段	描述
Crypto engine name	加密引擎名称
Crypto engine state	加密引擎的状态，对于不同类型的加密引擎状态不同对于硬件加密引擎，包括以下两种： · Enabled：已开启 · Disable：关闭对于软件加密引擎，只包含以下一种： · Enabled：已开启
Crypto engine type	加密引擎的类型，包括以下两种： · Hardware：硬件 · Software：软件
Slot ID	加密引擎所在的接口板编号
CPU ID	单板上的CPU编号
Crypto engine ID	加密引擎ID号
Symmetric algorithms	支持的对称加密算法
Asymmetric algorithms	支持的非对称加密算法
Random number generation function	是否支持获取随机数的功能 · Supported：支持 · Not supported：不支持

【相关命令】

· crypto-engine accelerator disable

1.1.3 display crypto-engine statistics

display crypto-engine statistics命令用来显示加密引擎的统计信息，包括建立会话的个数，加密引擎处理的报文数等信息。

【命令】

display crypto-engine statistics [ engine-id engine-id ]

engine-id engine-id：显示指定加密引擎的统计信息，engine-id为加密引擎ID编号，取值范围。

【使用指导】

如果未开启硬件加密引擎或者设备上没有硬件加密引擎，则只会显示软件加密引擎的统计信息。若不指定任何参数，则显示所有加密引擎统计信息。

【举例】

# 显示所有加密引擎统计信息。

<Sysname> display crypto-engine statistics

Submitted sessions: 0

Failed sessions: 0

Symmetric operations: 0

Symmetric errors: 0

Asymmetric operations: 0

Asymmetric errors: 0

Get-random operations: 0

Get-random errors: 0

表1-2 display crypto-engine statistics命令显示信息描述表

字段	描述
Submitted sessions	已创建的会话数目
Failed sessions	创建失败的会话数目
Symmetric operations	加密引擎使用对称算法的操作次数
Symmetric errors	加密引擎使用对称算法操作失败的次数
Asymmetric operations	加密引擎使用非对称算法操作的次数
Asymmetric errors	加密引擎使用非对称算法操作失败的次数
Get-random operations	加密引擎获取随机数操作的次数
Get-random errors	加密引擎获取随机数操作失败的次数