LISP-SEC metadata associated with a Map-Request is transported within the Encapsulated Control Message that contains the Map-Request.
LISP-SEC metadata associated with the Map-Reply is transported within the Map-Reply itself.
These specifications use an HMAC in various places (as described in the following). The HMAC function AUTH-HMAC-SHA-256-128 [
RFC 6234]
MUST be supported in LISP-SEC implementations. LISP-SEC deployments
SHOULD use the AUTH-HMAC-SHA-256-128 HMAC function, except when communicating with older implementations that only support AUTH-HMAC-SHA-1-96 [
RFC 2104].
LISP-SEC uses the ECM defined in [
RFC 9301] with the S-bit set to 1 to indicate that the LISP header includes Authentication Data (AD). The format of the LISP-SEC ECM AD is defined in
Figure 1. OTK-AD stands for One-Time Key Authentication Data and EID-AD stands for EID Authentication Data.
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| ECM AD Type | Unassigned | Requested HMAC ID |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\
| OTK Length | Key ID | OTK Wrap. ID | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| One-Time-Key Preamble ... | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+OTK-AD
| ... One-Time-Key Preamble | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
~ One-Time Key (128 bits) ~/
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ <---+
| EID-AD Length | KDF ID | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| Record Count |E| Unassigned | EID HMAC ID |EID-AD
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\ |
| Unassigned | EID mask-len | EID-AFI | | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Rec |
~ EID-Prefix ... ~ | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/ |
~ EID HMAC ~ |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ <---+
-
ECM AD Type:
-
1 (LISP-SEC Authentication Data). See Section 8.
-
Unassigned:
-
Set to 0 on transmission and ignored on receipt.
-
Requested HMAC ID:
-
The HMAC algorithm, which will be used to protect the mappings, requested by the ITR. Permitted values are registered in the LISP-SEC Authentication Data HMAC ID (see Section 8.3). Refer to Section 6.4 for more details.
-
OTK Length:
-
The length (in bytes) of the OTK Authentication Data (OTK-AD), which contains the OTK Preamble and the OTK.
-
Key ID:
-
The identifier of the pre-shared secret shared by an ITR and the Map-Resolver, and by the Map-Server and an ETR. Per-message keys are derived from the pre-shared secret to encrypt, authenticate the origin, and protect the integrity of the OTK. The Key ID allows to rotate between multiple pre-shared secrets in a nondisruptive way.
-
OTK Wrapping ID (OTK Wrap. ID):
-
The identifier of the Key Derivation Function and of the key wrapping algorithm used to encrypt the One-Time-Key. Permitted values are registered in the LISP-SEC Authentication Data Key Wrap ID (see Section 8.4). Refer to Section 6.5 for more details.
-
One-Time-Key Preamble:
-
Set to 0 if the OTK is not encrypted. When the OTK is encrypted, this field MAY carry additional metadata resulting from the key wrapping operation. When a 128-bit OTK is sent unencrypted by a Map-Resolver, the OTK Preamble is set to 0x0000000000000000 (64 bits). See Section 6.5.1 for details.
-
One-Time-Key:
-
The OTK wrapped as specified by OTK Wrapping ID. See Section 6.5 for details.
-
EID-AD Length:
-
Length (in bytes) of the EID Authentication Data (EID-AD). The ITR MUST set the EID-AD Length to 4 bytes, as it only fills the 'KDF ID' field, and all the remaining fields part of the EID-AD are not present. An EID-AD MAY contain multiple EID-Records. Each EID-Record is 4 bytes long, plus the length of the AFI-encoded EID-Prefix.
-
KDF ID:
-
Identifier of the Key Derivation Function used to derive the MS-OTK. Permitted values are registered in the LISP-SEC Authentication Data Key Derivation Function ID (see Section 8.5). Refer to Section 6.7 for more details.
-
Record Count:
-
As defined in Section 5.2 of RFC 9301.
-
E:
-
ETR-Cant-Sign bit. If this bit is set to 1, it signals to the ITR that at least one of the ETRs that is authoritative for the EID-Prefixes of this Map-Reply has not enabled LISP-SEC. Only a Map-Server can set this bit. See Section 6.7 for more details.
-
Unassigned:
-
Set to 0 on transmission and ignored on receipt.
-
EID HMAC ID:
-
Identifier of the HMAC algorithm used to protect the integrity of the EID-AD. This field is filled by the Map-Server that computed the EID-Prefix HMAC. See Section 6.7.1 for more details.
-
EID mask-len:
-
As defined in Section 5.2 of RFC 9301.
-
EID-AFI:
-
As defined in Section 5.2 of RFC 9301.
-
EID-Prefix:
-
As defined in Section 5.2 of RFC 9301.
-
EID HMAC:
-
HMAC of the EID-AD computed and inserted by a Map-Server. See Section 6.7.1 for more details.
LISP-SEC uses the Map-Reply defined in [
RFC 9301], with Type set to 2 and S-bit set to 1 to indicate that the Map-Reply message includes Authentication Data (AD). The format of the LISP-SEC Map-Reply Authentication Data is defined in
Figure 2. PKT-AD is the Packet Authentication Data that covers the Map-Reply payload.
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| MR AD Type | Unassigned |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ <---+
| EID-AD Length | KDF ID | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| Record Count | Unassigned | EID HMAC ID |EID-AD
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\ |
| Unassigned | EID mask-len | EID-AFI | | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Rec |
~ EID-Prefix ... ~ | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/ |
~ EID HMAC ~ |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ <---+
| PKT-AD Length | PKT HMAC ID |\
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
~ PKT HMAC ~PKT-AD
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/
-
MR AD Type:
-
1 (LISP-SEC Authentication Data). See Section 8.
-
EID-AD Length:
-
Length (in bytes) of the EID-AD (see Section 6.1).
-
KDF ID:
-
Identifier of the Key Derivation Function used to derive MS-OTK (see Section 6.1).
-
Record Count:
-
The number of records in this Map-Reply message (see Section 6.1).
-
Unassigned:
-
Set to 0 on transmission and ignored on receipt.
-
EID HMAC ID:
-
Identifier of the HMAC algorithm used to protect the integrity of the EID-AD (see Section 6.1).
-
EID mask-len:
-
Mask length for EID-Prefix (see Section 6.1).
-
EID-AFI:
-
See Section 6.1.
-
EID-Prefix:
-
See Section 6.1.
-
EID HMAC:
-
See Section 6.1.
-
PKT-AD Length:
-
Length (in bytes) of the Packet Authentication Data (PKT-AD).
-
PKT HMAC ID:
-
Identifier of the HMAC algorithm used to protect the integrity of the Map-Reply (see Section 6.5).
-
PKT HMAC:
-
HMAC of the whole Map-Reply packet to protect its integrity, including the LISP-SEC Authentication Data (from the 'Map-Reply Type' field to the 'PKT HMAC' field), which allow message authentication.
The S-bit in the Map-Register message (see [
RFC 9301]) indicates to the Map-Server that the registering ETR is LISP-SEC enabled. An ETR that supports LISP-SEC
MUST set the S-bit in its Map-Register messages.
Upon creating a Map-Request, the ITR generates a random ITR-OTK that is stored locally, until the corresponding Map-Reply is received (see
Section 6.9), together with the nonce generated as specified in [
RFC 9301].
The ITR
MAY use the 'KDF ID' field to indicate the recommended KDF algorithm according to local policy. The Map-Server can overwrite the KDF ID if it does not support the KDF ID recommended by the ITR (see
Section 6.7). A KDF value of NOPREF (0) may be used to specify that the ITR has no preferred KDF ID.
ITR-OTK confidentiality and integrity protection
MUST be provided in the path between the ITR and the Map-Resolver. This can be achieved either by encrypting the ITR-OTK with the pre-shared secret known to the ITR and the Map-Resolver (see
Section 6.5) or by enabling DTLS [
RFC 9147] between the ITR and the Map-Resolver.
The Map-Request (as defined in [
RFC 9301])
MUST be encapsulated as a LISP Control Message in an ECM, with the S-bit set to 1, to indicate the presence of Authentication Data. Such a message is also called a "Protected Map-Request" in this memo.
The ITR-OTK is wrapped with the algorithm specified by the 'OTK Wrapping ID' field. See
Section 6.5 for further details on OTK encryption. If the NULL-KEY-WRAP-128 algorithm (see
Section 8.4) is selected, and no other encryption mechanism (e.g., DTLS) is enabled in the path between the ITR and the Map-Resolver, the Map-Request
MUST be dropped, and an appropriate log action
SHOULD be taken. Implementations may include mechanisms (which are beyond the scope of this document) to avoid log resource exhaustion attacks.
The 'Requested HMAC ID' field contains the suggested HMAC algorithm to be used by the Map-Server and the ETR to protect the integrity of the ECM Authentication Data and of the Map-Reply. A HMAC ID value of NONE (0)
MAY be used to specify that the ITR has no preferred HMAC ID.
The 'KDF ID' field specifies the suggested Key Derivation Function to be used by the Map-Server to derive the MS-OTK. A KDF value of NONE (0) may be used to specify that the ITR has no preferred KDF ID.
The EID-AD Length is set to 4 bytes, since the Authentication Data does not contain EID-Prefix Authentication Data, and the EID-AD contains only the 'KDF ID' field.
If the ITR is directly connected to a Mapping System, such as LISP+ALT [
RFC 6836], it performs the functions of both the ITR and the Map-Resolver, forwarding the Protected Map-Request as described in
Section 6.6.
The processing performed by Proxy ITRs (PITRs) is equivalent to the processing of an ITR; hence, the procedure described above applies.
MS-OTK confidentiality and integrity protection
MUST be provided in the path between the Map-Server and the ETR. This can be achieved either by enabling DTLS between the Map-Server and the ETR or by encrypting the MS-OTK with the pre-shared secret known to the Map-Server and the ETR [
RFC 9301].
Similarly, ITR-OTK confidentiality and integrity protection
MUST be provided in the path between the ITR and the Map-Resolver. This can be achieved either by enabling DTLS between the Map-Server and the ITR or by encrypting the ITR-OTK with the pre-shared secret known to the ITR and the Map-Resolver. The ITR/Map-Resolver pre-shared key is similar to the Map-Server/ETR pre-shared key.
This section describes OTK processing in the ITR/Map-Resolver path, as well as in the Map-Server/ETR path.
It's important to note that, to prevent ETR's overclaiming attacks, the ITR/Map-Resolver pre-shared secret
MUST be independent from the Map-Server/ETR pre-shared secret.
The OTK is wrapped using the algorithm specified in the 'OTK Wrapping ID' field. This field identifies both the:
-
Key Encryption Algorithm used to encrypt the wrapped OTK and
-
Key Derivation Function used to derive a per-message encryption key.
Implementations of this specification
MUST support the OTK Wrapping ID AES-KEY-WRAP-128+HKDF-SHA256, which specifies the use of the HKDF-SHA256 Key Derivation Function specified in [
RFC 5869] to derive a per-message encryption key (per-msg-key), as well as the AES-KEY-WRAP-128 key wrap algorithm used to encrypt a 128-bit OTK, according to [
RFC 3394].
Implementations of this specification
MUST support OTK Wrapping NULL-KEY-WRAP-128. NULL-KEY-WRAP-128 is used to carry an unencrypted 128-bit OTK, with a 64-bit preamble set to 0x0000000000000000 (64 bits).
The key wrapping process for OTK Wrapping ID AES-KEY-WRAP-128+HKDF-SHA256 is described below:
-
The KDF and key wrap algorithms are identified by the value of the 'OTK Wrapping ID' field. The initial values are documented in Table 5.
-
If the NULL-KEY-WRAP-128 algorithm (see Section 8.4) is selected and DTLS is not enabled, the Map-Request MUST be dropped and an appropriate log action SHOULD be taken. Implementations may include mechanisms (which are beyond the scope of this document) to avoid log resource exhaustion attacks.
-
The pre-shared secret used to derive the per-msg-key is represented by PSK[Key ID], which is the pre-shared secret identified by the 'Key ID'.
-
The 128-bit-long per-message encryption key is computed as:
per-msg-key = KDF( nonce + s + PSK[Key ID] )
where the nonce is the value in the 'Nonce' field of the Map-Request, 's' is the string "OTK-Key-Wrap", and the operation'+' just indicates string concatenation.
-
The per-msg-key is then used to wrap the OTK with AES-KEY-WRAP-128, as specified in Section 2.2.1 of RFC 3394. The AES Key Wrap Initialization Value MUST be set to 0xA6A6A6A6A6A6A6A6 (64 bits). The output of the AES key wrap operation is 192 bits long. The most significant 64 bits are copied in the 'One-Time Key Preamble' field, while the 128 least significant bits are copied in the 'One-Time Key' field of the LISP-SEC Authentication Data.
When decrypting an encrypted OTK, the receiver
MUST verify that the Initialization Value resulting from the AES key wrap decryption operation is equal to 0xA6A6A6A6A6A6A6A6. If this verification fails, the receiver
MUST discard the entire message.
However, when DTLS is enabled, the OTK
MAY be sent unencrypted as transport layer security is providing confidentiality and integrity protection.
When a 128-bit OTK is sent unencrypted, the OTK Wrapping ID is set to NULL_KEY_WRAP_128, and the OTK Preamble is set to 0x0000000000000000 (64 bits).
Upon receiving a Protected Map-Request, the Map-Resolver decapsulates the ECM. The ITR-OTK, if encrypted, is decrypted as specified in
Section 6.5.
Protecting the confidentiality of the ITR-OTK and, in general, the security of how the Map-Request is handed by the Map-Resolver to the Map-Server is specific to the particular Mapping System used and is outside of the scope of this memo.
In Mapping Systems where the Map-Server is compliant with [
RFC 9301], the Map-Resolver originates a new ECM header with the S-bit set, which contains the unencrypted ITR-OTK, as specified in
Section 6.5, and the other data derived from the ECM Authentication Data of the received Encapsulated Map-Request.
The Map-Resolver then forwards to the Map-Server the received Map-Request, which is encapsulated in the new ECM header that includes the newly computed 'Authentication Data' fields.
Upon receiving a Protected Map-Request, the Map-Server processes it according to the setting of the S-bit and the P-bit in the Map-Register received from the ETRs authoritative for that prefix, as described below.
While processing the Map-Request, the Map-Server can overwrite the 'KDF ID' field if it does not support the KDF ID recommended by the ITR. Processing of the Map-Request
MUST proceed in the order described in the table below, applying the process corresponding to the first rule that matches the conditions indicated in the first column:
Matching Condition |
Processing |
1. At least one of the ETRs authoritative for the EID-Prefix included in the Map-Request registered with the P-bit set to 1
|
The Map-Server MUST generate a LISP-SEC-protected Map-Reply, as specified in Section 6.7.2. The ETR-Cant-Sign E-bit in the EID Authentication Data (EID-AD) MUST be set to 0.
|
2. At least one of the ETRs authoritative for the EID-Prefix included in the Map-Request registered with the S-bit set to 1
|
The Map-Server MUST generate a LISP-SEC-protected Encapsulated Map-Request (as specified in Section 6.7.1) to be sent to one of the authoritative ETRs that registered with the S-bit set to 1 (and the P-bit set to 0). If there is at least one ETR that registered with the S-bit set to 0, the ETR-Cant-Sign E-bit of the EID-AD MUST be set to 1 to signal the ITR that a non-LISP-SEC Map-Request might reach additional ETRs that have LISP-SEC disabled.
|
3. All the ETRs authoritative for the EID-Prefix included in the Map-Request registered with the S-bit set to 0
|
The Map-Server MUST send a Negative Map-Reply protected with LISP-SEC, as described in Section 6.7.2. The ETR-Cant-Sign E-bit MUST be set to 1 to signal the ITR that a non-LISP-SEC Map-Request might reach additional ETRs that have LISP-SEC disabled.
|
Table 1: Map-Request Processing
In this way, the ITR that sent a LISP-SEC-protected Map-Request always receives a LISP-SEC-protected Map-Reply. However, the ETR-Cant-Sign E-bit set to 1 specifies that a non-LISP-SEC Map-Request might reach additional ETRs that have LISP-SEC disabled. This mechanism allows the ITR to downgrade to non-LISP-SEC requests, which does not protect against threats described in
Section 4.
The Map-Server decapsulates the ECM and generates new ECM Authentication Data. The Authentication Data includes the OTK-AD and the EID-AD, which contains EID-Prefix authorization information that are eventually received by the requesting ITR.
The Map-Server updates the OTK-AD by deriving a new OTK (MS-OTK) from the ITR-OTK received with the Map-Request. MS-OTK is derived by applying the Key Derivation Function specified in the 'KDF ID' field. If the algorithm specified in the 'KDF ID' field is not supported, the Map-Server uses a different algorithm to derive the key and updates the 'KDF ID' field accordingly.
The Map-Request
MUST be encapsulated in an ECM, with the S-bit set to 1, to indicate the presence of Authentication Data.
MS-OTK is wrapped with the algorithm specified by the 'OTK Wrapping ID' field. See
Section 6.5 for further details on OTK encryption. If the NULL-KEY-WRAP-128 algorithm is selected and DTLS is not enabled in the path between the Map-Server and the ETR, the Map-Request
MUST be dropped and an appropriate log action
SHOULD be taken.
In the EID-AD, the Map-Server includes in the EID-AD the longest-match-registered EID-Prefix for the destination EID and an HMAC of this EID-Prefix. The HMAC is keyed with the ITR-OTK contained in the received ECM Authentication Data, and the HMAC algorithm is chosen according to the 'Requested HMAC ID' field. If the Map-Server does not support this algorithm, the Map-Server uses a different algorithm and specifies it in the 'EID HMAC ID' field. The scope of the HMAC operation
MUST cover the entire EID-AD, from the 'EID-AD Length' field to the 'EID HMAC' field, which
MUST be set to 0 before the computation.
The Map-Server then forwards the updated ECM-Encapsulated Map-Request, which contains the OTK-AD, the EID-AD, and the received Map-Request to an authoritative ETR as specified in [
RFC 9301].
A LISP-SEC proxy Map-Reply is generated according to [
RFC 9301], with the Map-Reply S-bit set to 1. The Map-Reply includes the Authentication Data that contains the EID-AD computed as specified in
Section 6.7.1, as well as the PKT-AD computed as specified in
Section 6.8.
Upon receiving an ECM-Encapsulated Map-Request with the S-bit set, the ETR decapsulates the ECM. The 'OTK' field, if encrypted, is decrypted as specified in
Section 6.5 to obtain the unencrypted MS-OTK.
The ETR then generates a Map-Reply as specified in [
RFC 9301] and includes the Authentication Data that contains the EID-AD, as received in the Encapsulated Map-Request, as well as the PKT-AD.
The EID-AD is copied from the Authentication Data of the received Encapsulated Map-Request.
The PKT-AD contains the HMAC of the whole Map-Reply packet, keyed with the MS-OTK and computed using the HMAC algorithm specified in the 'Requested HMAC ID' field of the received Encapsulated Map-Request. If the ETR does not support the Requested HMAC ID, it uses a different algorithm and updates the 'PKT HMAC ID' field accordingly. The HMAC operation
MUST cover the entire Map-Reply, where the 'PKT HMAC' field
MUST be set to 0 before the computation.
Finally, the ETR sends the Map-Reply to the requesting ITR as specified in [
RFC 9301].
In response to a Protected Map-Request, an ITR expects a Map-Reply with the S-bit set to 1, including an EID-AD and a PKT-AD. The ITR
MUST discard the Map-Reply otherwise.
Upon receiving a Map-Reply, the ITR must verify the integrity of both the EID-AD and the PKT-AD and
MUST discard the Map-Reply if one of the integrity checks fails. After processing the Map-Reply, the ITR
MUST discard the <nonce,ITR-OTK> pair associated to the Map-Reply.
The integrity of the EID-AD is verified using the ITR-OTK (stored locally for the duration of this exchange) to recompute the HMAC of the EID-AD using the algorithm specified in the 'EID HMAC ID' field. If the ITR did indicate a Requested HMAC ID in the Map-Request and the PKT HAMC ID in the corresponding Map-Reply is different, or if the ITR did not indicate a Requested HMAC ID in the Map-Request and the PKT HMAC ID in the corresponding Map-Reply is not supported, then the ITR
MUST discard the Map-Reply and send, according to rate-limitation policies defined in [
RFC 9301], a new Map-Request with a different 'Requested HMAC ID' field, according to ITR's local policy. The scope of the HMAC operation covers the entire EID-AD, from the 'EID-AD Length' field to the 'EID HMAC' field.
ITR
MUST set the 'EID HMAC ID' field to 0 before computing the HMAC.
To verify the integrity of the PKT-AD, first the MS-OTK is derived from the locally stored ITR-OTK using the algorithm specified in the 'KDF ID' field. This is because the PKT-AD is generated by the ETR using the MS-OTK. If the ITR did indicate a recommended KDF ID in the Map-Request and the KDF ID in the corresponding Map-Reply is different or if the ITR did not indicate a recommended KDF ID in the Map-Request and the KDF ID in the corresponding Map-Reply is not supported, then the ITR
MUST discard the Map-Reply and send, according to rate-limitation policies defined in [
RFC 9301], a new Map-Request with a different KDF ID, according to ITR's local policy. The Key Derivation Function HKDF-SHA256
MUST be supported in LISP-SEC implementations. LISP-SEC deployments
SHOULD use the HKDF-SHA256 HKDF function, unless older implementations using HKDF-SHA1-128 are present in the same deployment. Without consistent configuration of involved entities, extra delays may be experienced. However, since HKDF-SHA1-128 and HKDF-SHA256 are supported, the process will eventually converge.
The derived MS-OTK is then used to recompute the HMAC of the PKT-AD using the algorithm specified in the 'PKT HMAC ID' field. If the 'PKT HMAC ID' field does not match the Requested HMAC ID, the ITR
MUST discard the Map-Reply and send, according to rate-limitation policies defined in [
RFC 9301], a new Map-Request with a different Requested HMAC ID, according to ITR's local policy or until all HMAC IDs supported by the ITR have been attempted. When the 'PKT HMAC ID' field does not match the Requested HMAC ID, it is not possible to validate the Map-Reply.
Each individual Map-Reply EID-Record is considered valid only if: (1) both EID-AD and PKT-AD are valid and (2) the intersection of the EID-Prefix in the Map-Reply EID-Record with one of the EID-Prefixes contained in the EID-AD is not empty. After identifying the Map-Reply record as valid, the ITR sets the EID-Prefix in the Map-Reply record to the value of the intersection set computed before and adds the Map-Reply EID-Record to its EID-to-RLOC Map-Cache, as described in [
RFC 9301]. An example of Map-Reply record validation is provided in
Section 6.9.1.
[
RFC 9301] allows ETRs to send Solicit-Map-Requests (SMRs) directly to the ITR. The corresponding SMR-invoked Map-Request will be sent through the Mapping System, hence, secured with the specifications of this memo if in use. If an ITR accepts Map-Replies piggybacked in Map-Requests and its content is not already present in its EID-to-RLOC Map-Cache, it
MUST send a Map-Request over the Mapping System in order to verify its content with a secured Map-Reply before using the content.
The payload of a Map-Reply may contain multiple EID-Records. The whole Map-Reply is signed by the ETR, with the PKT HMAC, to provide integrity protection and origin authentication to the EID-Prefix records claimed by the ETR. The 'Authentication Data' field of a Map-Reply may contain multiple EID-Records in the EID-AD. The EID-AD is signed by the Map-Server, with the EID HMAC, to provide integrity protection and origin authentication to the EID-Prefix records inserted by the Map-Server.
Upon receiving a Map-Reply with the S-bit set, the ITR first checks the validity of both the EID HMAC and of the PKT-AD HMAC. If either one of the HMACs is not valid, a log action
SHOULD be taken and the Map-Reply
MUST NOT be processed any further. Implementations may include mechanisms (which are beyond the scope of this document) to avoid log resource exhaustion attacks. If both HMACs are valid, the ITR proceeds with validating each individual EID-Record claimed by the ETR by computing the intersection of each one of the EID-Prefixes contained in the payload of the Map-Reply, with each one of the EID-Prefixes contained in the EID-AD. An EID-Record is valid only if at least one of the intersections is not the empty set; otherwise, a log action
MUST be taken and the EID-Record
MUST be discarded. Implementations may include mechanisms (which are beyond the scope of this document) to avoid log resource exhaustion attacks.
For instance, the Map-Reply payload contains 3 mapping record EID-Prefixes:
-
2001:db8:102::/48
-
2001:db8:103::/48
-
2001:db8:200::/40
The EID-AD contains two EID-Prefixes:
-
2001:db8:103::/48
-
2001:db8:203::/48
The EID-Record with EID-Prefix 2001:db8:102::/48 is not eligible to be used by the ITR, since it is not included in any of the EID-ADs signed by the Map-Server. A log action
MUST be taken, and the EID-Record
MUST be discarded. Implementations may include mechanisms (which are beyond the scope of this document) to avoid log resource exhaustion attacks.
The EID-Record with EID-Prefix 2001:db8:103::/48 is eligible to be used by the ITR because it matches the second EID-Prefix contained in the EID-AD.
The EID-Record with EID-Prefix 2001:db8:200::/40 is not eligible to be used by the ITR, since it is not included in any of the EID-ADs signed by the Map-Server. A log action
MUST be taken and the EID-Record
MUST be discarded. Implementations may include mechanisms (which are beyond the scope of this document) to avoid log resource exhaustion attacks. In this last example, the ETR is trying to over claim the EID-Prefix 2001:db8:200::/40, but the Map-Server authorized only 2001:db8:203::/48; hence, the EID-Record is discarded.