Cisco IOS Security Command Reference: Commands D to L, Cisco IOS XE Release 3SE (Cisco WLC 5700 Series)
F through H
Downloads: This chapterpdf (PDF - 291.0 KB) The complete bookPDF (PDF - 1.6 MB) | Feedback

F through H

F through H

hostname (IKEv2 keyring)

To specify the hostname for the peer in the Internet Key Exchange Version 2 (IKEv2) keyring, use the hostname command IKEv2 keyring peer configuration mode. To remove the hostname, use the no form of this command.

hostname name

no hostname

Syntax Description


Name for the peer.

Command Default

The hostname is not specified.

Command Modes

IKEv2 keyring peer configuration (config-ikev2-keyring-peer)

Command History




This command was introduced.

Cisco IOS XE Release 3.3S

This command was integrated into Cisco IOS XE Release 3.3S.


This command was integrated into Cisco IOS Release 15.2(4)S.

Usage Guidelines

When configuring the IKEv2 keyring, use this command to identify the peer using hostname, which is:

  • Independent of the IKEv2 identity.
  • Available on an IKEv2 initiator only.
  • Provided by IPsec to IKEv2 as part of a security association setup request to identify the peer.
  • Used to identify the peer only with crypto maps and not with tunnel protection.


The following example shows how to configure the hostname for a peer when configuring an IKEv2 keyring:

Router(config)# crypto ikev2 keyring keyring-1
Router(config-ikev2-keyring)# peer peer1
Router(config-ikev2-keyring-peer)# description peer1
Router(config-ikev2-keyring-peer)# hostname

Related Commands



address (ikev2 keyring)

Specifies the IPv4 address or the range of the peers in IKEv2 key.

crypto ikev2 keyring

Defines an IKEv2 keyring.

description (ikev2 keyring)

Describes an IKEv2 peer or a peer group for the IKEv2 keyring.

identity (ikev2 keyring)

Identifies the peer with IKEv2 types of identity.


Defines a peer or a peer group for the keyring.

pre-shared-key (ikev2 keyring)

Defines a preshared key for the IKEv2 peer.