GROBJ BOF B. Carpenter, Ed.
Internet-Draft Univ. of Auckland
Intended status: Standards Track M. Boucadair
Expires: April 23, 2010 France Telecom
J. Halpern
Ericsson
S. Jiang
Huawei Technologies Co., Ltd
K. Moore
Network Heretics
October 20, 2009
A Generic Referral Object for Internet Entities
draft-carpenter-behave-referral-object-01
Status of this Memo
This Internet-Draft is submitted to IETF in full conformance with the
provisions of BCP 78 and 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 April 23, 2010.
Copyright Notice
Copyright (c) 2009 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents in effect on the date of
publication of this document (http://trustee.ietf.org/license-info).
Please review these documents carefully, as they describe your rights
Carpenter, et al. Expires April 23, 2010 [Page 1]
Internet-Draft Generic Referral Object October 2009
and restrictions with respect to this document.
Abstract
The purpose of a referral is to enable a given entity in a multiparty
application to pass information to another party. This memo
specifies a Generic Referral Object (GRO) to be used in the context
of referrals. The proposed object is compact and is application-
independent. Both IPv4 and IPv6 schemes are supported, as well as
upper layer identifiers. Additional information to characterise an
enclosed reference is also described. To allow proper interpretation
of referrals, a new notion of scope identifiers is introduced.
Table of Contents
1. Introduction and Motivation . . . . . . . . . . . . . . . . . 3
1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 6
1.2. Normative Notation . . . . . . . . . . . . . . . . . . . . 6
2. Summary of Requirements . . . . . . . . . . . . . . . . . . . 6
3. Referral Semantics and Scope Identifiers . . . . . . . . . . . 7
4. Generic Referral Object Format . . . . . . . . . . . . . . . . 11
4.1. End of Qualifiers (EOQ) . . . . . . . . . . . . . . . . . 12
4.2. IPv4 and IPv6 Addresses (references) . . . . . . . . . . . 12
4.3. FQDN (reference) . . . . . . . . . . . . . . . . . . . . . 13
4.4. HIT (reference) . . . . . . . . . . . . . . . . . . . . . 13
4.5. HI (reference) . . . . . . . . . . . . . . . . . . . . . . 13
4.6. IPv4 and IPv6 Masks (qualifiers) . . . . . . . . . . . . . 13
4.7. Ref_lifetime (qualifier) . . . . . . . . . . . . . . . . . 13
4.8. Ref_source (qualifier) . . . . . . . . . . . . . . . . . . 14
4.9. Ref_scope (qualifier) . . . . . . . . . . . . . . . . . . 14
4.10. ScopeID (qualifier) . . . . . . . . . . . . . . . . . . . 15
4.11. Port_number (qualifier) . . . . . . . . . . . . . . . . . 15
4.12. Port_range_contig (qualifier) . . . . . . . . . . . . . . 16
4.13. Transport_protocol (qualifier) . . . . . . . . . . . . . . 16
4.14. Port_source (qualifier) . . . . . . . . . . . . . . . . . 16
4.15. Extensibility . . . . . . . . . . . . . . . . . . . . . . 16
5. Security Considerations . . . . . . . . . . . . . . . . . . . 17
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 18
8. Change log . . . . . . . . . . . . . . . . . . . . . . . . . . 19
9. References . . . . . . . . . . . . . . . . . . . . . . . . . . 19
9.1. Normative References . . . . . . . . . . . . . . . . . . . 19
9.2. Informative References . . . . . . . . . . . . . . . . . . 19
Appendix A. Example Use Cases . . . . . . . . . . . . . . . . . . 21
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 22
Carpenter, et al. Expires April 23, 2010 [Page 2]
Internet-Draft Generic Referral Object October 2009
1. Introduction and Motivation
A frequently occurring situation is that one entity A connected to
the Internet (or to some private network using the Internet protocol
suite) needs to inform another entity B how to reach either A itself
or some third-party entity C. This is known as a referral.
In the original design of the Internet, IP addresses were global,
unique, and quasi-permanent. Also any differentiation beyond that
provided by an IP address was done by protocol and port numbers.
Referrals were therefore performed simply by passing an IP address
and possibly protocol and port numbers. In fact simple referrals
(the first case above, sometimes called first-party referrals) were
never needed since B could simply use A's address. Third-party
referrals were trivial: A would tell B about C's address. Thus, it
became common practice to pass raw addresses between entities. A
classical example is the FTP PORT command [RFC0959].
Unfortunately, this simple approach to referrals often fails in
today's Internet. As has been known for some time [RFC2101],
addresses no longer all have global scope, often have limited
reachability, and may have limited lifetime. It is no longer
reasonable to assume that a host with a fixed location has a fixed
address, or even a stable address.
We also encounter multi-interfaced hosts whose reachability is bound
to a particular (logical/physical) interface. Furthermore, in the
context of IPv4 address exhaustion, several solutions have emerged to
share a single public IPv4 address between several customers
simultaneously. Consequently, an IPv4 address often no longer
identifies a single customer/user/host. Other information (e.g.,
port range) is required to identify unambiguously a given customer/
user/host.
Both addresses and port numbers may be different on either side of a
NAT or some other middlebox [RFC3234], and firewalls may block them.
It is no longer reasonable to assume that an address for host H,
which allows a given peer to reach that host in one location, also
works from a different location - even if H is reachable from the
second location. Also, the Internet now has two co-existing address
formats for IPv4 and IPv6. Sending an out-of-scope or expired
address, or one of the wrong format, as a referral will fail.
In some cases, this problem may be readily solved by passing a Fully
Qualified Domain Name (FQDN) instead of an IP address. Indeed, that
is an architecturally preferred solution [RFC1958]. However, it is
not sufficient in many cases of dynamic referrals. Experience shows
that an application cannot use a domain name in order to reliably
Carpenter, et al. Expires April 23, 2010 [Page 3]
Internet-Draft Generic Referral Object October 2009
find useable address(es) of an arbitrary peer. Domain names work
fairly well to find the addresses of public servers, as in web
servers or SMTP servers, because operators of such servers take pains
to make sure that their domain names work. But DNS records are not
as reliably maintained for arbitrary hosts such as might need to be
contacted in peer-to-peer applications, or for servers within
corporate networks. Many small networks do not even maintain DNS
entries for their hosts, and for some networks that do list local
hosts in DNS, the listings may well be unusable from a remote
location, because of two-faced DNS, or because the A record contains
a private address. These cases may even be intentional as part of a
security ring-fence, where w3.example.com only resolves within the
corporate boundary, and/or resolves to IP addresses which are only
reachable within the corporate administrative boundaries. In such
contexts, incoming connections are usually filtered by the corporate
firewall.
Furthermore, an FQDN may not be sufficient to establish successful
communications involving heterogeneous peers (i.e., IPv4 and IPv6)
since A and AAAA records may not be consistently provisioned. There
are known cases where a server has one name that produces an A record
(e.g., www.example.com) and another name that produces an AAAA record
(e.g., ipv6.example.com).
In such cases, an IP address either cannot be derived from an FQDN,
or if so derived, cannot be accessed from an arbitrary location in
the Internet.
A related problem is that an application does not have a reliable way
of knowing its own domain name - or to be more precise, a way of
knowing a domain name that will allow the application to be reached
from another location.
There are wider systemic problems with the DNS as a reliable way to
find a useable address, which are somewhat out of scope here, but can
be summarised:
o In large networks, it is now quite common that the DNS
administrator is out of touch with the applications user or
administrator, and as a result, that the DNS is out of sync with
reality.
o DNS was never designed to accommodate mobile or roaming hosts,
whose locator may change rapidly.
o DNS has never been satisfactorily adapted to isolated,
transiently-connected, or ad hoc networks.
o It is no longer reasonable to assume that all addresses associated
with a DNS name are bound to a single host. One result is that
the DNS name might suffice for an initial connection, but a
specific address is needed to rebind to the same peer, say, to
Carpenter, et al. Expires April 23, 2010 [Page 4]
Internet-Draft Generic Referral Object October 2009
recover from a broken connection.
o It is no longer reasonable to assume that a DNS query will return
all usable addresses for a host.
For all the above reasons, the problem of address referrals cannot be
solved simply by recommending the use of FQDNs instead. The
guideline in [RFC1958] is in fact too simple for today's network.
Something more elaborate than an IP address or an FQDN appears to be
needed in the general case of application referrals.
The first motivation for this draft is the observation that unless
the parties involved have reached an understanding about the scope,
lifetime, and format of the elements in a referral through some other
means, that information must be passed with the referral. This is
required so that the receiving entity can determine whether or not
the referral is useful. The referral therefore needs to consist of a
fully-fledged data structure.
When a referral fails, good design suggests that the receiving entity
should attempt to correct the situation. For example, if
communication fails to be established using an IP address, it would
often be appropriate to attempt a DNS lookup, despite the
difficulties mentioned above. The second motivation for this draft
is that it may be helpful to the entity receiving a referral to also
receive information about the source of the referral, such as an
FQDN, if that is known to the sender of the referral. The receiving
entity can then attempt to recover a valid address (and possibly port
number) for the referred entity.
The third motivation is to allow a referral to contain alternatives
to an IP address or an FQDN, when any such alternatives exist.
We observe that we have outlined two separate requirements above: the
need to define address scope more precisely, and the need for a
generic referral object. Below, the two requirements are made more
precise and a GRO format is defined.
It should be noted that partial or application-specific solutions to
this problem abound. A non-normative Appendix gives examples, in the
form of use cases. The objective of this specification is to define
a generic and extensible solution, to allow more robust application
design. It is an open question whether existing applications will
benefit from retro-fitting GROs, or whether they will mainly be of
use for new applications.
Carpenter, et al. Expires April 23, 2010 [Page 5]
Internet-Draft Generic Referral Object October 2009
1.1. Terminology
This document makes use of the following terms:
o "Generic Referral Object (GRO)": the data object defined by this
specification.
o "Entity": we use this rather than "application" to describe any
software component embedded in a host, not just a specific
application, that sends, receives or makes use of GROs. Also, in
case of dynamic load sharing or failover, an entity might even
migrate between hosts.
o "Referral": the act of one entity informing another entity how to
contact a specific entity.
o "Reference": the actual data (name, address, identitifier,
locator, pointer, etc.) that is the basis of a referral.
o "Scope Identifier (ScopeID): an identifier for the scope of
reachability of a reference.
o "Qualifier": a data item that gives additional information about a
Reference.
o "Referring entity": the entity that sends a referral.
o "Receiving entity": the entity that receives a referral.
o "Referenced entity": the entity described in a GRO.
1.2. Normative Notation
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].
2. Summary of Requirements
A GRO should be self-describing; that is to say, even if it is
forwarded several times across the network, the ultimate receiving
entity should be able to extract and interpret all the information
inserted by the original referring entity.
A GRO should be compact (i.e., binary encoded) and designed for
efficient processing.
The GRO format must not be specific to a given IP version and must
not be application-specific.
A GRO should contain information that the referring entity can
provide about the scope, lifetime, format and source of the referral,
encoded in a universal format.
The GRO format should be extensible with well-defined backwards
compatibility.
Carpenter, et al. Expires April 23, 2010 [Page 6]
Internet-Draft Generic Referral Object October 2009
A damaged GRO would be useless. However, to maintain efficiency,
intrinsic error detection or correction for GROs should not be
mandatory. Therefore, GROs SHOULD be sent over a channel supporting
error detection or correction.
A forged GRO would be at least as dangerous as a forged IP address.
However, to maintain efficiency, intrinsic cryptographic
authentication of GROs should not be mandatory. The use of an
authenticated channel to transmit GROs is RECOMMENDED.
An intercepted GRO would be at least as revelatory as an intercepted
IP address. However, to maintain efficiency, intrinsic encryption of
GROs should not be mandatory. The use of an encrypted channel to
transmit GROs is RECOMMENDED.
3. Referral Semantics and Scope Identifiers
The principal purpose of a referral is to enable one entity in a
multi-party application to pass information to another party involved
in the same application. This specification makes no assumptions
about whether the entities are acting as clients, servers, peers,
super-nodes, relays, proxies, etc., as far as the application is
concerned. Neither does it take a position as to how the various
entities become aware of the need to send a referral; this depends
entirely on the structure of the application.
It is the responsibility of the referring entity to construct a GRO
on the basis of information in its possession. It is the
responsibility of the receiving entity to interpret and check this
information. Due to the fluidity of connectivity in today's
Internet, the referring entity cannot guarantee that the referenced
entity can be reached. This can only be checked by the receiving
entity. In the event of a reachability problem, information in the
GRO may assist the receiving entity to find an alternative path.
Since the most fundamental quantity likely to be conveyed in a GRO is
an IP address, (and possibly a port number) its scope is a key
question. Address scope is not a simple concept, as shown by the
discussion in [RFC4007] and the practical difficulties caused by
[RFC3484]. Even the concept of link-local scope is complicated by
the existence of multi-link subnets [RFC4903]. For the purpose of
referrals, it seems that previous formalisations of the concept of
scope are inadequate. Assuming that a GRO is trustworthy, one
question that a receiving entity must answer is: "can the address in
this GRO be reached from here?" That question is not answered by
knowing only the scope (in the sense of [RFC4007]) as defined at the
location of the referring entity. For that reason, scope is
Carpenter, et al. Expires April 23, 2010 [Page 7]
Internet-Draft Generic Referral Object October 2009
represented in a new way in GROs. Firstly, the scope is qualified
(to the best of the referring entity's knowledge) as follows:
o Null. The address is known not to be applicable outside the
referring host (e.g., a loopback address). This option is
provided mainly for completeness. There is no value in such a
GRO, and for privacy reasons it should not be communicated anyway.
o Link. Apart from the standard Ethernet-like view of link
locality, this scope would also apply to point-to-point links and
to fragments of a multi-link subnet. Although on-link referrals
should be trivial, this case is included to allow for uniform
design of applications utilising GROs, so that link-local does not
become a special case.
o Limited. The address has applicability beyond the link, but it is
known not to have global applicability. Examples include IPv4
private addresses [RFC1918] and IPv6 Unique Local Addresses
(ULAs)[RFC4193]. Other cases include addresses on subnets which
the referring entity knows to be obstructed by firewalls, network
address translators, or other barriers to transparency [RFC2775].
A typical case is the set of subnets sharing a single set of
border routers connecting them to the Internet.
o Global. The address has applicability beyond the link, and is
believed to have global applicability within its address family.
However, particularly in the case of limited scope, this is
insufficient for the receiving entity to decide whether the address
is applicable in the receiving entity's context. The scopes above
are described as if they were a set of concentric circles, but
reality is more complex, and limited scopes might overlap each other
in an arbitrary way, for example when multiple VPNs are formed. A
case in point is a VPN constructed between two independent sites,
over which only those two sites' ULAs are routed. This would allow a
complex pattern of overlapping scopes. For example, hosts in site A
might potentially have addresses in three different scopes (global,
Site_A_only, ULA_A+B). Similarly, site B might also recognize three
scopes (global, Site_B_only, ULA_A+B). Which hosts can send packets
to each other will depend on the combination of addresses and scopes
available. For example, a host which only has an address in scope
Site_A_only cannot send a packet to a host which only has an address
in scope ULA_A+B. Hosts in scope ULA_A+B can send packets between
sites A and B over the VPN. This can readily be encoded in routing
configurations, but application software is generally unaware of it.
Thus, a referring entity may or may not be aware that the receiving
entity and the referenced entity are within a link scope or limited
scope that does not contain the referring entity. Therefore, a GRO
may also include a scope identifier (ScopeID), which is an arbitrary
label for a region of the network within which certain link or
limited scope addresses are applicable.
Carpenter, et al. Expires April 23, 2010 [Page 8]
Internet-Draft Generic Referral Object October 2009
We cannot assume that the referring entity knows the scopes that are
accessible to the receiving entity. For this reason, all available
information SHOULD be included in a GRO.
[[ Discussion invited: Should we also define optional preference
information for each reference in a GRO, or alternatively require
that references be listed in order of preference? Here is some
tentative text, not followed up in the strawman GRO format below. ]]
A preference order (or reachability trust level?) MAY be associated
with enclosed objects but the receiving entity is not obliged to
follow that order since this may induce conflicts with local policies
(sometime on per interface basis).
There needs to be a high level of assurance that ScopeIDs are unique,
or at least that a GRO will never be forwarded outside a region in
which ScopeIDs are unique. Also, all referring and receiving
entities need to be aware of the ScopeID(s) that apply to them.
However, it is clearly undesirable to create a new global
registration scheme for ScopeIDs.
The delimiter of a limited scope will in many cases be the device
(firewall or NAT) that obstructs transparency. A tempting solution
would be to use some unique identifier of that device as the unique
ScopeID. Unfortunately, this cannot be an IP address of the device,
since in the case of nested NATs, all its addresses may be ambiguous.
Neither can we rely on such a device having its own FQDN, or on that
FQDN being known to all entities within the scope concerned.
Finally, some limited scopes may not be hidden behind a single such
device; for example, a limited scope might consist of a company's
network and selected VPN connections to subsets of several business
partners' networks. Alternatively, multiple limited scopes might be
hidden behind the same device. Device addresses are therefore not
suitable as ScopeIDs.
Therefore, a limited scope can best be defined as whatever set of
referring and receiving entities have been configured (statically or
dynamically) to accept a given ScopeID in some unambiguous namespace
(see Section 4.10).
Methods for configuring, advertising and discovering ScopeIDs are not
defined in this document. However, in their absence, it is extremely
hard for receiving entities to interpret and use information about
limited scopes. To the extent possible, all entities involved in
referrals should determine what scope is shared between the referred
entity and the receiving entity, by any means. Those means are not
covered in this document, but may include use of external services,
agreement on scope identifiers, or direct negotiation.
Carpenter, et al. Expires April 23, 2010 [Page 9]
Internet-Draft Generic Referral Object October 2009
o If shared scope (or set of scopes) is determined, a referral
should ideally only include information useful in that scope or
set of scopes.
o If shared scope is uncertain, a referral should include all
information that might be useful, taking privacy considerations
into account.
In general, the referring entity cannot know the scope in which the
GRO will be interpreted. For example, the initial receiving entity
may itself be behind a NAT, unknown to the referring entity, or the
receiving entity may send the GRO onwards to another host in yet
another scope. In practice, we have to leave the receiver to decide
whether certain information is useful or not. In the case of a
ScopeID in particular, the referring entity is not required to know
which ScopeIDs apply to the receiving entity.
Discovery or negotiation of ScopeIDs between referring, referenced
and receiving entities is certainly a possibility, but may be
expensive, and is not assumed by this specification.
A referring entity may obtain the address and port number for the
referenced entity in various ways, and knowledge about this may help
the receiving entity when combined with scope information. For
example, if the receiving entity is aware that the address has been
translated, and that it has global scope, it may choose to use it
without further checks. If it is not marked as translated, and has
limited scope, the receiving entity may then verify whether it has a
suitable ScopeID.
To enable such logic, a GRO may describe the source of an address or
port number. How knowledge of this source is obtained is outside the
scope of the present specification, but ICE [I-D.ietf-mmusic-ice] is
an example method. It is also out of scope here to describe exactly
how the receiving entity uses the information; for example GRO
semantics do not include or imply preferences or priorities when
multiple addresses are provided. The receiving entity may choose to
use a predefined policy, apply general logic as sketched in the
previous paragraph, or follow application-specific logic, all based
on the data provided in a GRO.
Obviously, a GRO is no use unless it contains at least one item that
can be used to find a path to the referred entry. One option would
be to make the presence of at least one IP address mandatory.
However, there are alternatives, the most obvious one being an FQDN.
Any form of identifier-locator separation, with HIP [RFC5201] as an
example, may also offer an alternative. Therefore, we do not require
a GRO to include an IP address, even though its inclusion is a very
likely case.
Carpenter, et al. Expires April 23, 2010 [Page 10]
Internet-Draft Generic Referral Object October 2009
4. Generic Referral Object Format
[[ Note: This section is a strawman approach to make the ideas more
concrete. It is entirely open for discussion. ]]
A GRO is composed of a sequence of binary-encoded type-length-value
fields (TLVs) transmitted in network byte order. The TLV format is
as follows:
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+..
| GRType |Q| GRLength | GRValue ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+..
A GRO MUST include at least one reference that allows a receiving
entity to attempt to establish a path to the referred entity. A
typical case is an IPv4_address or IPv6_address TLV. Multiple
references may be present, and their order is not significant.
Apart from this, all TLVs are OPTIONAL.
[[ Discusssion invited: At the moment, there is no total length field
or end flag for the whole GRO, assuming that GROs will be sent in
some kind of container. Opinions among the authors vary about
whether this is OK. ]]
GRType: Specifies the type of the current TLV. GRType is encoded in
7 bits. The initially specified types are, in decimal:
0: EOQ.
1: IPv4_address.
2: IPv6_address.
3: FQDN.
4: HIT.
5: HI.
65: IPv4_mask.
66: IPv6_mask.
67: Ref_lifetime.
68: Ref_source.
69: Ref_scope.
70: ScopeID.
71: Port_number.
72: Port_range_contig.
73: Transport_protocol.
Carpenter, et al. Expires April 23, 2010 [Page 11]
Internet-Draft Generic Referral Object October 2009
74: Port_source.
127: reserved.
A receiving entity MUST silently ignore any TLV with an unknown or
reserved GRType.
Each TLV is classified semantically as a reference or as a qualifier.
A qualifier provides extra information about a reference or another
qualifier..
[[ Discusssion invited: Do we need a syntactic method of
distinguishing references from qualifiers? Since unknown TLVs are
always discarded, why would that be needed? ]]
Q bit: If this bit is set to 1, the current TLV is followed by one or
more TLVs that qualify it.
GRLength: The length in bytes of the GRValue field. Thus, the total
length of the TLV is GRLength+2 bytes.
GRValue: The content and encoding depend on GRType. Any padding
required to fill an integral number of bytes MUST consist of a
sequence of zero bits at the end of the content.
4.1. End of Qualifiers (EOQ)
This TLV follows the last TLV that qualifies a TLV whose Q bit is set
to 1. Its GRLength must be set to 0.
The Q bit and EOQ MAY be used recursively, so that qualifiers may
themselves be qualified if that proves to be useful.
Example (GT=GRType):
GT Q|GT Q|GT Q|GT Q|GT Q|GT Q|GT Q|GT Q
A 1|xx 0|xx 0|B 1|xx 0|xx 0|EOQ 0|EOQ 0
<-------> Qualifiers of B
<----------------------------> Qualifiers of A
The Q bit MUST NOT be set in an EOQ TLV.
4.2. IPv4 and IPv6 Addresses (references)
IPv4 and IPv6 addresses are encoded in their normal binary form, with
GRLength being 4 and 16 respectively.
When multiple addresses are provided, their order does not imply an
order of preference. The receiving entity SHOULD apply a local
Carpenter, et al. Expires April 23, 2010 [Page 12]
Internet-Draft Generic Referral Object October 2009
policy and mechanism to choose between alternative addresses, using
other information included in the GRO appropriately. This document
does not describe such policies and mechanisms, which could be
application specific.
4.3. FQDN (reference)
The Fully Qualified Domain Name of the referenced entity in ASCII
format according to [RFC1035].
The GRLength is variable (maximum 63).
[[ Discussion invited: Is there also value in a generic URI item?
See section on Extensibility below for a related discussion point. ]]
4.4. HIT (reference)
The Host Identity Tag of the referenced entity [RFC5201].
The GRLength must be set to 16.
4.5. HI (reference)
The Host Identifier of the referenced entity [RFC5201].
The GRLength is variable.
[[ Discussion invited: Is this necessary in order to run the HIP base
exchange? The HI is a large object to include in a GRO. Also, do we
need a more precise definition of what the HI is (see section 5.2.8
of RFC5201)? ]]
4.6. IPv4 and IPv6 Masks (qualifiers)
IPv4 and IPv6 masks are encoded in their normal binary form, with
GRLength being 4 and 16 respectively.
4.7. Ref_lifetime (qualifier)
Remaining lifetime in seconds of the reference that it qualifies,
encoded as a 32 bit binary number in the format of an IPv6 Valid
Lifetime [RFC4861]. GRLength must be set to 4.
If the lifetime is absent, or if it indicates an infinite lifetime
[RFC4861], the receiving entity MUST assign a lifetime of one day to
the corresponding reference.
The receiving entity MUST count down a received lifetime
Carpenter, et al. Expires April 23, 2010 [Page 13]
Internet-Draft Generic Referral Object October 2009
appropriately. If the GRO is forwarded to an additional receiving
entity, the lifetime MUST be updated appropriately.
[[ Discussion invited: would it be better to specify an expiry
timestamp? ]]
[[ Discussion invited: is the default of one day reasonable? ]]
4.8. Ref_source (qualifier)
This is a single byte indicating the source of the reference that it
qualifies. GRLength must be set to 1. The following values may be
used:
0: source was static configuration
1: source was DNS lookup
2: source was DHCP or DHCPv6
3: source was SLAAC
4: relayed address (e.g. from TURN [I-D.ietf-behave-turn] or
SOCKS)
5: translated address. ("server reflexive" in ICE
[I-D.ietf-mmusic-ice] terminology.)
6: source was DNS64 synthesis.
A receiving entity MUST silently ignore unknown values.
4.9. Ref_scope (qualifier)
This is a single byte indicating the scope of the reference that it
qualifies. GRLength must be set to 1. The scopes are explained in
Section 3. The currently defined values are as follows:
0: Null
1: Link
2: Limited
7: Global. Note that some unused values precede this value, in
case of future changes.
A receiving entity MUST silently ignore unknown values.
References qualified with the Null value SHOULD NOT be sent and MUST
be silently ignored by a receiving entity.
When a receiving entity receives a reference qualified with a Link or
Limited Ref_scope, and without a ScopeID, it should take locally
defined steps to check whether the reference is in fact within a
reachable scope.
Carpenter, et al. Expires April 23, 2010 [Page 14]
Internet-Draft Generic Referral Object October 2009
4.10. ScopeID (qualifier)
A ScopeID, if present, is a label for the scope of the reference that
it qualifies.
When a receiving entity receives a reference qualified with a
Ref_scope and a ScopeID, it should verify the ScopeID against a list
of ScopeIDs known to be reachable and if not, take other locally
defined steps to check whether the reference is in fact within a
reachable scope.
ScopeIDs should be reasonably certain to be unique, yet require no
new system for central administration.
[[ Discusssion invited: It isn't clear to the authors that a single
syntax for ScopeID is sufficient. Should we allow for subtypes, so
that (e.g.) ULA format and FQDN format would both be possible?
Should we consider a URI format? The following proposal is
tentative. ]]
The proposed method is that each organisation that needs to define a
ScopeID will first generate a ULA prefix as defined in [RFC4193], and
then form a specific IPv6 address using that ULA prefix. It is
RECOMMENDED to form an address using a valid universal EUI-64
interface identifier according to [RFC4291], and this EUI-64
identifier MAY be the same one as used in the RFC4193 procedure.
The GRLength must be set to 16. The GRValue is the ScopeID in the
format of an IPv6 address, although it will be treated entirely as an
opaque binary value in the GRO referring and receiving entities.
4.11. Port_number (qualifier)
The inbound TCP/UDP/SCTP/DCCP port number associated with the
reference that it qualifies. The port number may be bound to a
specific transport protocol.
The GRLength must be set to 2.
The GRValue is a 16-bit port number.
This TLV MAY be qualified by Transport_protocol or Port_source TLVs.
An IP address may be qualified by zero, one or several Port_number
TLVs.
Carpenter, et al. Expires April 23, 2010 [Page 15]
Internet-Draft Generic Referral Object October 2009
4.12. Port_range_contig (qualifier)
A contiguous range of TCP/UDP/SCTP/DCCP port numbers associated with
the reference that it qualifies. The port range may be bound to a
specific transport protocol (see Transport_protocol item).
The GRLength is 4.
The GRValue is two 16-bit port numbers, defining the lower and upper
bounds of the port range.
This TLV MAY be qualified by Transport_protocol or Port_source TLVs.
An IP address may be qualified by zero, one or several
Port_range_contig TLVs.
Defining this TLV is motivated by the need to define a compact object
instead of listing all port numbers that are part of a port range
[I-D.boucadair-port-range], [I-D.ymbk-aplusp]. Use cases for this
qualifier still need to be defined.
4.13. Transport_protocol (qualifier)
This is a single byte indicating the IPv4 protocol number or IPv6
Next Header value used with the reference or Port_number or
Port_number_contig that it qualifies. GRLength must be set to 1.
A receiving entity MUST silently ignore unknown values.
4.14. Port_source (qualifier)
This is a single byte indicating the source of the Port_number that
it qualifies. GRLength must be set to 1. Accepted values are:
0: direct (i.e. known to be the original port number used by the
referenced entity)
4: relayed port (e.g. from TURN [I-D.ietf-behave-turn] or SOCKS)
5: translated port. ("server reflexive" in ICE
[I-D.ietf-mmusic-ice] terminology.)
[[ Discussion invited: Is this distinction usfeul? ]]
The assigned values were chosen to align with those for Ref_source.
A receiving entity MUST silently ignore unknown values.
4.15. Extensibility
Additional GRTypes may be assigned in the range up to 126 by IANA
action as defined in Section 6. The documentation of a new GRType
must specify its name, define its GRLength, and describe the contents
Carpenter, et al. Expires April 23, 2010 [Page 16]
Internet-Draft Generic Referral Object October 2009
and meaning of its GRValue, including whether it is a reference or a
qualifier.
This extensibility is not intended to allow a GRO to grow enough to
contain every possible kind of application-layer identifier that
could ever be used in a referral, because then it would be too hard
to write a generic "please connect me to the peer at this GRO"
function. Thus, additional GRTypes SHOULD NOT be assigned except for
generic purposes that will apply to multiple applications.
Similarly, additional sub-types for Address_source, Address_scope,
Transport_protocol, and Port_source SHOULD NOT be assigned except for
generic purposes.
[[ Discussion invited: Sheng Jiang suggested that there should be a
generic 'Application-specific ID' GRType, for example in URI format.
A problem with this is that it might end up as a catch-all like a DNS
TXT record, and threaten interoperability as a result. ]]
The reserved GRType value 127 is intended to be used to define an
extended range of GRTypes in the highly unlikely event that this
becomes necessary.
5. Security Considerations
It should be noted that GROs cannot function as a way to nullify the
effect of a firewall or any other security mechanism. If the
receiving entity chooses a particular reference in the GRO and
attempts to send packets to the corresponding IP address, whether
they are delivered or not will depend on the existing security
mechanisms, whatever they may be.
Nevertheless, if a site security policy requires it, certain
references MAY be excluded from GROs sent to certain destinations.
This would require a security policy mechanism to be added to the
process of generating GROs and is not further specified here.
Forged or intercepted GROs would enable a wide variety of attacks.
Although not fundamentally different from attacks based on forged or
observed IP addresses or FQDNs, no doubt GROs would allow such
attacks to be more ingenious, simply because they provide more
information than an address or FQDN alone. As noted in Section 2,
GROs SHOULD be transmitted through authenticated and encrypted
channels. Since this is a requirement of the channel and not of the
GRO, and the channel used depends on a specific use case, it is not
further elaborated here.
Conceivably, an extension to the GRO format could be defined which
Carpenter, et al. Expires April 23, 2010 [Page 17]
Internet-Draft Generic Referral Object October 2009
would allow it to carry security information (for example, some sort
of handle or nonce to authorise firewall penetration). Any such
extension MUST be adequately encrypted, in such a way that only a
receiving entity in possession of a given key can decrypt it. This
is necessary even if the GRO is transmitted through a secure channel.
GROs are variable length objects with no defined maximum length. It
is possible that a malicious GRO could be constructed, with harmful
code masquerading as legitimate or unknown GRType items. All
implementations of receiving entities MUST guard against buffer
overflows, as well as obeying the rules about ignoring unknown values
in Section 4.
Unknown TLVs in GROs are to be ignored by the receiving entity.
However, GROs may be forwarded to additional receiving entities, in
which case the unknown TLVs will be forwarded too. A receiving
entity MAY remove unknown TLVs before forwarding a GRO, as a
precaution against malicious use.
GROs raise potential privacy issues, which are not explored in this
document. For example, in the SIP context, mechanisms such as
[RFC3323] and [I-D.ietf-sip-ua-privacy] are available to hide
information that might identify end-points. Usage scenarios for GROs
MUST ensure that they do not unintentionally defeat privacy
solutions.
6. IANA Considerations
IANA is requested to established a Generic Referral Object (GRO)
registry, containing sub-registries for GRType, Ref_source,
Ref_scope, and Port_source. The range and initial assignments are
defined in Section 4.
New values in this registry are to be assigned according to the
Specification Required policy defined in [RFC5226], which implies
review by a Designated Expert according to Section 4.15.
[[ Discussion invited: It has been suggested to define a (small)
registry for Global ScopeIDs, instead of assuming that "global" for
IPv4 and IPv6 is unambiguous. ]]
7. Acknowledgements
This document originated from a Thai Lunch BOF (a variant of a Bar
BOF) at IETF74. Scott Brim contributed substantially to the first
version. Valuable comments and contributions were made by Dan Wing,
Carpenter, et al. Expires April 23, 2010 [Page 18]
Internet-Draft Generic Referral Object October 2009
Andrew Sullivan, ...
This document was produced using the xml2rfc tool [RFC2629].
8. Change log
draft-carpenter-referral-object-00: original version, 2009-05-11
draft-carpenter-referral-object-01: updated after discussion in
BEHAVE WG at IETF75 and on GROBJ BOF mailing list, 2009-10-20
9. References
9.1. Normative References
[RFC1035] Mockapetris, P., "Domain names - implementation and
specification", STD 13, RFC 1035, November 1987.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC4193] Hinden, R. and B. Haberman, "Unique Local IPv6 Unicast
Addresses", RFC 4193, October 2005.
[RFC4291] Hinden, R. and S. Deering, "IP Version 6 Addressing
Architecture", RFC 4291, February 2006.
[RFC4861] Narten, T., Nordmark, E., Simpson, W., and H. Soliman,
"Neighbor Discovery for IP version 6 (IPv6)", RFC 4861,
September 2007.
[RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", BCP 26, RFC 5226,
May 2008.
9.2. Informative References
[I-D.boucadair-port-range]
Boucadair, M., Levis, P., Bajko, G., and T. Savolainen,
"IPv4 Connectivity Access in the Context of IPv4 Address
Exhaustion: Port Range based IP Architecture",
draft-boucadair-port-range-02 (work in progress),
July 2009.
[I-D.boucadair-sipping-ipv6-atypes]
Boucadair, M., Noisette, Y., and A. Allen, "The atypes
Carpenter, et al. Expires April 23, 2010 [Page 19]
Internet-Draft Generic Referral Object October 2009
media feature tag for Session Initiation Protocol (SIP)",
draft-boucadair-sipping-ipv6-atypes-02 (work in progress),
July 2009.
[I-D.ietf-behave-turn]
Rosenberg, J., Mahy, R., and P. Matthews, "Traversal Using
Relays around NAT (TURN): Relay Extensions to Session
Traversal Utilities for NAT (STUN)",
draft-ietf-behave-turn-16 (work in progress), July 2009.
[I-D.ietf-mmusic-ice]
Rosenberg, J., "Interactive Connectivity Establishment
(ICE): A Protocol for Network Address Translator (NAT)
Traversal for Offer/Answer Protocols",
draft-ietf-mmusic-ice-19 (work in progress), October 2007.
[I-D.ietf-sip-ua-privacy]
Munakata, M., Schubert, S., and T. Ohba, "UA-Driven
Privacy Mechanism for SIP", draft-ietf-sip-ua-privacy-08
(work in progress), May 2009.
[I-D.ymbk-aplusp]
Bush, R., "The A+P Approach to the IPv4 Address Shortage",
draft-ymbk-aplusp-04 (work in progress), July 2009.
[RFC0959] Postel, J. and J. Reynolds, "File Transfer Protocol",
STD 9, RFC 959, October 1985.
[RFC1918] Rekhter, Y., Moskowitz, R., Karrenberg, D., Groot, G., and
E. Lear, "Address Allocation for Private Internets",
BCP 5, RFC 1918, February 1996.
[RFC1958] Carpenter, B., "Architectural Principles of the Internet",
RFC 1958, June 1996.
[RFC2101] Carpenter, B., Crowcroft, J., and Y. Rekhter, "IPv4
Address Behaviour Today", RFC 2101, February 1997.
[RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629,
June 1999.
[RFC2775] Carpenter, B., "Internet Transparency", RFC 2775,
February 2000.
[RFC3234] Carpenter, B. and S. Brim, "Middleboxes: Taxonomy and
Issues", RFC 3234, February 2002.
[RFC3323] Peterson, J., "A Privacy Mechanism for the Session
Carpenter, et al. Expires April 23, 2010 [Page 20]
Internet-Draft Generic Referral Object October 2009
Initiation Protocol (SIP)", RFC 3323, November 2002.
[RFC3484] Draves, R., "Default Address Selection for Internet
Protocol version 6 (IPv6)", RFC 3484, February 2003.
[RFC4007] Deering, S., Haberman, B., Jinmei, T., Nordmark, E., and
B. Zill, "IPv6 Scoped Address Architecture", RFC 4007,
March 2005.
[RFC4091] Camarillo, G. and J. Rosenberg, "The Alternative Network
Address Types (ANAT) Semantics for the Session Description
Protocol (SDP) Grouping Framework", RFC 4091, June 2005.
[RFC4092] Camarillo, G. and J. Rosenberg, "Usage of the Session
Description Protocol (SDP) Alternative Network Address
Types (ANAT) Semantics in the Session Initiation Protocol
(SIP)", RFC 4092, June 2005.
[RFC4903] Thaler, D., "Multi-Link Subnet Issues", RFC 4903,
June 2007.
[RFC5201] Moskowitz, R., Nikander, P., Jokela, P., and T. Henderson,
"Host Identity Protocol", RFC 5201, April 2008.
Appendix A. Example Use Cases
[[ This appendix is incomplete and preliminary. ]]
Referrals may be used to add an entity to a multi-party conversation,
or they may be used (in applications such as telephony) as the first
step of transferring one end of a conversation from the referring
entity to the receiving entity. [[ Say more? ]]
TBD: FTP/PORT, HTTP referrals... text needed
BitTorrent is a distributed file sharing infrastructure. It is based
on P2P techniques for exchanging files between connected users.
Three parties are involved in a BitTorrent architecture: (1) The
server into which, has been uploaded the torrent file. (2) The
Tracker which maintains a list of clients which have the file or some
portions of that file. (3) Entities which are downloading and/or
uploading portions of the file. In order to download a given file, a
BitTorrent client needs to obtain the corresponding torrent file
(i.e. a file which includes the meta-data information of the file to
be shared: the file name, its length, a hash and the URL of the
tracker.). Then, it connects to the tracker to retrieve a list of
lechers (clients which are currently downloading the file but do not
Carpenter, et al. Expires April 23, 2010 [Page 21]
Internet-Draft Generic Referral Object October 2009
yet detain all the portions of the file) and seeders (clients which
detain all the portions of the file and are uploading them to other
requesting clients). The client connects to those machines and
downloads the available portions of the requested file.
In a GRO for Skype purposes, if the address fails, you'd have to fall
back to the Skype ID instead of an FQDN. This is a case where
allowing an application-specific ID might be valuable. Another case
would be Lotus Domino databases - if both IP address and FQDN fail to
find the relevant server, the server name and the database name could
be used as fallback identifiers.
In SIP environments, a SIP Proxy Server intervenes in the placement
of SIP sessions between two UAs. Particularly, the SDP part of
relayed SIP messages includes required information for establishment
of RTP sessions (particularly IP address and port number). A media
description may be unidirectional or symmetric. ICE and ANAT allow
listing several network types and addresses in the same SDP offer.
ANAT: ANAT [RFC4091],[RFC4092] is a procedure used by Dual Stack UAs
to provide both IPv4 and IPv6 addresses in the context of a single
logical media stream. This helps interworking as, whatever the
distant UA version is (IPv4/IPv6-only or Dual-Stack) provided that
this latter is able to understand at least one of the offers. ANAT
semantic does not allow to characterize the IP address(es) it
carries. For instance, no indication if the UA is behind a
translator or not is supported by ANAT (or even ICE). ICE deprecates
ANAT attribute.
Atypes [I-D.boucadair-sipping-ipv6-atypes]: atypes is a SIP media
feature tag which indicates the IP address type capabilities of the
UA (User Agent) and can aid the routing process and ease the
invocation of required functions (e.g. SIP-ALG, NAT64, NAT46) when
heterogeneous (i.e. IPv4 and IPv6) parties are involved in a given
SIP session. Atypes can be used jointly with GRO (also with ICE and
ANAT) to optimise the media path as experienced between involved
parties (especially when Dual-stacks UAs are involved).
Carpenter, et al. Expires April 23, 2010 [Page 22]
Internet-Draft Generic Referral Object October 2009
Authors' Addresses
Brian Carpenter (editor)
Department of Computer Science
University of Auckland
PB 92019
Auckland, 1142
New Zealand
Email: brian.e.carpenter@gmail.com
Mohamed Boucadair
France Telecom
3, Avenue Francois Chateaux
Rennes 35000
France
Email: mohamed.boucadair@orange-ftgroup.com
Joel M. Halpern
Ericsson
P. O. Box 6049
Leesburg, VA 20178
US
Email: jhalpern@redback.com
Sheng Jiang
Huawei Technologies Co., Ltd
KuiKe Building, No.9 Xinxi Rd.,
Shang-Di Information Industry Base, Hai-Dian District, Beijing
P.R. China
Email: shengjiang@huawei.com
Keith Moore
Network Heretics
Email: moore@network-heretics.com
Carpenter, et al. Expires April 23, 2010 [Page 23]