Manual:IP/IPsec

Applies to RouterOS: v4.5

Summary

Sub-menu: /ip ipsec
Package required: security
Standards: RFC 4301

Internet Protocol Security (IPsec) is a set of protocols to secure packet exchange over IP network. Each IP packet is authenticated and encrypted by one of various supported encryption and authentication algorithms.

IPsec uses two protocols to provide traffic security

• Authentication Header (AH) RFC 4302
• Encapsulating Security Payload (ESP) RFC 4303

These protocols may be applied individually or in combination with each other, but most security requirements can be met through the use of ESP by itself. Each of those protocols support transport mode and tunnel mode. In transport mode IpSec provides protection of next layer protocol, but in tunnel mode whole IP packet is protected (including IP header).

IpSec allows user to control security level by choosing which protocol to use (AH, ESP), tunnel or transport mode, what cryptographic algorithm to use and in what combination specified protocols and services will be used.

Because most of the security services provided by IPsec require the use of cryptographic keys, IPsec relies on a separate set of mechanisms for putting these keys in place (IKE).

Internet Key Exchange

The Internet Key Exchange (IKE) is a protocol that provides authenticated keying material for Internet Security Association and Key Management Protocol (ISAKMP) framework. There are other key exchange schemes that work with ISAKMP, but IKE is the most widely used one. Together they provide means for authentication of hosts and automatic management of security associations (SA).

Most of the time IKE daemon is doing nothing. There are two possible situations when it is activated:

There is some traffic caught by a policy rule which needs to become encrypted or authenticated, but the policy doesn't have any SAs. The policy notifies IKE daemon about that, and IKE daemon initiates connection to remote host. IKE daemon responds to remote connection. In both cases, peers establish connection and execute 2 phases:

• Phase 1 - The peers agree upon algorithms they will use in the following IKE messages and authenticate. The keying material used to derive keys for all SAs and to protect following ISAKMP exchanges between hosts is generated also.
• Phase 2 - The peers establish one or more SAs that will be used by IPsec to encrypt data. All SAs established by IKE daemon will have lifetime values (either limiting time, after which SA will become invalid, or amount of data that can be encrypted by this SA, or both).

There are two lifetime values - soft and hard. When SA reaches it's soft lifetime treshold, the IKE daemon receives a notice and starts another phase 2 exchange to replace this SA with fresh one. If SA reaches hard lifetime, it is discarded.

IKE can optionally provide a Perfect Forward Secrecy (PFS), which is a property of key exchanges, that, in turn, means for IKE that compromising the long term phase 1 key will not allow to easily gain access to all IPsec data that is protected by SAs established through this phase 1. It means an additional keying material is generated for each phase 2.

Generation of keying material is computationally very expensive. Exempli gratia, the use of modp8192 group can take several seconds even on very fast computer. It usually takes place once per phase 1 exchange, which happens only once between any host pair and then is kept for long time. PFS adds this expensive operation also to each phase 2 exchange.

Diffie-Hellman Groups

Diffie-Hellman (DH) key exchange protocol allows two parties without any initial shared secret to create one securely. The following Modular Exponential (MODP) and Elliptic Curve (EC2N) Diffie-Hellman (also known as "Oakley") Groups are supported:

Diffie-Hellman Group	Name	Reference
Group 1	768 bit MODP group	RFC 2409
Group 2	1024 bits MODP group	RFC 2409
Group 3	EC2N group on GP(2^155)	RFC 2409
Group 4	EC2N group on GP(2^185)	RFC 2409
Group 5	1536 bits MODP group	RFC 3526

IKE Traffic

To avoid problems with IKE packets hit some SPD rule and require to encrypt it with not yet established SA (that this packet perhaps is trying to establish), locally originated packets with UDP source port 500 are not processed with SPD. The same way packets with UDP destination port 500 that are to be delivered locally are not processed in incoming policy check.

Setup Procedure

To get IPsec to work with automatic keying using IKE-ISAKMP you will have to configure policy, peer and proposal (optional) entries.

For manual keying you will have to configure policy and manual-sa entries.

Peer configuration

Sub-menu: /ip ipsec peer

Peer configuration settings are used to establish connections between IKE daemons (phase 1 configuration). This connection then will be used to negotiate keys and algorithms for SAs.

Property	Description
address (IP[/Netmask]:port; Default: 0.0.0.0/32:500)	Address prefix. If remote peer's address matches this prefix, then this peer configuration is used in authentication and establishment of phase 1. If several peer's addresses match several configuration entries, the most specific one (i.e. the one with largest netmask) will be used.
auth-method (pre-shared-key | rsa-signature; Default: pre-shared-key)	Authentication method: pre-shared-key - authenticate by a password (secret) string shared between the peers rsa-signature - authenticate using a pair of RSA certificates
certificate (string; Default: )	Name of a certificate on the local side (signing packets; the certificate must have private key). Applicable if RSA signature authentication method is used.
dh-group (ec2n155 | ec2n185 | modp1024 | modp1536 | modp768; Default: modp1024)	Diffie-Hellman group (cipher strength)
dpd-interval (disable-dpd | time; Default: disable-dpd)	Dead peer detection interval. If set to disable-dpd, dead peer detection will not be used.
dpd-maximum-failures (integer: 1..100; Default: 5)	Maximum count of failures until peer is considered to be dead.
enc-algorithm (3des | aes-128 | aes-192 | aes-256 | des | blowfish | camilla; Default: 3des)	Encryption algorithm. blowfish, camilla algorithms are supported starting from v4.5.
exchange-mode (aggressive | base | main; Default: main)	Different ISAKMP phase 1 exchange modes according to RFC 2408. Do not use other modes then main unless you know what you are doing.
generate-policy (yes | no; Default: no)	Allow this peer to establish SA for non-existing policies. Such policies are created dynamically for the lifetime of SA. This way it is possible, for example, to create IPsec secured L2TP tunnels, or any other setup where remote peer's IP address is not known at the configuration time.
hash-algorithm (md5 | sha1; Default: md5)	Hashing algorithm. SHA (Secure Hash Algorithm) is stronger, but slower.
lifebytes (Integer: 0..4294967295; Default: 0)	Phase 1 lifetime: specifies how much bytes can be transferred before SA is discarded. If set to 0, SA will not be discarded due to byte count excess.
lifetime (time; Default: 1d)	Phase 1 lifetime: specifies how long the SA will be valid
nat-traversal (yes | no; Default: no)	Use Linux NAT-T mechanism to solve IPsec incompatibility with NAT routers inbetween IPsec peers. This can only be used with ESP protocol (AH is not supported by design, as it signes the complete packet, including IP header, which is changed by NAT, rendering AH signature invalid). The method encapsulates IPsec ESP traffic into UDP streams in order to overcome some minor issues that made ESP incompatible with NAT.
proposal-check (claim | exact | obey | strict; Default: obey)	Phase 2 lifetime check logic: claim - take shortest of proposed and configured lifetimes and notify initiator about it exact - require lifetimes to be the same obey - accept whatever is sent by an initiator strict - if proposed lifetime is longer than the default then reject proposal otherwise accept proposed lifetime
remote-certificate (string; Default: )	Name of a certificate for authenticating the remote side (validating packets; no private key required). Applicable if RSA signature authentication method is used
secret (string; Default: "")	Secret string (in case pre-shared key authentication is used). If it starts with '0x', it is parsed as a hexadecimal value
send-initial-contact (yes | no; Default: yes)	Specifies whether to send initial IKE information or wait for remote side.

Policy

Sub-menu: /ip ipsec policy

Policy table is needed to determine whether security settings should be applied to a packet.

Property	Description
action (discard | encrypt | none; Default: encrypt)	Specifies what to do with packet matched by the policy. none - pass the packet unchanged discard - drop the packet encrypt - apply transformations specified in this policy and it's SA
dst-address (IP/Mask:Port; Default: 0.0.0.0/32:any)	Destination prefix and port.
ipsec-protocols (ah|esp; Default: esp)	Specifies what combination of Authentication Header and Encapsulating Security Payload protocols you want to apply to matched traffic.
level (require | unique | use; Default: require)	Specifies what to do if some of the SAs for this policy cannot be found: use - skip this transform, do not drop packet and do not acquire SA from IKE daemon require - drop packet and acquire SA unique - drop packet and acquire a unique SA that is only used with this particular policy
manual-sa (string | none; Default: none)	Name of manual-sa template that will be used to create SAs for this policy. If set to none, manual keys are not used.
priority (Integer: -2147483646..2147483647; Default: 0)	Policy ordering classificator (signed integer). Larger number means higher priority.
proposal (string; Default: default)	Name of proposal information that will be sent by IKE daemon to establish SAs for this policy
protocol (all | egp | ggp | icmp | igmp | ...; Default: all)	IP packet protocol to match.
sa-dst-address (IP; Default: 0.0.0.0)	SA destination IP address (remote peer).
sa-src-address (IP; Default: 0.0.0.0)	SA source IP address (local peer).
src-address (IP/Mask:Port; Default: 0.0.0.0/32:any)	Source IP prefix
tunnel (yes | no; Default: no)	Specifies whether to use tunnel mode

Command /ip ipsec policy print stats will show current status of the policy. Additional read-only parameters will be printed.

Property	Description
in-accepted (integer)	How many incoming packets were passed by the policy without an attempt to decrypt.
in-dropped (integer)	How many incoming packets were dropped by the policy without an attempt to decrypt
in-transformed (integer)	How many incoming packets were decrypted (ESP) and/or verified (AH) by the policy
out-accepted (integer)	How many outgoing packets were passed by the policy without an attempt to encrypt
out-dropped (integer)	How many outgoing packets were dropped by the policy without an attempt to encrypt
out-transformed (integer)	How many outgoing packets were encrypted (ESP) and/or verified (AH) by the policy
ph2-state (expired | no-phase2 | established)	Indication of the progress of key establishing.

Proposal settings

Sub-menu: /ip ipsec proposal

Manual SA

Sub-menu: /ip ipsec manual-sa

Installed SA

Sub-menu: /ip ipsec installed-sa

Remote Peers

Sub-menu: /ip ipsec remote-peers

Statistics

Sub-menu: /ip ipsec statistics

(needs editing)