Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show security ipsec security-associations

 

Syntax

Release Information

Command introduced in Junos OS Release 8.5. Support for the family option added in Junos OS Release 11.1. Support for the vpn-name option added in Junos OS Release 11.4R3. Support for the traffic-selector option and traffic selector field added in Junos OS Release 12.1X46-D10. Support for Auto Discovery VPN (ADVPN) added in Junos OS Release 12.3X48-D10. Support for IPsec datapath verification added in Junos OS Release 15.1X49-D70. Support for thread anchorship added in Junos OS Release 17.4R1. Starting in Junos OS Release 18.2R2 the show security ipsec security-assocations detail command output will include thread anchorship information for the security associations (SAs).

Description

Display information about the IPsec security associations (SAs).

Options

noneDisplay information about all SAs.
brief | detail(Optional) Display the specified level of output. The default is brief.
family(Optional) Display SAs by family. This option is used to filter the output.
  • inet—IPv4 address family.

  • inet6—IPv6 address family.

fpc slot-number pic slot-number(Optional) Display information about existing IPsec SAs in the specified Flexible PIC Concentrator (FPC) slot and PIC slot.
Note

In a chassis cluster, when you execute the CLI command show security ipsec security-associations pic <slot-number> fpc <slot-number> in operational mode, only the primary node information about the existing IPsec SAs in the specified Flexible PIC Concentrator (FPC) slot and PIC slot is displayed.

index SA-index-number(Optional) Display detailed information about the specified SA identified by this index number. To obtain a list of all SAs that includes their index numbers, use the command with no options.
kmd-instance(Optional) Display information about existing IPsec SAs in the key management process (in this case, it is KMD) identified by the FPC slot-number and PIC slot-number.
  • all—All KMD instances running on the Services Processing Unit (SPU).

  • kmd-instance-name—Name of the KMD instance running on the SPU.

pic slot-number fpc slot-number(Optional) Display information about existing IPsec SAs in the specified PIC slot and FPC slot.
sa-type(Optional for ADVPN) Display information for the specified type of SA. shortcut is the only option for this release.
traffic-selector traffic-selector-name(Optional) Display information about the specified traffic selector.
vpn-name vpn-name(Optional) Display information about the specified VPN.

Required Privilege Level

view

List of Sample Output

show security ipsec security-associations (IPv4)

show security ipsec security-associations (IPv6)

show security ipsec security-associations index 511672

show security ipsec security-associations index 131073 detail

show security ipsec sa detail

show security ipsec sa detail

show security ipsec security-associations brief

show security ipsec security-associations detail

show security ipsec security-associations family inet6

show security ipsec security-associations fpc 6 pic 1 kmd-instance all (SRX Series Devices)

show security ipsec security-associations detail (ADVPN Suggester, Static Tunnel)

show security ipsec security-associations detail (ADVPN Partner, Static Tunnel)

show security ipsec security-associations sa-type shortcut (ADVPN)

show security ipsec security-associations sa-type shortcut detail (ADVPN)

show security ipsec security-associations family inet detail

show security ipsec security-associations detail (SRX4600)

Output Fields

Table 1 lists the output fields for the show security ipsec security-associations command. Output fields are listed in the approximate order in which they appear.

Table 1: show security ipsec security-associations

Field Name

Field Description

Level of Output

Total active tunnels

Total number of active IPsec tunnels.

brief

ID

Index number of the SA. You can use this number to get additional information about the SA.

All levels

Algorithm

Cryptography used to secure exchanges between peers during the IKE negotiations includes:

  • An authentication algorithm used to authenticate exchanges between the peers.

  • An encryption algorithm used to encrypt data traffic.

brief

SPI

Security parameter index (SPI) identifier. An SA is uniquely identified by an SPI. Each entry includes the name of the VPN, the remote gateway address, the SPIs for each direction, the encryption and authentication algorithms, and keys. The peer gateways each have two SAs, one resulting from each of the two phases of negotiation: IKE and IPsec.

brief

Life: sec/kb

The lifetime of the SA, after which it expires, expressed either in seconds or kilobytes.

brief

Mon

The Mon field refers to VPN monitoring status. If VPN monitoring is enabled, then this field displays U (up) or D (down). A hyphen (-) means VPN monitoring is not enabled for this SA. A V means that IPsec datapath verification is in progress.

brief

lsys

The root system.

brief

Port

If Network Address Translation (NAT) is used, this value is 4500. Otherwise, it is the standard IKE port, 500.

All levels

Gateway

IP address of the remote gateway.

brief

Virtual-system

Name of the logical system.

detail

VPN name

IPsec name for VPN.

detail

State

State has two options, Installed and Not Installed.

  • Installed—The SA is installed in the SA database.

  • Not Installed—The SA is not installed in the SA database.

    For transport mode, the value of State is always Installed.

detail

Local gateway

Gateway address of the local system.

detail

Remote gateway

Gateway address of the remote system.

detail

Traffic selector

Name of the traffic selector.

detail

Local identity

Identity of the local peer so that its partner destination gateway can communicate with it. The value is specified as an IP address, fully qualified domain name, e-mail address, or distinguished name (DN).

detail

Remote identity

IP address of the destination peer gateway.

detail

Version

IKE version, either IKEv1 or IKEv2.

detail

DF-bit

State of the don't fragment bit: set or cleared.

detail

Location

FPC—Flexible PIC Concentrator (FPC) slot number.

PIC—PIC slot number.

KMD-Instance—The name of the KMD instance running on the SPU, identified by FPC slot-number and PIC slot-number. Currently, 4 KMD instances running on each SPU, and any particular IPsec negotiation is carried out by a single KMD instance.

detail

Tunnel events

Tunnel event and the number of times the event has occurred. See Tunnel Events for descriptions of tunnel events and the action you can take.

detail

Anchorship

Anchor thread ID for the SA (for SRX4600 Series devices with the detail option).

 

Direction

Direction of the SA; it can be inbound or outbound.

detail

AUX-SPI

Value of the auxiliary security parameter index(SPI).

  • When the value is AH or ESP, AUX-SPI is always 0.

  • When the value is AH+ESP, AUX-SPI is always a positive integer.

detail

Mode

Mode of the SA:

  • transport—Protects host-to-host connections.

  • tunnel—Protects connections between security gateways.

detail

Type

Type of the SA:

  • manual—Security parameters require no negotiation. They are static and are configured by the user.

  • dynamic—Security parameters are negotiated by the IKE protocol. Dynamic SAs are not supported in transport mode.

detail

State

State of the SA:

  • Installed—The SA is installed in the SA database.

  • Not Installed—The SA is not installed in the SA database.

    For transport mode, the value of State is always Installed.

detail

Protocol

Protocol supported.

  • Transport mode supports Encapsulation Security Protocol (ESP) and Authentication Header (AH).

  • Tunnel mode supports ESP and AH.

detail

Authentication

Type of authentication used.

detail

Encryption

Type of encryption used.

detail

Soft lifetime

The soft lifetime informs the IPsec key management system that the SA is about to expire.

Each lifetime of an SA has two display options, hard and soft, one of which must be present for a dynamic SA. This allows the key management system to negotiate a new SA before the hard lifetime expires.

  • Expires in seconds—Number of seconds left until the SA expires.

detail

Hard lifetime

The hard lifetime specifies the lifetime of the SA.

  • Expires in seconds—Number of seconds left until the SA expires.

detail

Lifesize Remaining

The lifesize remaining specifies the usage limits in kilobytes. If there is no lifesize specified, it shows unlimited.

  • Expires in kilobytes—Number of kilobytes left until the SA expires.

detail

Anti-replay service

State of the service that prevents packets from being replayed. It can be Enabled or Disabled.

detail

Replay window size

Size of the antireplay service window, which is 64 bits.

detail

Bind-interface

The tunnel interface to which the route-based VPN is bound.

detail

Copy-Outer-DSCP

Indicates if the system copies the outer DSCP value from the IP header to the inner IP header.

detail

tunnel-establishment

Indicates how the IKE is activated.

detail

Sample Output

For brevity, the show command outputs does not display all the values of the configuration. Only a subset of the configuration is displayed. Rest of the configuration on the system has been replaced with ellipses (...).

show security ipsec security-associations (IPv4)

user@host> show security ipsec security-associations

show security ipsec security-associations (IPv6)

user@host> show security ipsec security-associations

show security ipsec security-associations index 511672

user@host> show security ipsec security-associations index 511672

show security ipsec security-associations index 131073 detail

user@host> show security ipsec security-associations index 131073 detail

Starting with Junos OS Release 18.2R1, the CLI show security ipsec security-associations index index-number detail output displays all the child SA details including forwarding class name.

show security ipsec sa detail

user@host> show security ipsec sa detail

show security ipsec sa detail

user@host> show security ipsec sa detail

Starting with Junos OS Release 19.1R1, a new field tunnel-establishment in the output of the CLI show security ipsec sa detail displays the option configured under ipsec vpn establish-tunnels hierarchy.

show security ipsec security-associations brief

user@host> show security ipsec security-associations brief

show security ipsec security-associations detail

user@host> show security ipsec security-associations detail

show security ipsec security-associations family inet6

user@host> show security ipsec security-associations family inet6

show security ipsec security-associations fpc 6 pic 1 kmd-instance all (SRX Series Devices)

user@host> show security ipsec security-associations fpc 6 pic 1 kmd-instance all

show security ipsec security-associations detail (ADVPN Suggester, Static Tunnel)

user@host> show security ipsec security-associations detail

show security ipsec security-associations detail (ADVPN Partner, Static Tunnel)

user@host> show security ipsec security-associations detail

show security ipsec security-associations sa-type shortcut (ADVPN)

user@host> show security ipsec security-associations sa-type shortcut

show security ipsec security-associations sa-type shortcut detail (ADVPN)

user@host> show security ipsec security-associations sa-type shortcut detail

show security ipsec security-associations family inet detail

user@host> show security ipsec security-associations family inet detail

show security ipsec security-associations detail (SRX4600)

user@host> show security ipsec security-associations detail