Public key configuration commands 1

display public-key local rsa public· 1

display public-key peer 2

peer-public-key end· 3

public-key-code begin· 4

public-key-code end· 4

public-key local create rsa· 5

public-key local destroy rsa· 6

public-key local export rsa· 6

public-key peer 7

public-key peer import sshkey· 8

 

display public-key local rsa public

Syntax

display public-key local rsa public [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

rsa: Specifies an RSA key pair.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display public-key local public to display the public key information of the local key pairs.

Related commands: public-key local create rsa.

Examples

# Display the public key information of the local RSA key pairs.

<Sysname> display public-key local rsa public

 

=====================================================

Time of Key pair created: 19:59:16  2007/10/25

Key name: HOST_KEY

Key type: RSA Encryption Key

=====================================================

Key code:

30819F300D06092A864886F70D010101050003818D0030818902818100BC4C392A97734A633BA0F1DB01F
84EB51228EC86ADE1DBA597E0D9066FDC4F04776CEA3610D2578341F5D049143656F1287502C06D39D39F
28F0F5CBA630DA8CD1C16ECE8A7A65282F2407E8757E7937DCCDB5DB620CD1F471401B711713970234844
4A2D8900497A87B8D5F13D61C4DEFA3D14A7DC07624791FC1D226F62DF30203010001

 

=====================================================

Time of Key pair created: 19:59:17  2007/10/25

Key name: SERVER_KEY

Key type: RSA Encryption Key

=====================================================

Key code:

307C300D06092A864886F70D0101010500036B003068026100C51AF7CA926962284A4654B2AACC7B2AE12
B2B1EABFAC1CDA97E42C3C10D7A70D1012BF23ADE5AC4E7AAB132CFB6453B27E054BFAA0A85E113FBDE75
1EE0ECEF659529E857CF8C211E2A03FD8F10C5BEC162B2989ABB5D299D1E4E27A13C7DD10203010001

Table 1 Command output

Field	Description
Time of Key pair created	Time at which the local key pair is created.
Key name	Key name, which can be one of the following values: ·     HOST_KEY—Host public key. ·     SERVER_KEY—Server public key. This value is available only for RSA key pairs.
Key type	RSA Encryption Key: RSA key pair.
Key code	Key data.

 

display public-key peer

Syntax

display public-key peer [ brief | name publickey-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

brief: Displays brief information about all peer public keys.

name publickey-name: Displays information about a peer public key. publickey-name represents a public key by its name, a case-sensitive string of 1 to 64 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display public-key peer to display information about the specified or all locally saved peer public keys.

With neither the brief keyword nor the name publickey-name option specified, the command displays detailed information about all locally saved peer public keys.

You can use the public-key peer command or the public-key peer import sshkey command to get a local copy of a peer public key.

Related commands: public-key peer and public-key peer import sshkey.

Examples

# Display detailed information about the peer public key named idrsa.

<Sysname> display public-key peer name idrsa

=====================================

  Key Name  : idrsa

  Key Type  : RSA

  Key Module: 1024

=====================================

Key Code:

30819D300D06092A864886F70D010101050003818B00308187028181009C46A8710216CEC0C01C7CE136B
A76C79AA6040E79F9E305E453998C7ADE8276069410803D5974F708496947AB39B3F39C5CE56C95B6AB74
42D56393BF241F99A639DD02D9E29B1F5C1FD05CC1C44FBD6CFFB58BE6F035FAA2C596B27D1231D159846
B7CB9A7757C5800FADA9FD72F65672F4A549EE99F63095E11BD37789955020123

# Display brief information about all locally saved peer public keys.

<Sysname> display public-key peer brief

Type  Module  Name

---------------------------

RSA   1024    idrsa

peer-public-key end

Syntax

peer-public-key end

View

Public key view

Default level

2: System level

Parameters

None

Description

Use peer-public-key end to return from public key view to system view.

Related commands: public-key peer.

Examples

# Exit public key view.

<Sysname> system-view

[Sysname] public-key peer key1

[Sysname-pkey-public-key] peer-public-key end

[Sysname]

public-key-code begin

Syntax

public-key-code begin

View

Public key view

Default level

2: System level

Parameters

None

Description

Use public-key-code begin to enter public key code view. Then input the key data in the correct format to specify the peer host or server public key. Spaces and carriage returns are allowed between characters.

If the peer device is an H3C device, input the key data displayed by the display public-key local public command so that the key is format compliant.

Do not configure the peer RSA server public key for identity authentication in SSH applications. Authentication in SSH applications uses the RSA host public key. For more information about SSH, see Security Configuration Guide.

Related commands: public-key peer and public-key-code end.

Examples

# Enter public key code view and input the key.

<Sysname> system-view

[Sysname] public-key peer key1

[Sysname-pkey-public-key] public-key-code begin

[Sysname-pkey-key-code]30819F300D06092A864886F70D010101050003818D0030818902818100C0EC
8014F82515F6335A0A

[Sysname-pkey-key-code]EF8F999C01EC94E5760A079BD73E4F4D97F3500EDB308C29481B77E719D164
3135877E13B1C531B4

[Sysname-pkey-key-code]FF1877A5E2E7B1FA4710DB0744F66F6600EEFE166F1B854E2371D5B952ADF6
B80EB5F52698FCF3D6

[Sysname-pkey-key-code]1F0C2EAAD9813ECB16C5C7DC09812D4EE3E9A0B074276FFD4AF2050BD4A9B1
DDE675AC30CB020301

[Sysname-pkey-key-code]0001

public-key-code end

Syntax

public-key-code end

View

Public key code view

Default level

2: System level

Parameters

None

Description

Use public-key-code end to return from public key code view to public key view and to save the configured public key.

The system verifies the key before saving it. If the key is not in the correct format, the system discards the key and displays an error message. If the key is valid, the system saves the key.

Related commands: public-key peer and public-key-code begin.

Examples

# Exit public key code view and save the configured public key.

<Sysname> system-view

[Sysname] public-key peer key1

[Sysname-pkey-public-key] public-key-code begin

[Sysname-pkey-key-code]30819F300D06092A864886F70D010101050003818D0030818902818100C0EC
8014F82515F6335A0A

[Sysname-pkey-key-code]EF8F999C01EC94E5760A079BD73E4F4D97F3500EDB308C29481B77E719D164
3135877E13B1C531B4

[Sysname-pkey-key-code]FF1877A5E2E7B1FA4710DB0744F66F6600EEFE166F1B854E2371D5B952ADF6
B80EB5F52698FCF3D6

[Sysname-pkey-key-code]1F0C2EAAD9813ECB16C5C7DC09812D4EE3E9A0B074276FFD4AF2050BD4A9B1
DDE675AC30CB020301

[Sysname-pkey-key-code]0001

[Sysname-pkey-key-code] public-key-code end

[Sysname-pkey-public-key]

public-key local create rsa

Syntax

public-key local create rsa

View

System view

Default level

2: System level

Parameters

rsa: Specifies an RSA key pair.

Description

Use public-key local create to create local key pairs. The created local key pairs are saved automatically, and can survive a reboot.

When using this command to create RSA key pairs, you are prompted to provide the length of the key modulus. The modulus length is in the range 512 to 2048 bits, and defaults to 1024 bits. If the type of key pair already exists, the system asks you whether you want to overwrite it.

Related commands: public-key local destroy rsa and display public-key local public.

Examples

# Create local RSA key pairs.

<Sysname> system-view

[Sysname] public-key local create rsa

The range of public key size is (512 ~ 2048).

NOTES: If the key modulus is greater than 512,

It will take a few minutes.

Press CTRL+C to abort.

Input the bits of the modulus[default = 1024]:

Generating Keys...

++++++

++++++

++++++++

++++++++

public-key local destroy rsa

Syntax

public-key local destroy rsa

View

System view

Default level

2: System level

Parameters

rsa: RSA key pair.

Description

Use public-key local destroy to destroy the local key pairs.

Related commands: public-key local create.

Examples

# Destroy the local RSA key pairs.

<Sysname> system-view

[Sysname] public-key local destroy rsa

Warning: Confirm to destroy these keys? [Y/N]:y

public-key local export rsa

Syntax

public-key local export rsa { openssh | ssh1 | ssh2 } [ filename ]

View

System view

Default level

2: System level

Parameters

openssh: Uses the format of OpenSSH.

ssh1: Uses the format of SSH1.5.

ssh2: Uses the format of SSH2.0.

filename: Specifies the name of the file for storing the host public key. For more information about file name, see Fundamentals Configuration Guide.

Description

Use public-key local export rsa to display the local RSA host public key on the screen or export it to a specific file.

If you specify the filename argument, the command exports the local RSA public key to the specified file and saves the file; otherwise, the command displays the local RSA host public key on the screen.

SSH1, SSH2.0 and OpenSSH are three different public key formats for different requirements.

Related commands: public-key local create rsa and public-key local destroy rsa.

Examples

# Export the local RSA host public key in OpenSSH format to a file named key.pub.

<Sysname> system-view

[Sysname] public-key local export rsa openssh key.pub

# Display the local RSA host public key in SSH2.0 format.

<Sysname> system-view

[Sysname] public-key local export rsa ssh2

---- BEGIN SSH2 PUBLIC KEY ----

Comment: "rsa-key-20070625"

AAAAB3NzaC1yc2EAAAADAQABAAAAgQDAo0dVYR1S5f30eLKGNKuqb5HU3M0TTSaGlER2GmcRI2sgSegbo1x6u
t5NIc5+jJxuRCU4+gMc76iS8d+2d50FqIweEkHHkSG/ddgXt/iAZ6cY81bdu/CKxGiQlkUpbw4vSv+X5KeE7j
+o0MpOpzh3W768/+u1riz+1LcwVTs51Q==

---- END SSH2 PUBLIC KEY ----

# Display the local RSA host public key in OpenSSH format.

<Sysname> system-view

[Sysname] public-key local export rsa openssh

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDAo0dVYR1S5f30eLKGNKuqb5HU3M0TTSaGlER2GmcRI2sgSegbo1x6u
t5NIc5+jJxuRCU4+gMc76iS8d+2d50FqIweEkHHkSG/ddgXt/iAZ6cY81bdu/CKxGiQlkUpbw4vSv+X5KeE7j
+o0MpOpzh3W768/+u1riz+1LcwVTs51Q== rsa-key

public-key peer

Syntax

public-key peer keyname

undo public-key peer keyname

View

System view

Default level

2: System level

Parameters

keyname: Specifies the peer public key name, a case-sensitive string of 1 to 64 characters.

Description

Use public-key peer to specify a name for a peer public key and enter public key view.

Use undo public-key peer to remove a peer public key.

To manually configure a peer public key on the local device, obtain the public key (in hexadecimal) from the peer device beforehand and perform the following configurations:

1.     Execute the public-key peer command, and then the public-key-code begin command to enter public key code view.

2.     Type the peer public key.

3.     Execute the public-key-code end command to save the public key and return to public key view.

4.     Execute the peer-public-key end command to return to system view.

Related commands: public-key-code begin, public-key-code end, peer-public-key end, and display public-key peer.

Examples

# Specify the name for the peer public key as key1 and enter public key view.

<Sysname> system-view

[Sysname] public-key peer key1

[Sysname-pkey-public-key]

public-key peer import sshkey

Syntax

public-key peer keyname import sshkey filename

undo public-key peer keyname

View

System view

Default level

2: System level

Parameters

keyname: Specifies a public key name, a case-sensitive string of 1 to 64 characters.

filename: Specifies the name of the file that saves a peer host public key. For more information about file name, see Fundamentals Configuration Guide.

Description

Use public-key peer import sshkey to import a peer host public key from the public key file.

Use undo public-key peer to remove the specified peer host public key.

After execution of this command, the system automatically transforms the host public key in SSH1, SSH2.0 or OpenSSH format to PKCS format, and imports the key. This operation requires that you get a copy of the public key file from the peer device through FTP or TFTP in advance.

Related commands: display public-key peer.

Examples

# Import the peer host public key named key2 from the public key file key.pub.

<Sysname> system-view

[Sysname] public-key peer key2 import sshkey key.pub