x
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@22082 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
896
doc/standardisation/draft-ietf-krb-wg-kerberos-referrals-09.txt
Normal file
896
doc/standardisation/draft-ietf-krb-wg-kerberos-referrals-09.txt
Normal file
@@ -0,0 +1,896 @@
|
||||
|
||||
|
||||
|
||||
NETWORK WORKING GROUP K. Raeburn
|
||||
Internet-Draft MIT
|
||||
Updates: 4120 (if approved) L. Zhu
|
||||
Intended status: Standards Track Microsoft Corporation
|
||||
Expires: September 6, 2007 March 5, 2007
|
||||
|
||||
|
||||
Generating KDC Referrals to Locate Kerberos Realms
|
||||
draft-ietf-krb-wg-kerberos-referrals-09
|
||||
|
||||
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 Internet-Draft will expire on September 6, 2007.
|
||||
|
||||
Copyright Notice
|
||||
|
||||
Copyright (C) The IETF Trust (2007).
|
||||
|
||||
Abstract
|
||||
|
||||
The memo documents a method for a Kerberos Key Distribution Center
|
||||
(KDC) to respond to client requests for Kerberos tickets when the
|
||||
client does not have detailed configuration information on the realms
|
||||
of users or services. The KDC will handle requests for principals in
|
||||
other realms by returning either a referral error or a cross-realm
|
||||
TGT to another realm on the referral path. The clients will use this
|
||||
referral information to reach the realm of the target principal and
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 1]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
then receive the ticket.
|
||||
|
||||
|
||||
Table of Contents
|
||||
|
||||
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
|
||||
2. Conventions Used in This Document . . . . . . . . . . . . . . 4
|
||||
3. Requesting a Referral . . . . . . . . . . . . . . . . . . . . 4
|
||||
4. Realm Organization Model . . . . . . . . . . . . . . . . . . . 5
|
||||
5. Client Name Canonicalization . . . . . . . . . . . . . . . . . 5
|
||||
6. Client Referrals . . . . . . . . . . . . . . . . . . . . . . . 7
|
||||
7. Server Referrals . . . . . . . . . . . . . . . . . . . . . . . 8
|
||||
8. Server Name Canonicalization (Informative) . . . . . . . . . . 10
|
||||
9. Cross Realm Routing . . . . . . . . . . . . . . . . . . . . . 10
|
||||
10. Caching Information . . . . . . . . . . . . . . . . . . . . . 11
|
||||
11. Open Issues . . . . . . . . . . . . . . . . . . . . . . . . . 11
|
||||
12. Security Considerations . . . . . . . . . . . . . . . . . . . 12
|
||||
13. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 12
|
||||
14. References . . . . . . . . . . . . . . . . . . . . . . . . . . 12
|
||||
14.1. Normative References . . . . . . . . . . . . . . . . . . 12
|
||||
14.2. Informative References . . . . . . . . . . . . . . . . . 12
|
||||
Appendix A. Compatibility with Earlier Implementations of
|
||||
Name Canonicalization . . . . . . . . . . . . . . . . 13
|
||||
Appendix B. Document history . . . . . . . . . . . . . . . . . . 14
|
||||
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 15
|
||||
Intellectual Property and Copyright Statements . . . . . . . . . . 16
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 2]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
1. Introduction
|
||||
|
||||
Current implementations of the Kerberos AS and TGS protocols, as
|
||||
defined in [RFC4120], use principal names constructed from a known
|
||||
user or service name and realm. A service name is typically
|
||||
constructed from a name of the service and the DNS host name of the
|
||||
computer that is providing the service. Many existing deployments of
|
||||
Kerberos use a single Kerberos realm where all users and services
|
||||
would be using the same realm. However in an environment where there
|
||||
are multiple trusted Kerberos realms, the client needs to be able to
|
||||
determine what realm a particular user or service is in before making
|
||||
an AS or TGS request. Traditionally this requires client
|
||||
configuration to make this possible.
|
||||
|
||||
When having to deal with multiple trusted realms, users are forced to
|
||||
know what realm they are in before they can obtain a ticket granting
|
||||
ticket (TGT) with an AS request. However, in many cases the user
|
||||
would like to use a more familiar name that is not directly related
|
||||
to the realm of their Kerberos principal name. A good example of
|
||||
this is an RFC 822 style email name. This document describes a
|
||||
mechanism that would allow a user to specify a user principal name
|
||||
that is an alias for the user's Kerberos principal name. In practice
|
||||
this would be the name that the user specifies to obtain a TGT from a
|
||||
Kerberos KDC. The user principal name no longer has a direct
|
||||
relationship with the Kerberos principal or realm. Thus the
|
||||
administrator is able to move the user's principal to other realms
|
||||
without the user having to know that it happened.
|
||||
|
||||
Once a user has a TGT, they would like to be able to access services
|
||||
in any trusted Kerberos realm. To do this requires that the client
|
||||
be able to determine what realm the target service principal is in
|
||||
before making the TGS request. Current implementations of Kerberos
|
||||
typically have a table that maps DNS host names to corresponding
|
||||
Kerberos realms. The user-supplied host name or its domain component
|
||||
is looked up in this table (often using the result of some form of
|
||||
host name lookup performed with insecure DNS queries, in violation of
|
||||
[RFC4120]). The corresponding realm is then used to complete the
|
||||
target service principal name.
|
||||
|
||||
This traditional mechanism requires that each client have very
|
||||
detailed configuration information about the hosts that are providing
|
||||
services and their corresponding realms. Having client side
|
||||
configuration information can be very costly from an administration
|
||||
point of view - especially if there are many realms and computers in
|
||||
the environment.
|
||||
|
||||
There are also cases where specific DNS aliases (local names) have
|
||||
been setup in an organization to refer to a server in another
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 3]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
organization (remote server). The server has different DNS names in
|
||||
each organization and each organization has a Kerberos realm that is
|
||||
configured to service DNS names within that organization. Ideally
|
||||
users are able to authenticate to the server in the other
|
||||
organization using the local server name. This would mean that the
|
||||
local realm be able to produce a ticket to the remote server under
|
||||
its name. The administrator in the local realm could give that
|
||||
remote server an identity in the local realm and then have that
|
||||
remote server maintain a separate secret for each alias it is known
|
||||
as. Alternatively the administrator could arrange to have the local
|
||||
realm issue a referral to the remote realm and notify the requesting
|
||||
client of the server's remote name that should be used in order to
|
||||
request a ticket.
|
||||
|
||||
This memo proposes a solution for these problems and simplifies
|
||||
administration by minimizing the configuration information needed on
|
||||
each computer using Kerberos. Specifically it describes a mechanism
|
||||
to allow the KDC to handle canonicalization of names, provide for
|
||||
principal aliases for users and services and allow the KDC to
|
||||
determine the trusted realm authentication path by being able to
|
||||
generate referrals to other realms in order to locate principals.
|
||||
|
||||
Two kinds of KDC referrals are introduced in this memo:
|
||||
|
||||
1. Client referrals, in which the client doesn't know which realm
|
||||
contains a user account.
|
||||
2. Server referrals, in which the client doesn't know which realm
|
||||
contains a server account.
|
||||
|
||||
|
||||
2. 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 [RFC2119].
|
||||
|
||||
|
||||
3. Requesting a Referral
|
||||
|
||||
In order to request referrals defined in section 5, 6, and 7, the
|
||||
Kerberos client MUST explicitly request the canonicalize KDC option
|
||||
(bit 15) [RFC4120] for the AS-REQ or TGS-REQ. This flag indicates to
|
||||
the KDC that the client is prepared to receive a reply that contains
|
||||
a principal name other than the one requested.
|
||||
|
||||
|
||||
KDCOptions ::= KerberosFlags
|
||||
-- canonicalize (15)
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 4]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
-- other KDCOptions values omitted
|
||||
|
||||
The client should expect, when sending names with the "canonicalize"
|
||||
KDC option, that names in the KDC's reply MAY be different than the
|
||||
name in the request. A referral TGT is a cross realm TGT that is
|
||||
returned with the server name of the ticket being different from the
|
||||
server name in the request [RFC4120].
|
||||
|
||||
|
||||
4. Realm Organization Model
|
||||
|
||||
This memo assumes that the world of principals is arranged on
|
||||
multiple levels: the realm, the enterprise, and the world. A KDC may
|
||||
issue tickets for any principal in its realm or cross-realm tickets
|
||||
for realms with which it has a direct trust relationship. The KDC
|
||||
also has access to a trusted name service that can resolve any name
|
||||
from within its enterprise into a realm. This trusted name service
|
||||
removes the need to use an un-trusted DNS lookup for name resolution.
|
||||
|
||||
For example, consider the following configuration, where lines
|
||||
indicate trust relationships:
|
||||
|
||||
EXAMPLE.COM
|
||||
/ \
|
||||
/ \
|
||||
ADMIN.EXAMPLE.COM DEV.EXAMPLE.COM
|
||||
|
||||
In this configuration, all users in the EXAMPLE.COM enterprise could
|
||||
have principal names such as alice@EXAMPLE.COM, with the same realm
|
||||
portion. In addition, servers at EXAMPLE.COM should be able to have
|
||||
DNS host names from any DNS domain independent of what Kerberos realm
|
||||
their principals reside in.
|
||||
|
||||
|
||||
5. Client Name Canonicalization
|
||||
|
||||
A client account may have multiple principal names. More useful,
|
||||
though, is a globally unique name that allows unification of email
|
||||
and security principal names. For example, all users at EXAMPLE.COM
|
||||
may have a client principal name of the form "joe@EXAMPLE.COM" even
|
||||
though the principals are contained in multiple realms. This global
|
||||
name is again an alias for the true client principal name, which
|
||||
indicates what realm contains the principal. Thus, accounts "alice"
|
||||
in the realm DEV.EXAMPLE.COM and "bob" in ADMIN.EXAMPLE.COM may log
|
||||
on as "alice@EXAMPLE.COM" and "bob@EXAMPLE.COM".
|
||||
|
||||
This utilizes a new client principal name type, as the AS-REQ message
|
||||
only contains a single realm field, and the realm portion of this
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 5]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
name corresponds to the Kerberos realm with which the request is
|
||||
made. Thus, the entire name "alice@EXAMPLE.COM" is transmitted as a
|
||||
single component in the client name field of the AS-REQ message, with
|
||||
a name type of NT-ENTERPRISE [RFC4120] (and the local realm name).
|
||||
The KDC will recognize this name type and then transform the
|
||||
requested name into the true principal name if the client account
|
||||
resides in the local realm. The true principal name can have a name
|
||||
type different from the requested name type. Typically the true
|
||||
principal name will be a NT-PRINCIPAL [RFC4120].
|
||||
|
||||
If the "canonicalize" KDC option is set, then the KDC MAY change the
|
||||
client principal name and type in the AS response and ticket returned
|
||||
from the name type of the client name in the request, and include a
|
||||
mandatory PA-DATA object authenticating the client name mapping:
|
||||
|
||||
ReferralInfo ::= SEQUENCE {
|
||||
requested-name [0] PrincipalName,
|
||||
mapped-name [1] PrincipalName,
|
||||
...
|
||||
}
|
||||
PA-CLIENT-CANONICALIZED ::= SEQUENCE {
|
||||
names [0] ReferralInfo,
|
||||
canon-checksum [1] Checksum
|
||||
}
|
||||
|
||||
The canon-checksum field is computed over the DER encoding of the
|
||||
names sequences, using the AS reply key and a key usage value of
|
||||
(TBD).
|
||||
|
||||
If the client name is unchanged, the PA-CLIENT-CANONICALIZED data is
|
||||
not included. If the client name is changed, and the PA-CLIENT-
|
||||
CANONICALIZED field does not exist, or the checksum cannot be
|
||||
verified, or the requested-name field doesn't match the client name
|
||||
in the originally-transmitted request, the client should discard the
|
||||
response.
|
||||
|
||||
For example the AS request may specify a client name of "bob@
|
||||
EXAMPLE.COM" as an NT-ENTERPRISE name with the "canonicalize" KDC
|
||||
option set and the KDC will return with a client name of "104567" as
|
||||
a NT-UID, and a PA-CLIENT-CANONICALIZED field listing the NT-
|
||||
ENTERPRISE "bob@EXAMPLE.COM" principal as the requested-name and the
|
||||
NT-UID "104567" principal as the mapped-name.
|
||||
|
||||
(It is assumed that the client discovers whether the KDC supports the
|
||||
NT-ENTERPRISE name type via out of band mechanisms.)
|
||||
|
||||
In order to enable one party in a user-to-user exchange to confirm
|
||||
the identity of another when only the alias is known, the KDC MAY
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 6]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
include the following authorization data element, wrapped in AD-KDC-
|
||||
ISSUED, in the initial credentials and copy it from a ticket-granting
|
||||
ticket into additional credentials:
|
||||
|
||||
AD-LOGIN-ALIAS ::= SEQUENCE { -- ad-type number TBD --
|
||||
login-aliases [0] SEQUENCE(1..MAX) OF PrincipalName,
|
||||
}
|
||||
|
||||
The login-aliases field lists one or more of the aliases the
|
||||
principal may have used in the initial ticket request.
|
||||
|
||||
The recipient of this authenticator must check the AD-LOGIN-ALIAS
|
||||
names, if present, in addition to the normal client name field,
|
||||
against the identity of the party with which it wishes to
|
||||
authenticate; either should be allowed to match. (Note that this is
|
||||
not backwards compatible with [RFC4120]; if the server side of the
|
||||
user-to-user exchange does not support this extension, and does not
|
||||
know the true principal name, authentication may fail if the alias is
|
||||
sought in the client name field.)
|
||||
|
||||
|
||||
6. Client Referrals
|
||||
|
||||
The simplest form of ticket referral is for a user requesting a
|
||||
ticket using an AS-REQ. In this case, the client machine will send
|
||||
the AS-REQ to a convenient trusted realm, for example the realm of
|
||||
the client machine. In the case of the name alice@EXAMPLE.COM, the
|
||||
client MAY optimistically choose to send the request to EXAMPLE.COM.
|
||||
The realm in the AS-REQ is always the name of the realm that the
|
||||
request is for as specified in [RFC4120].
|
||||
|
||||
The KDC will try to lookup the name in its local account database.
|
||||
If the account is present in the realm of the request, it SHOULD
|
||||
return a KDC reply structure with the appropriate ticket.
|
||||
|
||||
If the account is not present in the realm specified in the request
|
||||
and the "canonicalize" KDC option is set, the KDC will try to lookup
|
||||
the entire name, alice@EXAMPLE.COM, using a name service. If this
|
||||
lookup is unsuccessful, it MUST return the error
|
||||
KDC_ERR_C_PRINCIPAL_UNKNOWN [RFC4120]. If the lookup is successful,
|
||||
it MUST return an error KDC_ERR_WRONG_REALM [RFC4120] and in the
|
||||
error message the crealm field will contain either the true realm of
|
||||
the client or another realm that MAY have better information about
|
||||
the client's true realm. The client SHALL NOT use a cname returned
|
||||
from a Kerberos error until that name is validated.
|
||||
|
||||
If the client receives a KDC_ERR_WRONG_REALM error, it will issue a
|
||||
new AS request with the same client principal name used to generate
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 7]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
the first referral to the realm specified by the realm field of the
|
||||
Kerberos error message corresponding to the first request. (The
|
||||
client realm name will be updated in the new request to refer to this
|
||||
new realm.) The client SHOULD repeat these steps until it finds the
|
||||
true realm of the client. To avoid infinite referral loops, an
|
||||
implementation should limit the number of referrals. A suggested
|
||||
limit is 5 referrals before giving up.
|
||||
|
||||
Since the same client name is sent to the referring and referred-to
|
||||
realms, both realms must recognize the same client names. In
|
||||
particular, the referring realm cannot (usefully) define principal
|
||||
name aliases that the referred-to realm will not know.
|
||||
|
||||
The true principal name of the client, returned in AS-REQ, can be
|
||||
validated in a subsequent TGS message exchange where its value is
|
||||
communicated back to the KDC via the authenticator in the PA-TGS-REQ
|
||||
padata [RFC4120].
|
||||
|
||||
|
||||
7. Server Referrals
|
||||
|
||||
The primary difference in server referrals is that the KDC MUST
|
||||
return a referral TGT rather than an error message as is done in the
|
||||
client referrals. There needs to be a place to include in the reply
|
||||
information about what realm contains the server. This is done by
|
||||
returning information about the server name in the pre-authentication
|
||||
data field of the KDC reply [RFC4120], as specified later in this
|
||||
section.
|
||||
|
||||
If the KDC resolves the server principal name into a principal in the
|
||||
realm specified by the service realm name, it will return a normal
|
||||
ticket.
|
||||
|
||||
If the "canonicalize" flag in the KDC options is not set, the KDC
|
||||
MUST only look up the name as a normal principal name in the
|
||||
specified server realm. If the "canonicalize" flag in the KDC
|
||||
options is set and the KDC doesn't find the principal locally, the
|
||||
KDC MAY return a cross-realm ticket granting ticket to the next hop
|
||||
on the trust path towards a realm that may be able to resolve the
|
||||
principal name. The true principal name of the server SHALL be
|
||||
returned in the padata of the reply if it is different from what is
|
||||
specified the request.
|
||||
|
||||
When a referral TGT is returned, the KDC MUST return the target realm
|
||||
for the referral TGT as an KDC supplied pre-authentication data
|
||||
element in the response. This referral information in pre-
|
||||
authentication data MUST be encrypted using the session key from the
|
||||
reply ticket. The key usage value for the encryption operation used
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 8]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
by PA-SERVER-REFERRAL is 26.
|
||||
|
||||
The pre-authentication data returned by the KDC, which contains the
|
||||
referred realm and the true principal name of server, is encoded in
|
||||
DER as follows.
|
||||
|
||||
PA-SERVER-REFERRAL 25
|
||||
|
||||
PA-SERVER-REFERRAL-DATA ::= EncryptedData
|
||||
-- ServerReferralData --
|
||||
|
||||
ServerReferralData ::= SEQUENCE {
|
||||
referred-realm [0] Realm OPTIONAL,
|
||||
-- target realm of the referral TGT
|
||||
true-principal-name [1] PrincipalName OPTIONAL,
|
||||
-- true server principal name
|
||||
requested-principal-name [2] PrincipalName OPTIONAL,
|
||||
-- requested server name
|
||||
...
|
||||
}
|
||||
|
||||
Clients SHALL NOT accept a reply ticket, whose the server principal
|
||||
name is different from that of the request, if the KDC response does
|
||||
not contain a PA-SERVER-REFERRAL padata entry.
|
||||
|
||||
The requested-principal-name MUST be included by the KDC, and MUST be
|
||||
verified by the client, if the client sent an AS-REQ, as protection
|
||||
against a man-in-the-middle modification to the AS-REQ message.
|
||||
|
||||
The referred-realm field is present if and only if the returned
|
||||
ticket is a referral TGT, not a service ticket for the requested
|
||||
server principal.
|
||||
|
||||
When a referral TGT is returned and the true-principal-name field is
|
||||
present, the client MUST use that name in the subsequent requests to
|
||||
the server realm when following the referral.
|
||||
|
||||
Client SHALL NOT accept a true server principal name for a service
|
||||
ticket if the true-principal-name field is not present in the PA-
|
||||
SERVER-REFERRAL data.
|
||||
|
||||
The client will use this referral information to request a chain of
|
||||
cross-realm ticket granting tickets until it reaches the realm of the
|
||||
server, and can then expect to receive a valid service ticket.
|
||||
|
||||
However an implementation should limit the number of referrals that
|
||||
it processes to avoid infinite referral loops. A suggested limit is
|
||||
5 referrals before giving up.
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 9]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
Here is an example of a client requesting a service ticket for a
|
||||
service in realm DEV.EXAMPLE.COM where the client is in
|
||||
ADMIN.EXAMPLE.COM.
|
||||
|
||||
+NC = Canonicalize KDCOption set
|
||||
+PA-REFERRAL = returned PA-SERVER-REFERRAL
|
||||
C: TGS-REQ sname=http/foo.dev.example.com +NC to ADMIN.EXAMPLE.COM
|
||||
S: TGS-REP sname=krbtgt/EXAMPLE.COM@ADMIN.EXAMPLE.COM +PA-REFERRAL
|
||||
containing EXAMPLE.COM as the referred realm with no
|
||||
true-principal-name
|
||||
C: TGS-REQ sname=http/foo.dev.example.com +NC to EXAMPLE.COM
|
||||
S: TGS-REP sname=krbtgt/DEV.EXAMPLE.COM@EXAMPLE.COM +PA-REFERRAL
|
||||
containing DEV.EXAMPLE.COM as the referred realm with no
|
||||
true-principal-name
|
||||
C: TGS-REQ sname=http/foo.dev.example.com +NC to DEV.EXAMPLE.COM
|
||||
S: TGS-REP sname=http/foo.dev.example.com@DEV.EXAMPLE.COM
|
||||
|
||||
Note that any referral or alias processing of the server name in
|
||||
user-to-user authentication should use the same data as client name
|
||||
canonicalization or referral. Otherwise, the name used by one user
|
||||
to log in may not be useable by another for user-to-user
|
||||
authentication to the first.
|
||||
|
||||
|
||||
8. Server Name Canonicalization (Informative)
|
||||
|
||||
No attempt is being made in this document to provide a means for
|
||||
dealing with local-realm server principal name canonicalization or
|
||||
aliasing. The most obvious use case for this would be a hostname-
|
||||
based service principal name ("host/foobar.example.com"), with a DNS
|
||||
alias ("foo") for the server host which is used by the client. There
|
||||
are other ways this can be handled, currently, though they may
|
||||
require additional configuration on the application server or KDC or
|
||||
both.
|
||||
|
||||
|
||||
9. Cross Realm Routing
|
||||
|
||||
The current Kerberos protocol requires the client to explicitly
|
||||
request a cross-realm TGT for each pair of realms on a referral
|
||||
chain. As a result, the client need to be aware of the trust
|
||||
hierarchy and of any short-cut trusts (those that aren't parent-
|
||||
child trusts).
|
||||
|
||||
Instead, using the server referral routing mechanism as defined in
|
||||
Section 7, The KDC will determine the best path for the client and
|
||||
return a cross-realm TGT as the referral TGT, and the target realm
|
||||
for this TGT in the PA-SERVER-REFERRAL of the KDC reply.
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 10]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
If the "canonicalize" KDC option is not set, the KDC SHALL NOT return
|
||||
a referral TGT. Clients SHALL NOT process referral TGTs if the KDC
|
||||
response does not contain the PA-SERVER-REFERRAL padata.
|
||||
|
||||
|
||||
10. Caching Information
|
||||
|
||||
It is possible that the client may wish to get additional credentials
|
||||
for the same service principal, perhaps with different authorization-
|
||||
data restrictions or other changed attributes. The return of a
|
||||
server referral from a KDC can be taken as an indication that the
|
||||
requested principal does not currently exist in the local realm.
|
||||
Clearly, it would reduce network traffic if the clients could cache
|
||||
that information and use it when acquiring the second set of
|
||||
credentials for a service, rather than always having to re-check with
|
||||
the local KDC to see if the name has been created locally.
|
||||
|
||||
Rather than introduce a new timeout field for this cached
|
||||
information, we can use the lifetime of the returned TGT in this
|
||||
case. When the TGT expires, the previously returned referral from
|
||||
the local KDC should be considered invalid, and the local KDC must be
|
||||
asked again for information for the desired service principal name.
|
||||
(Note that the client may get back multiple referral TGTs from the
|
||||
local KDC to the same remote realm, with different lifetimes. The
|
||||
lifetime information must be properly associated with the requested
|
||||
service principal names. Simply having another TGT for the same
|
||||
remote realm does not extend the validity of previously acquired
|
||||
information about one service principal name.) If the client is
|
||||
still in contact with the service and needs to reauthenticate to the
|
||||
same service regardless of local service principal name assignments,
|
||||
it should use the referred-realm and true-principal-name values when
|
||||
requesting new credentials.
|
||||
|
||||
Accordingly, KDC authors and maintainers should consider what factors
|
||||
(e.g., DNS alias lifetimes) they may or may not wish to incorporate
|
||||
into credential expiration times in cases of referrals.
|
||||
|
||||
|
||||
11. Open Issues
|
||||
|
||||
When should client name aliases be included in credentials?
|
||||
|
||||
Should all known client name aliases be included, or only the one
|
||||
used at initial ticket acquisition?
|
||||
|
||||
We still don't discuss what "validation" of the returned information
|
||||
means.
|
||||
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 11]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
12. Security Considerations
|
||||
|
||||
For the AS exchange case, it is important that the logon mechanism
|
||||
not trust a name that has not been used to authenticate the user.
|
||||
For example, the name that the user enters as part of a logon
|
||||
exchange may not be the name that the user authenticates as, given
|
||||
that the KDC_ERR_WRONG_REALM error may have been returned. The
|
||||
relevant Kerberos naming information for logon (if any), is the
|
||||
client name and client realm in the service ticket targeted at the
|
||||
workstation that was obtained using the user's initial TGT.
|
||||
|
||||
How the client name and client realm is mapped into a local account
|
||||
for logon is a local matter, but the client logon mechanism MUST use
|
||||
additional information such as the client realm and/or authorization
|
||||
attributes from the service ticket presented to the workstation by
|
||||
the user, when mapping the logon credentials to a local account on
|
||||
the workstation.
|
||||
|
||||
|
||||
13. Acknowledgments
|
||||
|
||||
Sam Hartman and authors came up with the idea of using the ticket key
|
||||
to encrypt the referral data, which prevents cut and paste attack
|
||||
using the referral data and referral TGTs.
|
||||
|
||||
John Brezak, Mike Swift, and Jonathan Trostle wrote the initial
|
||||
version of this document.
|
||||
|
||||
Karthik Jaganathan contributed to earlier versions.
|
||||
|
||||
|
||||
14. References
|
||||
|
||||
14.1. Normative References
|
||||
|
||||
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
|
||||
Requirement Levels", BCP 14, RFC 2119, March 1997.
|
||||
|
||||
[RFC4120] Neuman, C., Yu, T., Hartman, S., and K. Raeburn, "The
|
||||
Kerberos Network Authentication Service (V5)", RFC 4120,
|
||||
July 2005.
|
||||
|
||||
14.2. Informative References
|
||||
|
||||
[RFC3280] Housley, R., Polk, W., Ford, W., and D. Solo, "Internet
|
||||
X.509 Public Key Infrastructure Certificate and
|
||||
Certificate Revocation List (CRL) Profile", RFC 3280,
|
||||
April 2002.
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 12]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
[RFC4556] Zhu, L. and B. Tung, "Public Key Cryptography for Initial
|
||||
Authentication in Kerberos (PKINIT)", RFC 4556, June 2006.
|
||||
|
||||
[XPR] Trostle, J., Kosinovsky, I., and M. Swift, "Implementation
|
||||
of Crossrealm Referral Handling in the MIT Kerberos
|
||||
Client", Network and Distributed System Security
|
||||
Symposium, February 2001.
|
||||
|
||||
|
||||
Appendix A. Compatibility with Earlier Implementations of Name
|
||||
Canonicalization
|
||||
|
||||
(Remove this section when Microsoft publishes this information in a
|
||||
separate document.)
|
||||
|
||||
The Microsoft Windows 2000 and Windows 2003 releases included an
|
||||
earlier form of name-canonicalization [XPR]. Here are the
|
||||
differences:
|
||||
|
||||
1) The TGS referral data is returned inside of the KDC message as
|
||||
"encrypted pre-authentication data".
|
||||
|
||||
|
||||
|
||||
EncKDCRepPart ::= SEQUENCE {
|
||||
key [0] EncryptionKey,
|
||||
last-req [1] LastReq,
|
||||
nonce [2] UInt32,
|
||||
key-expiration [3] KerberosTime OPTIONAL,
|
||||
flags [4] TicketFlags,
|
||||
authtime [5] KerberosTime,
|
||||
starttime [6] KerberosTime OPTIONAL,
|
||||
endtime [7] KerberosTime,
|
||||
renew-till [8] KerberosTime OPTIONAL,
|
||||
srealm [9] Realm,
|
||||
sname [10] PrincipalName,
|
||||
caddr [11] HostAddresses OPTIONAL,
|
||||
encrypted-pa-data [12] SEQUENCE OF PA-DATA OPTIONAL
|
||||
}
|
||||
|
||||
2) The preauth data type definition in the encrypted preauth data is
|
||||
as follows:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 13]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
PA-SVR-REFERRAL-INFO 20
|
||||
|
||||
PA-SVR-REFERRAL-DATA ::= SEQUENCE {
|
||||
referred-name [1] PrincipalName OPTIONAL,
|
||||
referred-realm [0] Realm
|
||||
}}
|
||||
|
||||
3) When PKINIT ([RFC4556]) is used, the NT-ENTERPRISE client name is
|
||||
encoded as a Subject Alternative Name (SAN) extension [RFC3280] in
|
||||
the client's X.509 certificate. The type of the otherName field
|
||||
for this SAN extension is AnotherName [RFC3280]. The type-id
|
||||
field of the type AnotherName is id-ms-sc-logon-upn
|
||||
(1.3.6.1.4.1.311.20.2.3) and the value field of the type
|
||||
AnotherName is a KerberosString [RFC4120]. The value of this
|
||||
KerberosString type is the single component in the name-string
|
||||
[RFC4120] sequence for the corresponding NT-ENTERPRISE name type.
|
||||
|
||||
In Microsoft's current implementation through the use of global
|
||||
catalogs any domain in one forest is reachable from any other domain
|
||||
in the same forest or another trusted forest with 3 or less
|
||||
referrals. A forest is a collection of realms with hierarchical
|
||||
trust relationships: there can be multiple trust trees in a forest;
|
||||
each child and parent realm pair and each root realm pair have
|
||||
bidirectional transitive direct rusts between them.
|
||||
|
||||
While we might want to permit multiple aliases to exist and even be
|
||||
reported in AD-LOGIN-ALIAS, the Microsoft implementation permits only
|
||||
one NT-ENTERPRISE alias to exist, so this question had not previously
|
||||
arisen.
|
||||
|
||||
|
||||
Appendix B. Document history
|
||||
|
||||
[REMOVE BEFORE PUBLICATION.]
|
||||
|
||||
09 Changed to EXAMPLE.COM instead of using Morgan Stanley's domain.
|
||||
Rewrote description of existing practice. (Don't name the lookup
|
||||
table consulted. Mention that DNS "canonicalization" is contrary
|
||||
to [RFC4120].) Noted Microsoft behavior should be moved out into
|
||||
a separate document. Changed some second-person references in the
|
||||
introduction to identify the proper parties. Changed PA-CLIENT-
|
||||
CANONICALIZED to use a separate type for the actual referral data,
|
||||
add an extension marker to that type, and change the checksum key
|
||||
from the "returned session key" to the "AS reply key". Changed
|
||||
AD-LOGIN-ALIAS to contain a sequence of names, to be contained in
|
||||
AD-KDC-ISSUED instead of AD-IF-RELEVANT, and to drop the no longer
|
||||
needed separate checksum. Attempt to clarify the cache lifetime
|
||||
of referral information.
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 14]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
08 Moved Microsoft implementation info to appendix. Clarify lack of
|
||||
local server name canonicalization. Added optional authz-data for
|
||||
login alias, to support user-to-user case. Added requested-
|
||||
principal-name to ServerReferralData. Added discussion of caching
|
||||
information, and referral TGT lifetime.
|
||||
07 Re-issued with new editor. Fixed up some references. Started
|
||||
history.
|
||||
|
||||
|
||||
Authors' Addresses
|
||||
|
||||
Kenneth Raeburn
|
||||
Massachusetts Institute of Technology
|
||||
77 Massachusetts Avenue
|
||||
Cambridge, MA 02139
|
||||
US
|
||||
|
||||
Email: raeburn@mit.edu
|
||||
|
||||
|
||||
Larry Zhu
|
||||
Microsoft Corporation
|
||||
One Microsoft Way
|
||||
Redmond, WA 98052
|
||||
US
|
||||
|
||||
Email: lzhu@microsoft.com
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 15]
|
||||
|
||||
Internet-Draft KDC Referrals March 2007
|
||||
|
||||
|
||||
Full Copyright Statement
|
||||
|
||||
Copyright (C) The IETF Trust (2007).
|
||||
|
||||
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, THE IETF TRUST 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
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
|
||||
Acknowledgment
|
||||
|
||||
Funding for the RFC Editor function is provided by the IETF
|
||||
Administrative Support Activity (IASA).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Raeburn & Zhu Expires September 6, 2007 [Page 16]
|
||||
|
Reference in New Issue
Block a user