[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]
Versions: 00 01 02 03 04 05 06 07 08 09 10 11
RFC 4430
INTERNET-DRAFT Shoichi Sakane
KINK Working Group Ken'ichi Kamada
Expires: January 19, 2006 Yokogawa Electric Corp.
Michael Thomas
Jan Vilhuber
Cisco Systems
July 18, 2005
Kerberized Internet Negotiation of Keys (KINK)
draft-ietf-kink-kink-09.txt
Status of this Memo
By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress".
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html
This document is a submission by the KINK Working Group of the
Internet Engineering Task Force (IETF). Comments should be submitted
to the KINK mailing list (ietf-kink@vpnc.org). You can subscribe by
sending mail to ietf-kink-request@vpnc.org with a line in the body of
the mail with the word SUBSCRIBE in it.
Distribution of this memo is unlimited.
This Internet-Draft expires in January 19, 2006.
Sakane, Kamada, Thomas, and Vilhuber [Page 1]
^L
Internet-Draft KINK July 2005
Copyright Notice
Copyright (C) The Internet Society (2005). All Rights Reserved.
Abstract
This document describes the Kerberized Internet Negotiation of Keys
(KINK) protocol. KINK defines a low-latency, computationally
inexpensive, easily managed, and cryptographically sound protocol to
establish and maintain security associations using the Kerberos
authentication system. KINK reuses the Quick Mode payloads of the
Internet Key Exchange (IKE), which should lead to substantial reuse
of existing IKE implementations.
Conventions used in this document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119.
It is assumed that the readers are familiar with the terms and
concepts described in Kerberos Version 5 [KERBEROS], IPsec [IPSEC],
and IKE [IKE].
Sakane, Kamada, Thomas, and Vilhuber [Page 2]
^L
Internet-Draft KINK July 2005
Table of Contents
1. Introduction ................................................. 5
2. Protocol Overview ............................................ 6
3. Message Flows ................................................ 6
3.1. GETTGT Message Flow ..................................... 7
3.2. CREATE Message Flow ..................................... 7
3.2.1. CREATE Key Derivation Considerations ............. 9
3.3. DELETE Message Flow ..................................... 10
3.4. STATUS Message Flow ..................................... 11
3.5. Reporting Errors ........................................ 11
3.6. Rekeying Security Associations .......................... 12
3.7. Dead Peer Detection ..................................... 12
3.7.1. Coping with Dead User-to-User Peers .............. 14
4. KINK Message Format .......................................... 14
4.1. KINK Alignment Rules .................................... 17
4.2. KINK Payloads ........................................... 17
4.2.1. KINK_AP_REQ Payload .............................. 18
4.2.2. KINK_AP_REP Payload .............................. 19
4.2.3. KINK_KRB_ERROR Payload ........................... 20
4.2.4. KINK_TGT_REQ Payload ............................. 21
4.2.5. KINK_TGT_REP Payload ............................. 22
4.2.6. KINK_ISAKMP Payload .............................. 22
4.2.7. KINK_ENCRYPT Payload ............................. 24
4.2.8. KINK_ERROR Payload ............................... 25
5. Differences from IKE Quick Mode .............................. 26
5.1. Security Association Payloads ........................... 27
5.2. Proposal and Transform Payloads ......................... 27
5.3. Identification Payloads ................................. 27
5.4. Nonce Payloads .......................................... 27
5.5. Notify Payloads ......................................... 28
5.6. Delete Payloads ......................................... 29
5.7. KE Payloads ............................................. 29
6. Message Construction and Constraints for IPsec DOI ........... 29
6.1. REPLY Message ........................................... 29
6.2. ACK Message ............................................. 29
6.3. CREATE Message .......................................... 30
6.4. DELETE Message .......................................... 31
6.5. STATUS Message .......................................... 32
6.6. GETTGT Message .......................................... 33
7. ISAKMP Key Derivation ........................................ 33
8. Key Usage Numbers for Kerberos Key Derivation ................ 34
9. Transport Considerations ..................................... 34
10. Implementation Hints ......................................... 35
11. Security Considerations ...................................... 35
12. IANA Considerations .......................................... 36
13. Forward Compatibility Considerations ......................... 36
13.1. New Versions of Quick Mode ............................. 37
Sakane, Kamada, Thomas, and Vilhuber [Page 3]
^L
Internet-Draft KINK July 2005
13.2. New DOI ................................................ 37
14. Related Work ................................................. 37
15. Acknowledgments .............................................. 38
16. References ................................................... 38
16.1. Normative References ................................... 38
16.2. Informative References ................................. 39
Authors' Addresses ............................................... 39
Change History (To be removed from RFC) .......................... 40
Full Copyright Statement ......................................... 40
Intellectual Property Statement .................................. 40
Sakane, Kamada, Thomas, and Vilhuber [Page 4]
^L
Internet-Draft KINK July 2005
1. Introduction
KINK is designed to provide a secure, scalable mechanism for
establishing keys between communicating entities within a centrally
managed environment in which it is important to maintain consistent
security policy. The security goals of KINK are to provide privacy,
authentication, and replay protection of key management messages, and
to avoid denial of service vulnerabilities whenever possible. The
performance goals of the protocol are to have a low computational
cost, low latency, and a small footprint. It is also to avoid or
minimize the use of public key operations. In particular, the
protocol provides the capability to establish IPsec security
associations (SA) in two messages with minimal computational effort.
These requirements are described in RFC 3129 [REQ4KINK].
Kerberos [KERBEROS] provides an efficient authentication mechanism
for clients and servers using a trusted third-party model. Kerberos
also provides a mechanism for cross-realm authentication natively. A
client obtains a ticket from an online authentication server, the Key
Distribution Center (KDC). The ticket is then used to construct a
credential for authenticating the client to the server. As a result
of this authentication operation, the server will also share a secret
key with the client. KINK uses this property as the basis of
distributing keys for IPsec.
The central key management provided by Kerberos is efficient because
it limits computational cost and limits complexity versus IKE's [IKE]
necessity of using public key cryptography. Initial authentication
to the KDC may be performed using either symmetric keys, or
asymmetric keys using PKINIT [PKINIT]; however, subsequent requests
for tickets as well as authenticated exchanges between the client and
servers always utilize symmetric cryptography. Therefore, public key
operations (if any) are limited and are amortized over the lifetime
of the initial authentication operation to the KDC. For example, a
client may use a single public key exchange with the KDC to
efficiently establish multiple SAs with many other servers in the
realm of the KDC. Kerberos also scales better than direct peer to
peer keying when symmetric keys are used. The reason is that since
the keys are stored in the KDC, the number of principal keys is O(n)
rather than O(n*m), where "n" is the number of clients and "m" is the
number of servers. Kerberos, like any internet protocol, does have
its own security considerations. You can find them discussed in
[KERBEROS].
Sakane, Kamada, Thomas, and Vilhuber [Page 5]
^L
Internet-Draft KINK July 2005
2. Protocol Overview
KINK is a command/response protocol which can create, delete, and
maintain IPsec SAs. Each command or response contains a common
header along with a set of type-length-value payloads. The type of a
command or a response constrains the payloads sent in the messages of
the exchange. KINK itself is a stateless protocol in that each
command or response does not require storage of hard state for KINK.
This is in contrast to IKE, which uses Main Mode to first establish
an ISAKMP SA followed by subsequent Quick Mode exchanges.
KINK uses Kerberos mechanisms to provide mutual authentication and
replay protection. For establishing SAs, KINK provides
confidentiality for the payloads which follow the Kerberos AP-REQ
payload. The design of KINK mitigates denial of service attacks by
requiring authenticated exchanges before the use of any public key
operations and the installation of any state. KINK also provides a
means of using Kerberos User-to-User mechanisms when there is not a
key shared between the server and the KDC. This is typically, but
not limited to, the case with IPsec peers using PKINIT for initial
authentication.
KINK directly reuses Quick Mode payloads defined in the section 5.5
of [IKE], with some minor changes and omissions. In most cases, KINK
exchanges are a single command and its response. An optional third
message is required when creating SAs, only if the responder rejects
the first proposal from the initiator or wants to contribute the
keying materials. KINK also provides rekeying and dead peer
detection.
3. Message Flows
All KINK message flows follow the same pattern between the two peers:
a command, a response, and an optional acknowledgment in a CREATE
flow. A command is a GETTGT, CREATE, DELETE, or STATUS message, a
response is a REPLY message, and an acknowledgment is an ACK message.
KINK uses Kerberos as the authentication mechanism, therefore a KINK
host needs to get a service ticket for each peer before actual key
negotiations. This is basically a pure Kerberos exchange and the
actual KDC traffic here is for illustrative purposes only. In
practice, when a principal obtains various tickets is a subject of
Kerberos and local policy consideration. As an exception, the GETTGT
message flow of KINK (described in the section 3.1) is used when a
User-to-User authentication is required. In this flow, we assume
that both A and B have TGTs from their KDCs.
Sakane, Kamada, Thomas, and Vilhuber [Page 6]
^L
Internet-Draft KINK July 2005
After a service ticket is obtained, KINK uses the CREATE message flow
(section 3.2), DELETE message flow (section 3.3), and STATUS message
flow (section 3.4) to manage SAs. In these flows, we assume that A
has a service ticket for B.
3.1. GETTGT Message Flow
This flow is used to retrieve a TGT from the remote peer in User-to-
User authentication mode.
If the initiator determines that it will not be able to get a normal
(non-User-to-User) service ticket for the responder, it can try a
User-to-User authentcation. In this case, it first fetches a TGT
from the responder in order to get a User-to-User service ticket:
A B KDC
------ ------ ---
1 GETTGT+KINK_TGT_REQ------>
2 <-------REPLY+KINK_TGT_REP
3 TGS-REQ+TGT(B)------------------------------------>
4 <-------------------------------------------TGS-REP
Figure 1: GETTGT Message Flow
The initiator MAY support the following events as triggers to go to
the User-to-User path. Note that the two errors described below will
not be authenticated, and how to act on them depends on the policy.
o The local policy says that the responder requires a User-to-User
authentication.
o A KRB_AP_ERR_USER_TO_USER_REQUIRED error is returned from the
responder.
o A KDC_ERR_MUST_USE_USER2USER error is returned from the KDC.
3.2. CREATE Message Flow
This flow creates SAs. The CREATE command takes an "optimistic"
approach, where SAs are initially created on the expectation that the
responder will choose the initial proposed payload. The optimistic
proposal is placed in the first transform payload(s) of the first
proposal. The initiator MUST check to see if the optimistic proposal
Sakane, Kamada, Thomas, and Vilhuber [Page 7]
^L
Internet-Draft KINK July 2005
was selected by comparing all transforms and attributes which MUST be
identical from those in the initiator's optimistic proposal with the
exceptions of LIFE_KILOBYTES and LIFE_SECONDS. Each of these
attributes MAY be set to a lower value by the responder and still
expect optimistic keying, but MUST NOT be set to a higher value which
MUST generate a NO-PROPOSAL-CHOSEN error. The initiator MUST use the
shorter lifetime.
When a CREATE command contains an existing SPI, the responder MUST
reject it and SHOULD reply an ISAKMP notification with INVALID-SPI.
When a KE payload is sent from the initiator but the responder does
not support it, the responder MUST reject it with an ISAKMP
notification of INVALID-PAYLOAD-TYPE containing a KE payload type as
its notification data. When the initiator receives this error, it
MAY retry without a KE payload (as another transaction) if its policy
allows that.
A B KDC
------ ------ ---
A creates an optimistic inbound SA (B->A) unless using a KE.
1 CREATE+ISAKMP------------>
B creates an inbound SA (A->B).
B creates an outbound SA (B->A) if optimistic and not using a KE.
2 <-------------REPLY+ISAKMP
A creates an outbound SA (A->B).
A replaces an inbound SA (B->A) if non-optimistic.
A creates an inbound SA (B->A) if using a KE.
3 [ ACK---------------------> ]
[ B creates an outbound SA (B->A). ]
Figure 2: CREATE Message Flow
Creating SAs has two modes: 2-way handshake and 3-way handshake. The
initiator usually begins a negotiation expecting a 2-way handshake.
When the optimistic proposal is not chosen by the responder, the
negotiation is switched to a 3-way handshake. When and only when the
initiator uses a KE payload, 3-way handshake is expected from the
beginning.
A 2-way handshake is performed in the following steps:
Sakane, Kamada, Thomas, and Vilhuber [Page 8]
^L
Internet-Draft KINK July 2005
1) The host A creates an inbound SA (B->A) in its SA database using
the optimistic proposal in the ISAKMP SA proposal. It is then
ready to receive any messages from B.
2) A then sends the CREATE message to B.
3) If B agrees to A's optimistic proposal, B creates an inbound SA
(A->B) and an outbound SA (B->A) in its database. If B does not
choose the first proposal or wants to add a nonce payload, switch
to the step 3) of a 3-way handshake described below.
4) B then sends a REPLY to A without a NONCE payload and without
requesting an ACK.
5) Upon receipt of the REPLY, A creates an outbound SA (A->B).
A 3-way handshake is performed in the following steps:
1) The host A sends the CREATE message to B without creating any SA.
2) B chooses one proposal according to its policy.
3) B creates an inbound SA (A->B) and sends the actual choice in the
REPLY. It SHOULD send the optional NONCE payload (as it does not
increase message count and generally increases entropy sources)
and MUST request that the REPLY be acknowledged.
4) Upon receipt of the REPLY, A creates the inbound SA (B->A) (or
modifies it as necessary, if switched from 2-way), and the
outbound SA (A->B).
5) A now sends the ACK message.
6) Upon receipt of the ACK, B installs the final outbound SA (B->A).
If B does not choose the first proposal, adds a nonce, or accepts the
KE exchange, then it MUST request an ACK (i.e. set the ACKREQ bit) so
that it can install the final outbound SA. The initiator MUST always
generate an ACK if the ACKREQ bit is set in the KINK header, even if
it believes that the responder was in error.
3.2.1. CREATE Key Derivation Considerations
The CREATE command's optimistic approach allows an SA to be created
in two messages rather than three. The implication of a two-message
exchange is that B will not contribute to the key since A must set up
the inbound SA before it receives any additional keying material from
B. This may be suspect under normal circumstances, however KINK
takes advantage of the fact that the KDC provides a reliable source
of randomness which is used in key derivation. In many cases, this
will provide an adequate session key so that B will not require an
acknowledgment. Since B is always at liberty to contribute to the
keying material, this is strictly a tradeoff between the key strength
versus the number of messages, which KINK implementations may decide
as a matter of policy.
Sakane, Kamada, Thomas, and Vilhuber [Page 9]
^L
Internet-Draft KINK July 2005
3.3. DELETE Message Flow
The DELETE command deletes existing SAs. The DOI specific payloads
describe the actual SA to be deleted. For the IPSEC DOI, those
payloads will include an ISAKMP payload containing the list of the
SPIs to be deleted.
A B KDC
------ ------ ---
A deletes outbound SA to B.
1 DELETE+ISAKMP------------>
B deletes inbound and outbound SA to A.
2 <-------------REPLY+ISAKMP
A deletes inbound SA to B.
Figure 3: DELETE Message Flow
The DELETE command takes a "pessimistic" approach, which does not
delete inbound SAs until it receives acknowledgment that the other
host has received the DELETE. The exception to the pessimistic
approach is if the initiator wants to immediately cease all activity
on an inbound SA. In this case, it MAY delete the inbound SA as well
in step one.
The ISAKMP payload contains ISAKMP Delete payload(s) which indicates
the inbound SA(s) for the initiator of this flow. KINK does not
allow half-open SAs, thus when the responder receives a DELETE
command, it MUST delete SAs of both directions, and MUST reply with
ISAKMP Delete Payload(s) which indicates the inbound SA(s) for the
responder of this flow. If the responder cannot find an appropriate
SPI to be deleted, it MUST return an ISAKMP notification with
INVALID_SPI, which also serves to inform the initiator that it can
delete the inbound SA.
A race condition with the DELETE flow exists. Due to network
reordering, etc, packets in flight while the DELETE operation is
taking place may arrive after the diagrams above, which recommend
deleting the inbound SA. A KINK implementation SHOULD implement a
grace timer which SHOULD be set to a period of at least two times the
average round trip time, or to a configurable value. A KINK
implementation MAY choose to set the grace period to zero at
appropriate times to delete an SA ungracefully. The behavior
described here is referred from the behavior of the TCP [RFC793]
Sakane, Kamada, Thomas, and Vilhuber [Page 10]
^L
Internet-Draft KINK July 2005
flags FIN and RST.
3.4. STATUS Message Flow
This flow is used to send any information to a peer, or to elicit any
information from a peer. An initiator may send a STATUS command to
the responder at any time, optionally with DOI specific ISAKMP
payloads. In the case of the IPsec DOI, these are generally in the
form of ISAKMP Notification Payloads. A STATUS command is also used
as a means of Dead Peer Detection described in the section 3.7.
A B KDC
------ ------ ---
1 STATUS[+ISAKMP]---------->
2 <-----------REPLY[+ISAKMP]
Figure 4: STATUS Message Flow
3.5. Reporting Errors
When the responder detects an error in a received command, it can
send a DOI specific payload to indicate the error in a REPLY message.
There are three types of payloads which can indicate errors:
KINK_KRB_ERROR payloads for Kerberos errors, KINK_ERROR payloads for
KINK errors, and KINK_ISAKMP payloads for ISAKMP errors. Details are
described in the each part of this document.
If the initiator detects an error in a received replay, there is no
means to report it back to the responder. The initiator SHOULD log
the event and MAY take a remedial action by reinitiating the initial
command.
If the server clock and the client clock are off by more than the
policy-determined clock skew limit (usually 5 minutes), the server
MUST return a KRB_AP_ERR_SKEW. The optional client's time in the
KRB-ERROR MUST be filled out, and the client SHOULD compute the
difference (in seconds) between the two clocks based upon the client
and server time contained in the KRB-ERROR message. The client
SHOULD store this clock difference and use it to adjust its clock in
subsequent messages.
Sakane, Kamada, Thomas, and Vilhuber [Page 11]
^L
Internet-Draft KINK July 2005
3.6. Rekeying Security Associations
KINK requires the initiator of an SA to be responsible for rekeying
an SA. The reason is twofold: the first is to prevent needless
duplication of SAs as the result of collisions due to an initiator
and responder both trying to renew an existing SA. The second reason
is due to the client/server nature of Kerberos exchanges which
expects the client to get and maintain tickets. While KINK requires
that a KINK host is able to get and maintain tickets, in practice it
is often advantageous for servers to wait for clients to initiate
sessions so that they do not need to maintain a large ticket cache.
There are no special semantics for rekeying SAs in KINK. That is, in
order to rekey an existing SA, the initiator must CREATE a new SA
followed by either deleting the old SA with the DELETE flow or
letting it timeout. When identical flow selectors are available on
different SAs, KINK implementations SHOULD choose the SA most
recently created. It should be noted that KINK avoids most of the
problems of [IKE] rekeying by having a reliable delete mechanism.
Normally a KINK implementation which rekeys existing SAs will try to
rekey the SA ahead of an SA termination, which may include the hard
lifetime in time/bytecount or the overflow of the sequence number
counter. We call this time "soft lifetime". The soft lifetime MUST
be randomized to avoid synchronization with similar implementations.
In the case of the lifetime in time, one reasonable approach to
determine the soft lifetime is that picking a random time between T-
rekey and T-retrans and subtracting it from the hard lifetime. Here,
T-rekey is the reasonable maximum rekeying margin, and T-retrans is
the amount of time it would take to go through a full retransmission
cycle. T-rekey SHOULD be at least twice as high as T-retrans.
3.7. Dead Peer Detection
In order to determine that a KINK peer has lost its security database
information, KINK peers MUST record the current epoch for which they
have valid SA information for a peer and reflect that epoch in each
AP-REQ and AP-REP message. When a KINK peer creates state for a
given SA, it MUST also record the principal's epoch as well. If it
discovers on a subsequent message that the principal's epoch has
changed, it MUST consider all SAs created by that principal as
invalid, and take some action such as tearing those SAs down.
While a KINK peer SHOULD use feedback from routing (in the form of
ICMP messages) as a trigger to check whether the peer is still alive
or not, a KINK peer MUST NOT conclude the peers is dead simply based
on unprotected routing information (said ICMP messages).
Sakane, Kamada, Thomas, and Vilhuber [Page 12]
^L
Internet-Draft KINK July 2005
If there is suspicion that a peer may be dead (based on any
information available to the KINK peer, including lack of IPsec
traffic, etc), the KINK STATUS message SHOULD be used to coerce an
acknowledgment out of the peer. Since nothing is negotiated about
dead peer detection in KINK, each peer can decide its own metric for
"suspicion" and also what time-outs to use before declaring a peer
dead due to lack of response to the STATUS message. This is
desirable, and does not break interoperability.
The STATUS message has a twofold effect: First, it elicits a
cryptographically secured (and replay-protected) response from the
peer, which tells us whether the peer is reachable/alive or not.
Second, it carries the epoch number of the peer, so we know whether
the peer has rebooted and lost all state or not. This is crucial to
the KINK protocol: In IKE, if a peer reboots, we lose all
cryptographic context, and no cryptographically secure communication
is possible without renegotiating keys. In KINK, due to Kerberos
tickets, we can communicate securely with a peer, even if the peer
rebooted, as the shared cryptographic key used is carried in the
Kerberos ticket. Thus, active cryptographic communication is not an
indication that the peer has not rebooted and lost all state, and the
epoch is needed.
Assume a Peer A sending a STATUS and a peer B sending the REPLY (see
section 3.4). Peer B MAY assume that the sender is alive, and the
epoch in the STATUS message will indicate whether the peer A has lost
state or not. Peer B MUST acknowledge the STATUS message with a
REPLY message, as described in the section 3.4.
The REPLY message will indicate to peer A that the peer is alive, and
the epoch in the REPLY will indicate whether peer B has lost its
state or not. If peer A does not receive a REPLY message from peer B
in a suitable timeout, peer A MAY send another STATUS message. It is
up to peer A to decide how aggressively to declare peer B dead. The
level of aggressiveness may depend on many factors such as rapid fail
over versus number of messages sent by nodes with large numbers of
SAs.
Note that peer B MUST NOT make any inferences about a lack of STATUS
message from peer A. Peer B MAY use a STATUS message from peer A as
an indication of A's aliveness, but peer B MUST NOT expect another
STATUS message at any time (i.e. Dead Peer detection is not periodic
keepalives).
Strategies for sending STATUS messages: Peer A may decide to send a
STATUS message only after a prolonged period where no traffic was
sent in either direction over the IPsec SAs with the peer. Once
there is traffic, peer A may want to know if the traffic going into a
Sakane, Kamada, Thomas, and Vilhuber [Page 13]
^L
Internet-Draft KINK July 2005
black hole, and send a STATUS message. Alternatively, peer A may use
an idle timer to detect lack of traffic with the peer, and send
STATUS messages in the quiet phase to make sure the peer is still
alive for when traffic needs to finally be sent.
3.7.1. Coping with Dead User-to-User Peers
When an initiator uses a User-to-User ticket and a responder has lost
its previous TGT, the usual DPD mechanism does not work, because the
responder cannot decrypt the ticket with its new TGT. In this case,
the following actions are taken.
o When the responder receives a KINK command with a User-to-User
ticket which cannot be decrypted with its TGT, it returns a REPLY
with a KINK_TGT_REP payload containing the TGT.
o When the initiator receives a KINK_TGT_REP, it retrieves a new
service ticket with the TGT and retries the command.
This does not directly define a method to detect a dead User-to-User
peer, but to recover from the situation that the responder does not
have an appropriate TGT to decrypt a service ticket sent from the
initiator. After recovery, they can exchange their epochs, and usual
DPD mechanism will detect a dead peer if it really has been dead.
The initiator MUST NOT think the peer has been dead on the receipt of
a KINK_TGT_REP because of two reasons. One is that the message is
not authenticated, and the other is that losing a TGT does not
necessarily mean losing the SA database information. The initiator
SHOULD NOT forget the previous service ticket until the new one is
successfully obtained in order to reduce the cost when a forged
KINK_TGT_REP is received.
4. KINK Message Format
All values in KINK are formatted in network byte order (Most
Significant Byte first). The RESERVED fields MUST be set to zero (0)
when a packet is sent. The receiver MUST ignore these fields.
Sakane, Kamada, Thomas, and Vilhuber [Page 14]
^L
Internet-Draft KINK July 2005
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type | MjVer |RESRVED| Length |
+---------------+---------------+---------------+---------------+
| Domain of Interpretation (DOI) |
+-------------------------------+-------------------------------+
| Transaction ID (XID) |
+---------------+-+-------------+-------------------------------+
| NextPayload |A| RESERVED2 | CksumLen |
+---------------+-+-------------+-------------------------------+
| |
~ A series of payloads ~
| |
+-------------------------------+-------------------------------+
| |
~ Cksum (variable) ~
| |
+-------------------------------+-------------------------------+
Figure 5: Format of a KINK message
Fields:
o Type (1 octet) -- The type of this message.
Type Value
----- -----
RESERVED 0
CREATE 1
DELETE 2
REPLY 3
GETTGT 4
ACK 5
STATUS 6
RESERVED TO IANA 7 - 127
Private Use 128 - 255
o MjVer (4 bits) -- Major protocol version number. This MUST be set
to 1.
o RESRVED (4 bits) -- Reserved and MUST be zero when sent, MUST be
ignored when received.
o Length (2 octets) -- Length of the message in octets. It is not
forbidden in KINK that there are unnecessary data after the Cksum
field, but the Length field MUST represent the actual length of
the message.
Sakane, Kamada, Thomas, and Vilhuber [Page 15]
^L
Internet-Draft KINK July 2005
o DOI (4 octets) -- The domain of interpretation. All DOIs must be
registered with the IANA in the ISAKMP Domain of Interpretation
section of the isakmp-registry [ISAKMP-REG]. The IANA Assigned
Number for the Internet IP Security DOI [IPDOI] is one (1). This
field defines the context of all sub-payloads in this message. If
sub-payloads have a DOI field (e.g. Security Association Payload),
then the DOI in that sub-payload MUST be checked against the DOI
in this header, and the values MUST be the same.
o XID (4 octets) -- The transaction ID. A KINK transaction is bound
together by a transaction ID, which is created by the command
initiator and replicated in subsequent messages in the
transaction. A transaction is defined as a command, a reply, and
an optional acknowledgment. Transaction IDs are used by the
initiator to discriminate between multiple outstanding requests to
a responder. It is not used for replay protection because that
functionality is provided by Kerberos. The value of XID is chosen
by the initiator and MUST be unique with all outstanding
transactions. XIDs MAY be constructed by using a monotonic
counter, or random number generator.
o NextPayload (1 octet) -- Indicates the type of the first payload
after the message header.
o A, or ACKREQ (1 bit) -- ACK Request. Set to one if the responder
requires an explicit acknowledgment that a REPLY was received. An
initiator MUST NOT set this flag, nor should a responder except
for a REPLY to a CREATE when the optimistic proposal is chosen.
o RESERVED2 (7 bits) -- Reserved and MUST be zero on send, MUST be
ignored by a receiver.
o CksumLen (2 octets) -- CksumLen is the length in octets of the
cryptographic checksum of the message. A CksumLen of zero implies
that the message is unauthenticated.
o Cksum (variable) -- Kerberos keyed checksum over the entire
message excluding the Cksum field itself. When any padding bytes
are required at the end of the last payload, they MUST be included
in the calculation. This field MUST always be present whenever a
key is available via an AP-REQ or AP-REP payload. The key used
MUST be the session key in the ticket. When a key is not
available, this field is not present, and the CksumLen field is
set to zero. The content of this field is the output of the
Kerberos 5 get_mic function [KCRYPTO]. The get_mic function used
is specified by a checksum type, which is a "required checksum
mechanism" of the etype for the Kerberos session key in the
Kerberos ticket. If the checksum type is not a keyed algorithm,
Sakane, Kamada, Thomas, and Vilhuber [Page 16]
^L
Internet-Draft KINK July 2005
the message MUST be rejected.
To compute the checksum, the CksumLen field is zeroed out and the
Length field is filled with the total packet length without the
checksum. Then, the packet is passed to the get_mic function and
its output is appended to the packet. Any KINK padding after the
Cksum field is not allowed, except the Kerberos internal one which
may be included in the output of the get_mic function. Finally,
the CksumLen field is filled with the checksum length and the
Length field is filled with the total packet length including the
checksum.
To verify the checksum, a length-without-checksum is calculated
from the value of Length field, subtracting the CksumLen. The
Length field is filled with the length-without-checksum value and
the CksumLen field is zeroed out. Then, the packet without
checksum (offset from 0 to length-without-checksum minus 1 of the
received packet) and the checksum (offset from length-without-
checksum to the last) are passed to the verify_mic function. If
verification fails, the message MUST be dropped.
The KINK header is followed immediately by a series of
Type/Length/Value fields, defined in the section 4.2.
4.1. KINK Alignment Rules
KINK has the following rules regarding alignment and padding:
o All length fields MUST reflect the actual number of octets in the
structure; i.e., they do not account for padding bytes required by
KINK alignments.
o KINK headers, payloads, and the Cksum field MUST be aligned on
4-octet boundaries.
o Variable length fields (except the Cksum field) MUST always start
immediately after the last octet of the previous field. I.e.,
they are not aligned to 4-octet boundaries.
4.2. KINK Payloads
Immediately following the header, there is a list of
Type/Length/Value (TLV) payloads. There can be any number of
payloads following the header. Each payload MUST begin with a
payload header. Each payload header is built on the generic payload
header. Any data immediately follows the generic header. Payloads
Sakane, Kamada, Thomas, and Vilhuber [Page 17]
^L
Internet-Draft KINK July 2005
are all implicitly aligned to 4-octet boundaries, though the payload
length field MUST accurately reflect the actual number of octets in
the 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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| value (variable) |
+---------------+---------------+---------------+---------------+
Figure 6: Format of a KINK payload
Fields:
o Next Payload (1 octets) -- The type of the next payload.
NextPayload Value
---- -----
KINK_DONE 0
KINK_AP_REQ 1
KINK_AP_REP 2
KINK_KRB_ERROR 3
KINK_TGT_REQ 4
KINK_TGT_REP 5
KINK_ISAKMP 6
KINK_ENCRYPT 7
KINK_ERROR 8
RESERVED TO IANA 9 - 127
Private Use 128 - 255
Next Payload type KINK_DONE denotes that the current payload is
the final payload in the message.
o RESERVED (1 octet) -- Reserved and MUST be set to zero by a
sender, MUST be ignored by a receiver.
o Payload Length (2 octets) -- The length of this payload, including
the type and length fields.
o Value (variable) -- This value of this field depends on the type.
4.2.1. KINK_AP_REQ Payload
The KINK_AP_REQ payload relays a Kerberos AP-REQ to the responder.
The AP-REQ MUST request mutual authentication. The principal name
Sakane, Kamada, Thomas, and Vilhuber [Page 18]
^L
Internet-Draft KINK July 2005
that the KINK service SHOULD use is "kink/fqdn@REALM", where "kink"
is for the KINK IPsec service, "fqdn" is the fully qualified domain
name of the service host, and "REALM" is the Kerberos realm of the
service. A principal name is case sensitive, and "fqdn" part MUST be
lower case as described in [KERBEROS]. This document does not
specify how to generate the principal name; complete principal names
are stored in local policy, hostnames are obtained from some name
services, etc; but see the Security Considerations section.
The value field of this payload has the following format:
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| EPOCH |
+---------------------------------------------------------------+
| |
~ AP-REQ ~
| |
+---------------------------------------------------------------+
Figure 7: KINK_AP_REQ Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o EPOCH -- The absolute time at which the creator of the AP-REQ has
valid SA information. Typically, this is when the KINK keying
daemon started if it does not retain SA information across
different restarts. The value in this field is the least
significant four octets of so-called POSIX time, which is the
elapsed seconds (but without counting leap seconds) from
1970-01-01T00:00:00 UTC. For example, 2038-01-19T03:14:07 UTC is
represented as 0x7fffffff.
o AP-REQ -- The value field of this payload contains a raw Kerberos
AP-REQ.
4.2.2. KINK_AP_REP Payload
The KINK_AP_REP payload relays a Kerberos AP-REP to the initiator.
The AP-REP MUST be checked for freshness as described in [KERBEROS].
Sakane, Kamada, Thomas, and Vilhuber [Page 19]
^L
Internet-Draft KINK July 2005
The value field of this payload has the following format:
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| EPOCH |
+---------------------------------------------------------------+
| |
~ AP-REP ~
| |
+---------------------------------------------------------------+
Figure 8: KINK_AP_REP Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o EPOCH -- The absolute time at which the creator of the AP-REP has
valid SA information. Typically, this is when the KINK keying
daemon started if it does not retain SA information across
different restarts. The value in this field is the least
significant four octets of so-called POSIX time, which is the
elapsed seconds (but without counting leap seconds) from
1970-01-01T00:00:00 UTC. For example, 2038-01-19T03:14:07 UTC is
represented as 0x7fffffff.
o AP-REP -- The value field of this payload contains a raw Kerberos
AP-REP.
4.2.3. KINK_KRB_ERROR Payload
The KINK_KRB_ERROR payload relays Kerberos type errors back to the
initiator. The initiator MUST be prepared to receive any valid
Kerberos error type [KERBEROS].
KINK implementations MUST make use of a KINK Cksum field when
returning KINK_KRB_ERROR and the appropriate service key is
available. In particular, clock skew errors MUST be integrity
protected. For unauthenticated Kerberos errors, the initiator MAY
choose to act on them, but SHOULD take precautions against make-work
kinds of attacks.
Note that KINK does not make use of the text or e_data field of the
Sakane, Kamada, Thomas, and Vilhuber [Page 20]
^L
Internet-Draft KINK July 2005
Kerberos error message, though a compliant KINK implementation MUST
be prepared to receive them and MAY log them.
The value field of this payload has the following format:
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| |
~ KRB-ERROR ~
| |
+---------------------------------------------------------------+
Figure 9: KINK_KRB_ERROR Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o KRB-ERROR -- The value field of this payload contains a raw
Kerberos KRB-ERROR.
4.2.4. KINK_TGT_REQ Payload
The KINK_TGT_REQ payload provides a means to get a TGT from the peer
in order to obtain a User-to-User service ticket from the KDC.
The value field of this payload has the following format:
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| |
~ PrincName (variable) ~
| |
+---------------------------------------------------------------+
Figure 10: KINK_TGT_REQ Payload
Fields:
Sakane, Kamada, Thomas, and Vilhuber [Page 21]
^L
Internet-Draft KINK July 2005
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o PrincName -- The name of the principal which the initiator want to
communicate with. It is assumed that the initiator knows the
responder's principal name (including the realm name) in the same
way as the non-User-to-User case. When the requested principal is
"principal@REALM", the responder MUST return a ticket whose server
and client principals are "krbtgt/REALM@REALM" and
"principal@REALM" respectively, so that the initiator can obtain a
User-to-User service ticket at the KDC of the responder's realm.
If the responder is not the requested principal and is unable to get
a TGT for the name, it MAY return a KRB_AP_ERR_NOT_US. If the
administrative policy prohibits returning a TGT, it MAY return a
KINK_U2UDENIED.
4.2.5. KINK_TGT_REP Payload
The value field of this payload contains the TGT requested in a
previous KINK_TGT_REQ payload of a GETTGT command.
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| |
~ TGT (variable) ~
| |
+---------------------------------------------------------------+
Figure 11: KINK_TGT_REP Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o TGT -- The DER encoded TGT of the responder.
4.2.6. KINK_ISAKMP Payload
The value field of this payload has the following format:
Sakane, Kamada, Thomas, and Vilhuber [Page 22]
^L
Internet-Draft KINK July 2005
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+-------+-------+---------------+---------------+
| InnerNextPload| QMMaj | QMMin | RESERVED |
+---------------+-------+-------+---------------+---------------+
| Quick Mode Payloads (variable) |
+---------------+---------------+---------------+---------------+
Figure 12: KINK_ISAKMP Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o InnerNextPload -- First payload type of the inner series of ISAKMP
payloads.
o QMMaj -- The major version of the inner payloads. MUST be set to
1.
o QMMin -- The minor version of the inner payloads. MUST be set to
0.
The KINK_ISAKMP payload encapsulates the IKE Quick Mode (phase two)
payloads to take the appropriate action dependent on the KINK
command. There may be any number of KINK_ISAKMP payloads within a
single KINK message. While [IKE] is somewhat fuzzy about whether
multiple different SAs may be created within a single IKE message,
KINK explicitly requires that a new ISAKMP header be used for each
discrete SA operation. In other words, a KINK implementation MUST
NOT send multiple quick mode transactions within a single KINK_ISAKMP
payload.
The purpose of the Quick Mode version is to allow backward
compatibility with IKE and ISAKMP if there are subsequent revisions.
At the present time, the Quick Mode major and minor versions are set
to one and zero (1.0) respectively. These versions do not correspond
to the ISAKMP version in the ISAKMP header. A compliant KINK
implementation MUST support receipt of 1.0 payloads. It MAY support
subsequent versions (both sending and receiving), and SHOULD provide
a means to resort back to Quick Mode version 1.0 if the KINK peer is
unable to process future versions. A compliant KINK implementation
MUST NOT mix Quick Mode versions in any given transaction.
Sakane, Kamada, Thomas, and Vilhuber [Page 23]
^L
Internet-Draft KINK July 2005
4.2.7. KINK_ENCRYPT Payload
The KINK_ENCRYPT payload encapsulates other payloads and is encrypted
using the encryption algorithm specified by the etype of the session
key. This payload MUST be the final payload in the message. KINK
encrypt payloads MUST be encrypted before the final KINK checksum is
applied.
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| InnerNextPload| RESERVED2 |
+---------------+---------------+---------------+---------------+
| Payload (variable) |
+---------------+---------------+---------------+---------------+
Figure 13: KINK_ENCRYPT Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section. This payload is the last one in a message, and
accordingly, the Next Payload field must be KINK_DONE (0).
o InnerNextPload -- First payload type of the inner series of
encrypted KINK payloads.
o RESERVED2 -- Reserved and MUST be zero when sent, MUST be ignored
when received.
The coverage of the encrypted data begins at InnerNextPload so that
the first payload's type is kept confidential. Thus, the number of
encrypted octets is PayloadLength - 4.
The format of the encryption payload follows the normal Kerberos
semantics. Its content is the output of an encrypt function defined
in the Encryption Algorithm Profile section of [KCRYPTO]. Parameters
such as encrypt function itself, specific-key, and initial state are
defined with the etype. The encrypt function may have padding in
itself and there may be some garbage data at the end of the decrypted
plaintext. A KINK implementation MUST be prepared to ignore such
padding after the last sub-payload inside the KINK_ENCRYPT payload.
Note that each encrypt function has its own integrity protection
mechanism. It is redundant with the checksum in the KINK header, but
this is unavoidable because it is not always possible to remove the
integrity protection part from the encrypt function.
Sakane, Kamada, Thomas, and Vilhuber [Page 24]
^L
Internet-Draft KINK July 2005
4.2.8. KINK_ERROR Payload
The KINK_ERROR payload type provides a protocol level mechanism of
returning an error condition. This payload should not be used for
either Kerberos generated errors, or DOI specific errors which have
their own payloads defined. The error code is in network order.
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
+---------------+---------------+---------------+---------------+
| Next Payload | RESERVED | Payload Length |
+---------------+---------------+---------------+---------------+
| ErrorCode |
+---------------+---------------+---------------+---------------+
Figure 14: KINK_ERROR Payload
Fields:
o Next Payload, RESERVED, Payload Length -- Defined in the beginning
of this section.
o ErrorCode -- One of the following values in the network byte
order:
ErrorCode Value Purpose
--------- ----- -------------------
KINK_OK 0 No error detected
KINK_PROTOERR 1 The message was malformed
KINK_INVDOI 2 Invalid DOI
KINK_INVMAJ 3 Invalid Major Version
RESERVED 4
KINK_INTERR 5 An unrecoverable internal error
KINK_BADQMVERS 6 Unsupported Quick Mode Version
KINK_U2UDENIED 7 Returning a TGT is prohibited
RESERVED TO IANA 8 - 8191
Private Use 8192 - 16383
RESERVED 16384 -
The responder MUST NOT return KINK_OK. When received, the
initiator MAY act as if the specific KINK_ERROR payload were not
present. If the initiator supports multiple Quick Mode versions
or DOIs, KINK_BADQMVERS or KINK_INVDOI is received, and the Cksum
is verified, then it MAY retry with another version or DOI. A
responder SHOULD return a KINK error with KINK_INVMAJ, when it
receives an unsupported KINK version number in the header. When
KINK_U2UDENIED is received, the initiator MAY retry with the non-
User-to-User mode (if not yet been tried).
Sakane, Kamada, Thomas, and Vilhuber [Page 25]
^L
Internet-Draft KINK July 2005
In general, the responder MAY choose to return these errors in
reply to unauthenticated commands, but SHOULD take care to avoid
being involved in denial of service attacks. Similarly, the
initiator MAY choose to act on unauthenticated errors, but SHOULD
take care to avoid denial of service attacks.
5. Differences from IKE Quick Mode
KINK directly uses ISAKMP payloads to negotiate SAs. In particular,
KINK uses IKE phase II payload types (aka Quick Mode). In general,
there should be very few changes necessary to an IKE implementation
to establish the SAs, and unless there is a note to the contrary in
the memo, all capabilities and requirements in [IKE] MUST be
supported. IKE Phase I payloads MUST NOT be sent.
Unlike IKE, KINK defines specific commands for creation, deletion,
and status of SAs, mainly to facilitate predictable SA
creation/deletion (see section 3.2 and 3.3). As such, KINK places
certain restrictions on what payloads may be sent with which
commands, and some additional restrictions and semantics of some of
the payloads. Implementors should refer to [IKE] and [ISAKMP] for
the actual format and semantics. If a particular IKE phase II
payload is not mentioned here, it means that there are no differences
in its use.
o The Security Association Payload header for IP is defined in the
section 4.6.1 of [IPDOI]. For this memo, the Domain of
Interpretation MUST be set to 1 (IPsec) and the Situation bitmap
MUST be set to 1 (SIT_IDENTITY_ONLY). All other fields are
omitted (because SIT_IDENTITY_ONLY is set).
o KINK also expands the semantics of IKE in it defines an
optimistic proposal for CREATE commands to allow SA creation to
complete in two messages.
o IKE Quick Mode (phase 2) uses the hash algorithm used in main
mode (phase 1) to generate the keying material. For this
purpose, KINK MUST use a pseudo-random function determined by the
etype of the session key.
o KINK does not use the HASH payload at all.
o KINK allows the NONCE payload Nr to be optional to facilitate
optimistic keying.
Sakane, Kamada, Thomas, and Vilhuber [Page 26]
^L
Internet-Draft KINK July 2005
5.1. Security Association Payloads
KINK supports the following SA attributes from [IPDOI]:
class value type
-------------------------------------------------
SA Life Type 1 B
SA Life Duration 2 V
Encapsulation Mode 4 B
Authentication Algorithm 5 B
Key Length 6 B
Key Rounds 7 B
Refer to [IPDOI] for the actual definitions for these attributes.
5.2. Proposal and Transform Payloads
KINK directly uses the Proposal and Transform payloads with no
differences. KINK, however, places additional relevance to the first
proposal and first transform of each conjugate for optimistic keying.
5.3. Identification Payloads
The Identification payload carries information that is used to
identify the traffic that is to be protected by the SA that will be
established. KINK restricts the ID types to the following values:
ID Type Value
------- -----
ID_IPV4_ADDR 1
ID_IPV4_ADDR_SUBNET 4
ID_IPV6_ADDR 5
ID_IPV6_ADDR_SUBNET 6
ID_IPV4_ADDR_RANGE 7
ID_IPV6_ADDR_RANGE 8
5.4. Nonce Payloads
The Nonce payload contains random data that MUST be used in key
generation. It MUST be sent by the initiating KINK peer, and MAY be
sent by the responding KINK peer. See section 7 for the discussion
of its use in key generation.
Sakane, Kamada, Thomas, and Vilhuber [Page 27]
^L
Internet-Draft KINK July 2005
5.5. Notify Payloads
Notify payloads are used to transmit several informational data, such
as error conditions and state transitions to a peer. For example,
notification information transmit can be error messages specifying
why an SA could not be established. It can also be status data that
a process managing an SA database wishes to communicate with a peer
process.
Types in the range 0 - 16383 are intended for reporting errors
[ISAKMP]. An implementation receiving a type in this range that it
does not recognize in a response MUST assume that the corresponding
request has failed entirely. Unrecognized error types in a request
and status types in a request or response MUST be ignored, and they
SHOULD be logged. Notify payloads with status types MAY be added to
any message and MUST be ignored if not recognized. They are intended
to indicate capabilities, and as part of SA negotiation are used to
negotiate non-cryptographic parameters.
The table below lists the Notification messages and their
corresponding values. This document draws upon [IKEv2] to explain
the usage of the messages clearly. PAYLOAD-MALFORMED denotes some
error types defined by [ISAKMP]. Hence INVALID-PROTOCOL-ID for
example is not used in this document. INVALID-MAJOR-VERSION and
INVALID-MINOR-VERSION are not used because KINK_BADQMVERS is used to
tell the initiator that the version of IKE is not supported.
NOTIFY MESSAGES - ERROR TYPES Value
----------------------------- -----
INVALID-PAYLOAD-TYPE 1
Sent if the ISAKMP payload type is not recognized. It is also
sent when the KE Payload is not supported by the responder.
Notification Data MUST contains the one octet payload type.
INVALID-SPI 11
Sent if the responder has an SPI indicated by the initiator in
case of CREATE flow, or if the responder does not have an SPI
indicated by the initiator in case of DELETE flow.
NO-PROPOSAL-CHOSEN 14
Sent if none of the proposals in the SA payload was
acceptable.
PAYLOAD-MALFORMED 16
Sakane, Kamada, Thomas, and Vilhuber [Page 28]
^L
Internet-Draft KINK July 2005
Sent if the KINK_ISAKMP message received was invalid because
some type, length, or value was out of range. It is also sent
when the request was rejected for reason that was not matched
with other error types.
5.6. Delete Payloads
KINK directly uses ISAKMP delete payloads with no changes.
5.7. KE Payloads
IKE requires that perfect forward secrecy be supported through the
use of the KE payload. KINK retains the ability to use PFS, but
relaxes the requirement from must implement to SHOULD implement. The
reasons are described in the Security Considerations section.
6. Message Construction and Constraints for IPsec DOI
All commands, responses, and acknowledgments are bound together by
the XID field of the message header. The XID is normally a
monotonically incrementing field, and is used by the initiator to
differentiate between outstanding requests to a responder. The XID
field does not provide replay protection as that functionality is
provided by the Kerberos mechanisms. In addition, commands and
responses MUST use a cryptographic checksum over the entire message
if the two peers share a key via a ticket exchange.
6.1. REPLY Message
The REPLY message is a generic reply which MUST contain either a
KINK_AP_REP, a KINK_KRB_ERROR, or a KINK_ERROR payload. REPLY
messages MAY contain additional DOI specific payloads such as ISAKMP
payloads which are defined in the following sections.
6.2. ACK Message
ACKs are sent only when the ACKREQ bit is set in a REPLY message. An
ACK message MUST contain an AP-REQ payload and no other payload.
Sakane, Kamada, Thomas, and Vilhuber [Page 29]
^L
Internet-Draft KINK July 2005
6.3. CREATE Message
This message initiates an establishment of new Security
Association(s). The CREATE message must contain an AP-REQ payload
and any DOI specific payloads.
CREATE KINK Header
KINK_AP_REQ
[KINK_ENCRYPT]
KINK_ISAKMP payloads
SA Payload
Proposal Payloads
Transform Payloads
Nonce Payload (Ni)
[KE]
[IDci, IDcr]
[Notification Payloads]
Replies are of the following forms:
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
KINK_ISAKMP payloads
SA Payload
Proposal Payloads
Transform Payload
[Nonce Payload (Nr)]
[KE]
[IDci, IDcr]
[Notification Payloads]
Note that there MUST be at least a single proposal payload and a
single transform payload in REPLY messages. There will be multiple
proposal payloads only when an SA bundle is negotiated. Also: unlike
IKE, the Nonce Payload Nr is not required, and if it exists, an
acknowledgment must be requested to indicate that the initiator's
outgoing SAs must be modified. If any of the first proposals are not
chosen by the recipient, it SHOULD include the nonce payload.
KINK, like IKE, allows the creation of many SAs in one create
command. If any of the optimistic proposals is not chosen by the
responder, it MUST request an ACK.
If an IPsec DOI specific error is encountered, the responder must
reply with a Notify payload describing the error:
Sakane, Kamada, Thomas, and Vilhuber [Page 30]
^L
Internet-Draft KINK July 2005
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
[KINK_ERROR]
KINK_ISAKMP payloads
[Notification Payloads]
If the responder finds a Kerberos error for which it can produce a
valid authenticator, the REPLY takes the following form:
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
KINK_KRB_ERROR
Finally, if the responder finds a Kerberos or KINK type of error
which it cannot create an AP-REP for, it MUST reply with a lone
KINK_KRB_ERROR or KINK_ERROR payload:
REPLY KINK Header
[KINK_KRB_ERROR]
[KINK_ERROR]
6.4. DELETE Message
This message indicates that the sending peer has deleted or will
shortly delete Security Association(s) with the other peer.
DELETE KINK Header
KINK_AP_REQ
[KINK_ENCRYPT]
KINK_ISAKMP payloads
Delete Payloads
[Notification Payloads]
There are three forms of replies for a DELETE. The normal form is:
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
[KINK_ERROR]
KINK_ISAKMP payloads
Delete Payloads
[Notification Payloads]
If an IPsec DOI specific error is encountered, the responder must
reply with a Notify payload describing the error:
Sakane, Kamada, Thomas, and Vilhuber [Page 31]
^L
Internet-Draft KINK July 2005
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
[KINK_ERROR]
KINK_ISAKMP payloads
[Notification Payloads]
If the responder finds a Kerberos error for which it can produce a
valid authenticator, the REPLY takes the following form:
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
KINK_KRB_ERROR
If the responder finds a KINK or Kerberos type of error, it MUST
reply with a lone KINK_KRB_ERROR or KINK_ERROR payload:
REPLY KINK Header
[KINK_KRB_ERROR]
[KINK_ERROR]
6.5. STATUS Message
The STATUS command is used in two ways:
1) As a means to relay an ISAKMP Notification message.
2) As a means of probing a peer whether its epoch has changed for
dead peer detection.
STATUS contains the following payloads:
KINK Header
KINK_AP_REQ
[[KINK_ENCRYPT]
KINK_ISAKMP payload
[Notification Payloads]]
There are three forms of replies for a STATUS. The normal form is:
REPLY KINK Header
KINK_AP_REP
[[KINK_ENCRYPT]
[KINK_ERROR]
KINK_ISAKMP payload
[Notification Payloads]]
Sakane, Kamada, Thomas, and Vilhuber [Page 32]
^L
Internet-Draft KINK July 2005
If the responder finds a Kerberos error for which it can produce a
valid authenticator, the REPLY takes the following form:
REPLY KINK Header
KINK_AP_REP
[KINK_ENCRYPT]
KINK_KRB_ERROR
If the responder finds a KINK or Kerberos type of error, it MUST
reply with a lone KINK_KRB_ERROR or KINK_ERROR payload:
REPLY KINK Header
[KINK_KRB_ERROR]
[KINK_ERROR]
6.6. GETTGT Message
A GETTGT command is only used to carry a Kerberos TGT and is not
related to SA management, therefore it contains only KINK_TGT_REQ
payload and does not contain any DOI specific payload.
There are two forms of replies for a GETTGT. In the normal form,
where the responder is allowed to return its TGT, the REPLY contains
KINK_TGT_REP payload. If the responder is not allowed to return its
TGT, it MUST reply with a KINK_ERROR payload.
7. ISAKMP Key Derivation
KINK uses the same key derivation mechanisms defined in the section
5.5 of [IKE], which is:
KEYMAT = prf(SKEYID_d, [g(qm)^xy |] protocol | SPI | Ni_b [| Nr_b])
The following differences apply:
o prf is the pseudo-random function corresponding to the session
key's etype. They are defined in [KCRYPTO].
o SKEYID_d is the session key in the Kerberos service ticket from
the AP-REQ. Note that subkeys are not used in KINK and MUST be
ignored if received.
o Both Ni_b and Nr_b are the part of the nonce payloads (Ni and Nr
respectively) as described in the section 3.2 of [IKE]. Nr_b is
optional, which means that Nr_b is treated as if a zero length
value was supplied when the responder's nonce (Nr) does not exist.
Sakane, Kamada, Thomas, and Vilhuber [Page 33]
^L
Internet-Draft KINK July 2005
When Nr exists, Nr_b MUST be included in the calculation.
Note that g(qm)^xy refers to the keying material generated when KE
payloads are supplied using Diffie Hellman key agreement. This is
explained in the section 5.5 of [IKE].
The rest of the key derivation (e.g., how to expand KEYMAT) follows
IKE. How to use derived keying materials is up to each service
(e.g., the section 4.6.2 of [IPSEC]).
8. Key Usage Numbers for Kerberos Key Derivation
Kerberos encrypt/decrypt functions and get_mic/verify_mic functions
require "key usage numbers". They are used to generate specific keys
for cryptographic operations so that different keys are used for
different purposes/objects. KINK uses two usage numbers listed
below.
Purpose Usage number
------- ------------
KINK_ENCRYPT (for encryption) XXX -- TBA by rfc1510ter
Cksum (for checksum) XXX -- TBA by rfc1510ter
9. Transport Considerations
KINK uses UDP on port [XXX -- TBA by IANA] to transport its messages.
There is one timer T which SHOULD take into consideration round trip
considerations and MUST implement a truncated exponential back off
mechanism. The state machine is simple: any message which expects a
response MUST retransmit the request using timer T. Since Kerberos
requires that messages be retransmitted with new times for replay
protection, the message MUST be recreated each time including the
checksum of the message. Both commands and replies with the ACKREQ
bit set are kept on retransmit timers. When a KINK initiator
receives a REPLY with the ACKREQ bit set, it MUST retain the ability
to regenerate the ACK message for the transaction for a minimum of
its full retransmission timeout cycle or until it notices that
packets have arrived on the newly constructed SA, whichever comes
first.
When a KINK peer retransmits a message, it MUST create a new Kerberos
authenticator for the AP-REQ so that the peer can differentiate
between replays and dropped packets. This results in a potential
race condition when a retransmission occurs before an in-flight reply
is received/processed. To counter this race condition, the
retransmitting party SHOULD keep a list of valid authenticators which
Sakane, Kamada, Thomas, and Vilhuber [Page 34]
^L
Internet-Draft KINK July 2005
are outstanding for any particular transaction.
10. Implementation Hints
KINK leaves the population of the IPsec security policy database out
of scope. There are, however, considerations which should be pointed
out. Even though when and when not to initiate a User-to-User flow
is left to the discretion of the KINK implementation, a Kerberos
client which initially authenticated using a shared key SHOULD NOT
use a User-to-User flow if the responder is also in the same realm.
Likewise, a KINK initiator which authenticated in a public key realm
SHOULD use a User-to-User flow if the responder is in the same realm.
11. Security Considerations
The principal names are the identities of the KINK services, but the
traffic which is protected by SAs are identified by DOI specific
selectors (IP addresses, port numbers, etc). Thus, an implementation
must take care for the relationship between principal names and the
selectors of SAs.
Sending errors without cryptographic protection must be handled very
carefully. There is a trade-off between wanting to be helpful in
diagnosing a problem and wanting to avoid being a dupe in a denial of
service attack.
KINK cobbles together and reuses many parts of both Kerberos and IKE,
the latter which in turn is cobbled together from many other memos.
As such, KINK inherits many of the weaknesses and considerations of
each of its components. However, KINK uses only IKE Phase II
payloads to create and delete SAs, the security considerations which
pertain to IKE Phase I may be safely ignored. However, being able to
ignore IKE's authentication phase necessarily means that KINK
inherits all of the security considerations of Kerberos
authentication as outlined in [KERBEROS]. For one, a KDC, like an
AAA server, is a point of attack and all that implies. Much has been
written about various shortcomings and mitigations of Kerberos and
they should be evaluated for any deployment.
The KINK's use of Kerberos presents a couple of considerations.
First, KINK explicitly expects that the KDC will provide adequate
entropy when it generates session keys. Second, Kerberos is used as
a user authentication protocol with the possibility of dictionary
attacks on user passwords. This memo does not describe a particular
method to avoid these pitfalls, but recommends that suitable randomly
generated keys should be used for the service principals such as
Sakane, Kamada, Thomas, and Vilhuber [Page 35]
^L
Internet-Draft KINK July 2005
using the -randomkey option with MIT's "kadmin addprinc" command as
well as for clients when that is practical.
Kerberos does not currently provide perfect forward secrecy in
general. KINK with the KE payload can provide PFS for a service key
from a Kerberos key, but the KE is not mandatory because of the
computational cost. This is a trade-off and operators can choose the
PFS over the cost, and vice versa. KINK itself should be secure from
offline analysis from compromised principal passphrases if PFS is
used, but from an overall system's standpoint, the existence of other
Kerberized services which do not provide PFS makes this a less than
optimal situation.
12. IANA Considerations
This document requests IANA to assign a well known port number.
This document also requests IANA to create a new registry for KINK,
and register the following identifiers.
KINK Message Types (section 4)
KINK Next Payload Types (section 4.2)
KINK Error Codes (section 4.2.8)
Changes and additions to this registry follow the policies described
below. Their meanings are described in [BCP26].
o Using the numbers in the "Private Use" range is Private Use.
o Assignment from the "RESERVED TO IANA" range needs Standards
Action, or non standards-track RFCs with Expert Review. (Though
the full specification may be a public and permanent document of a
standards body other than IETF, an RFC referring it is needed.)
o Other change requires Standards Action.
13. Forward Compatibility Considerations
KINK can accommodate future versions of Quick Mode through the use of
the version field in the ISAKMP payload as well as new domains of
interpretation. In this memo, the only supported Quick Mode version
is 1.0 which corresponds to [IKE]. Likewise, the only DOI supported
is the IPsec domain of interpretation [IPDOI]. New Quick Mode
versions and DOIs MUST be described in subsequent memos.
KINK implementations MUST reject ISAKMP versions which are greater
Sakane, Kamada, Thomas, and Vilhuber [Page 36]
^L
Internet-Draft KINK July 2005
than the highest currently supported version with a KINK_BADQMVERS
error type. A KINK implementation which receives a KINK_BADQMVERS
message SHOULD be capable of reverting back to version 1.0.
13.1. New Versions of Quick Mode
The IPsec working group is defining the next generation IKE protocol
[IKEv2] which does not use Quick Mode, but it is similar to the one
in IKEv1. The difference between the two is summarized in the
Appendix A in [IKEv2]. Each of them must be considered in order to
use IKEv2 with KINK.
13.2. New DOI
The KINK message header contains a field called "Domain of
Interpretation (DOI)" to allow other domains of interpretation to use
KINK as a secure transport mechanism for keying.
As one example of a new DOI, the MSEC working group defined the Group
Domain of Interpretation [GDOI], which defines a few new messages,
which look like ISAKMP messages, but are not defined in ISAKMP.
In order to carry GDOI messages in KINK, the DOI field in the KINK
header would indicate that GDOI is being used, instead of IPSEC-DOI,
and the KINK_ISAKMP payload would contain the payloads defined in the
GDOI draft rather than the payloads used by [IKE] Quick Mode. The
version number in the KINK_ISAKMP header is related to the DOI in the
KINK header, so a maj.min version 1.0 under DOI GDOI is different
from a maj.min version 1.0 under DOI IPSEC-DOI.
14. Related Work
The IPsec working group has defined a number of protocols that
provide the ability to create and maintain cryptographically secure
SAs at layer three (i.e. the IP layer). This effort has produced two
distinct protocols:
o a mechanism for encrypting and authenticating IP datagram payloads
which assumes a shared secret between the sender and receiver
o a mechanism for IPsec peers to perform mutual authentication and
exchange keying material
The IPsec working group has defined a peer to peer authentication and
keying mechanism, IKE (RFC 2409). One of the drawbacks of a peer to
Sakane, Kamada, Thomas, and Vilhuber [Page 37]
^L
Internet-Draft KINK July 2005
peer protocol is that each peer must know and implement a site's
security policy which in practice can be quite complex. In addition,
the peer to peer nature of IKE requires the use of Diffie Hellman
(DH) to establish a shared secret. DH, unfortunately, is
computationally quite expensive and prone to denial of service
attacks. IKE also relies on X.509 certificates to realize scalable
authentication of peers. Digital signatures are also computationally
expensive and certificate based trust models are difficult to deploy
in practice. While IKE does allow for a pre-shared key, key
distribution is required between all peers -- an O(n2) problem --
which is problematic for large deployments.
15. Acknowledgments
Many have contributed to the KINK effort, including our working group
chairs Derek Atkins and Jonathan Trostle. The original inspiration
came from Cablelab's Packetcable effort which defined a simplified
version of Kerberized IPsec, including Sasha Medvinsky, Mike Froh,
and Matt Hur and David McGrew. The inspiration for wholly reusing
IKE Phase II is the result of the Tero Kivinen's draft suggesting
grafting Kerberos authentication onto quick mode.
16. References
16.1. Normative References
[BCP26] T. Narten, H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", BCP 26, RFC 2434,
October 1998.
[IKE] D. Harkins, D. Carrel, "The Internet Key Exchange
(IKE)", RFC 2409, November 1998.
[IPDOI] D. Piper, "The Internet IP Security Domain Of
Interpretation for ISAKMP", RFC 2407, November 1998.
[IPSEC] S. Kent, R. Atkinson, "Security Architecture for the
Internet Protocol", RFC 2401, November 1998.
[ISAKMP] D. Maughhan, M. Schertler, M. Schneider, J. Turner,
"Internet Security Association and Key Management
Protocol (ISAKMP)", RFC 2408, November 1998.
[ISAKMP-REG] IANA, "Internet Security Association and Key Management
Protocol (ISAKMP) Identifiers",
Sakane, Kamada, Thomas, and Vilhuber [Page 38]
^L
Internet-Draft KINK July 2005
<http://www.iana.org/assignments/isakmp-registry>.
[KCRYPTO] K. Raeburn, "Encryption and Checksum Specifications for
Kerberos 5", RFC 3961, February 2005.
[KERBEROS] C. Neuman, T. Yu, S. Hartman, K. Raeburn, "The Kerberos
Network Authentication Service (V5)", RFC 4120, July
2005.
16.2. Informative References
[GDOI] M. Baugher, B. Weis, T. Hardjono, H. Harney, "The Group
Domain of Interpretation", RFC 3547, July 2003.
[IKEv2] C. Kaufman, Ed, "Internet Key Exchange (IKEv2)
Protocol", draft-ietf-ipsec-ikev2-17.txt.
[PKINIT] B. Tung, L. Zhu, "Public Key Cryptography for Initial
Authentication in Kerberos", draft-ietf-cat-kerberos-
pk-init-26.txt.
[REQ4KINK] M. Thomas, "Requirements for Kerberized Internet
Negotiation of Keys", RFC 3129, June 2001.
[RFC793] J. Postel, "Transmission Control Protocol", RFC 793,
September 1981.
Authors' Addresses
Shoichi Sakane
Ken'ichi Kamada
Yokogawa Electric Corporation
2-9-32 Nakacho, Musashino-shi,
Tokyo 180-8750 Japan
E-mail: Shouichi.Sakane@jp.yokogawa.com,
Ken-ichi.Kamada@jp.yokogawa.com
Michael Thomas
Jan Vilhuber
Cisco Systems
170 West Tasman Drive
San Jose, CA 95134
E-mail: mat@cisco.com, vilhuber@cisco.com
Sakane, Kamada, Thomas, and Vilhuber [Page 39]
^L
Internet-Draft KINK July 2005
Change History (To be removed from RFC)
H.08
1) improved the notify payloads section.
2) simplified the IANA consideration.
3) removed the KINK minor version.
4) improved the message flow section
H.07
1) Modified lots of editorial things.
2) Added I-D boilerplate concerning Copyright and IPR claim
disclosure.
Full Copyright Statement
Copyright (C) The Internet Society (2005).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property Statement
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
Sakane, Kamada, Thomas, and Vilhuber [Page 40]
^L
Internet-Draft KINK July 2005
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at ietf-
ipr@ietf.org.
Sakane, Kamada, Thomas, and Vilhuber [Page 41]
^L
Html markup produced by rfcmarkup 1.129d, available from
https://tools.ietf.org/tools/rfcmarkup/