idnits 2.17.1 draft-ietf-drinks-spp-framework-10.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year -- The document date (March 25, 2015) is 3319 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Unused Reference: 'RFC3403' is defined on line 2448, but no explicit reference was found in the text ** Obsolete normative reference: RFC 5226 (Obsoleted by RFC 8126) -- Obsolete informational reference (is this intentional?): RFC 5246 (Obsoleted by RFC 8446) -- Obsolete informational reference (is this intentional?): RFC 7230 (Obsoleted by RFC 9110, RFC 9112) Summary: 1 error (**), 0 flaws (~~), 2 warnings (==), 3 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 DRINKS K. Cartwright 3 Internet-Draft V. Bhatia 4 Intended status: Standards Track TNS 5 Expires: September 26, 2015 S. Ali 6 NeuStar 7 D. Schwartz 8 XConnect 9 March 25, 2015 11 Session Peering Provisioning Framework (SPPF) 12 draft-ietf-drinks-spp-framework-10 14 Abstract 16 This document specifies the data model and the overall structure for 17 a framework to provision session establishment data into Session Data 18 Registries and SIP Service Provider data stores. The framework is 19 called the Session Peering Provisioning Framework (SPPF). The 20 provisioned data is typically used by network elements for session 21 establishment. 23 Status of This Memo 25 This Internet-Draft is submitted in full conformance with the 26 provisions of BCP 78 and BCP 79. 28 Internet-Drafts are working documents of the Internet Engineering 29 Task Force (IETF). Note that other groups may also distribute 30 working documents as Internet-Drafts. The list of current Internet- 31 Drafts is at http://datatracker.ietf.org/drafts/current/. 33 Internet-Drafts are draft documents valid for a maximum of six months 34 and may be updated, replaced, or obsoleted by other documents at any 35 time. It is inappropriate to use Internet-Drafts as reference 36 material or to cite them other than as "work in progress." 38 This Internet-Draft will expire on September 26, 2015. 40 Copyright Notice 42 Copyright (c) 2015 IETF Trust and the persons identified as the 43 document authors. All rights reserved. 45 This document is subject to BCP 78 and the IETF Trust's Legal 46 Provisions Relating to IETF Documents 47 (http://trustee.ietf.org/license-info) in effect on the date of 48 publication of this document. Please review these documents 49 carefully, as they describe your rights and restrictions with respect 50 to this document. Code Components extracted from this document must 51 include Simplified BSD License text as described in Section 4.e of 52 the Trust Legal Provisions and are provided without warranty as 53 described in the Simplified BSD License. 55 Table of Contents 57 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 58 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 6 59 3. Framework High Level Design . . . . . . . . . . . . . . . . . 7 60 3.1. Framework Data Model . . . . . . . . . . . . . . . . . . 7 61 3.2. Time Value . . . . . . . . . . . . . . . . . . . . . . . 10 62 3.3. Extensibility . . . . . . . . . . . . . . . . . . . . . . 10 63 4. Transport Protocol Requirements . . . . . . . . . . . . . . . 11 64 4.1. Connection Oriented . . . . . . . . . . . . . . . . . . . 11 65 4.2. Request and Response Model . . . . . . . . . . . . . . . 11 66 4.3. Connection Lifetime . . . . . . . . . . . . . . . . . . . 11 67 4.4. Authentication . . . . . . . . . . . . . . . . . . . . . 11 68 4.5. Authorization . . . . . . . . . . . . . . . . . . . . . . 12 69 4.6. Confidentiality and Integrity . . . . . . . . . . . . . . 12 70 4.7. Near Real Time . . . . . . . . . . . . . . . . . . . . . 12 71 4.8. Request and Response Sizes . . . . . . . . . . . . . . . 12 72 4.9. Request and Response Correlation . . . . . . . . . . . . 12 73 4.10. Request Acknowledgement . . . . . . . . . . . . . . . . . 12 74 4.11. Mandatory Transport . . . . . . . . . . . . . . . . . . . 13 75 5. Base Framework Data Structures and Response Codes . . . . . . 13 76 5.1. Basic Object Type and Organization Identifiers . . . . . 13 77 5.2. Various Object Key Types . . . . . . . . . . . . . . . . 14 78 5.2.1. Generic Object Key Type . . . . . . . . . . . . . . . 14 79 5.2.2. Derived Object Key Types . . . . . . . . . . . . . . 15 80 5.3. Response Message Types . . . . . . . . . . . . . . . . . 16 81 6. Framework Data Model Objects . . . . . . . . . . . . . . . . 18 82 6.1. Destination Group . . . . . . . . . . . . . . . . . . . . 18 83 6.2. Public Identifier . . . . . . . . . . . . . . . . . . . . 19 84 6.3. SED Group . . . . . . . . . . . . . . . . . . . . . . . . 24 85 6.4. SED Record . . . . . . . . . . . . . . . . . . . . . . . 28 86 6.5. SED Group Offer . . . . . . . . . . . . . . . . . . . . . 32 87 6.6. Egress Route . . . . . . . . . . . . . . . . . . . . . . 34 88 7. Framework Operations . . . . . . . . . . . . . . . . . . . . 36 89 7.1. Add Operation . . . . . . . . . . . . . . . . . . . . . . 36 90 7.2. Delete Operation . . . . . . . . . . . . . . . . . . . . 36 91 7.3. Get Operations . . . . . . . . . . . . . . . . . . . . . 37 92 7.4. Accept Operations . . . . . . . . . . . . . . . . . . . . 38 93 7.5. Reject Operations . . . . . . . . . . . . . . . . . . . . 38 94 7.6. Get Server Details Operation . . . . . . . . . . . . . . 39 95 8. XML Considerations . . . . . . . . . . . . . . . . . . . . . 39 96 8.1. Namespaces . . . . . . . . . . . . . . . . . . . . . . . 39 97 8.2. Versioning and Character Encoding . . . . . . . . . . . . 39 98 9. Security Considerations . . . . . . . . . . . . . . . . . . . 40 99 9.1. Confidentiality and Authentication . . . . . . . . . . . 40 100 9.2. Authorization . . . . . . . . . . . . . . . . . . . . . . 40 101 9.3. Denial of Service . . . . . . . . . . . . . . . . . . . . 40 102 9.3.1. DoS Issues Inherited from Transport Mechanism . . . . 41 103 9.3.2. DoS Issues Specific to SPPF . . . . . . . . . . . . . 41 104 9.4. Information Disclosure . . . . . . . . . . . . . . . . . 42 105 9.5. Non Repudiation . . . . . . . . . . . . . . . . . . . . . 42 106 9.6. Replay Attacks . . . . . . . . . . . . . . . . . . . . . 42 107 9.7. Man in the Middle . . . . . . . . . . . . . . . . . . . . 43 108 10. Internationalization Considerations . . . . . . . . . . . . . 43 109 11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 43 110 11.1. URN Assignments . . . . . . . . . . . . . . . . . . . . 43 111 11.2. Organization Identifier Namespace Registry . . . . . . . 44 112 12. Formal Specification . . . . . . . . . . . . . . . . . . . . 44 113 13. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 52 114 14. References . . . . . . . . . . . . . . . . . . . . . . . . . 53 115 14.1. Normative References . . . . . . . . . . . . . . . . . . 53 116 14.2. Informative References . . . . . . . . . . . . . . . . . 53 117 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 54 119 1. Introduction 121 Service providers and enterprises use routing databases known as 122 registries to make session routing decisions for Voice over IP, SMS 123 and MMS traffic exchanges. This document is narrowly focused on the 124 provisioning framework for these registries. This framework 125 prescribes a way for an entity to provision session-related data into 126 a Registry. The data being provisioned can be optionally shared with 127 other participating peering entities. The requirements and use cases 128 driving this framework have been documented in [RFC6461]. 130 Three types of provisioning flows have been described in the use case 131 document: client to Registry, Registry to local data repository and 132 Registry to Registry. This document addresses client to Registry 133 flow enabling the need to provision Session Establishment Data (SED). 134 The framework that supports flow of messages to facilitate client to 135 Registry provisioning is referred to as Session Peering Provisioning 136 Framework (SPPF). 138 The role of the "client" and the "server" only applies to the 139 connection, and those roles are not related in any way to the type of 140 entity that participates in a protocol exchange. For example, a 141 Registry might also include a "client" when such a Registry initiates 142 a connection (for example, for data distribution to SSP). 144 *--------* *------------* *------------* 145 | | (1). Client | | (3).Registry | | 146 | Client | ------------> | Registry |<------------->| Registry | 147 | | to Registry | | to Registry | | 148 *--------* *------------* *------------* 149 / \ \ 150 / \ \ 151 / \ \ 152 / \ v 153 / \ ... 154 / \ 155 / (2). Distrib \ 156 / Registry data \ 157 / to local data \ 158 V store V 159 +----------+ +----------+ 160 |Local Data| |Local Data| 161 |Repository| |Repository| 162 +----------+ +----------+ 164 Three Registry Provisioning Flows 166 Figure 1 168 A "terminating" SIP Service Provider (SSP) provisions Session 169 Establishment Data or SED into the Registry to be selectively shared 170 with other peer SSPs. 172 SED is typically used by various downstream SIP signaling systems to 173 route a call to the next hop associated with the called domain. 174 These systems typically use a local data store ("Local Data 175 Repository") as their source of session routing information. More 176 specifically, the SED data is the set of parameters that the outgoing 177 signaling path border elements (SBEs) need to initiate the session. 178 See [RFC5486] for more details. 180 A Registry may distribute the provisioned data into local data 181 repositories or may additionally offer a central query resolution 182 service (not shown in the above figure) for query purposes. 184 A key requirement for the SPPF is to be able to accommodate two basic 185 deployment scenarios: 187 1. A resolution system returns a Look-Up Function (LUF) that 188 comprises the target domain to assist in call routing (as 189 described in [RFC5486]). In this case, the querying entity may 190 use other means to perform the Location Routing Function (LRF) 191 which in turn helps determine the actual location of the 192 Signaling Function in that domain. 194 2. A resolution system returns a Location Routing Function (LRF) 195 that comprises the location (address) of the signaling function 196 in the target domain (as described in [RFC5486]). 198 In terms of framework design, SPPF is agnostic to the transport 199 protocol. This document includes the specification of the data model 200 and identifies, but does not specify, the means to enable protocol 201 operations within a request and response structure. That aspect of 202 the specification has been delegated to the "protocol" specification 203 for the framework. To encourage interoperability, the framework 204 supports extensibility aspects. 206 In this document, XML schema is used to describe the building blocks 207 of the SPPF and to express the data types, the semantic relationships 208 between the various data types, and the various constraints as a 209 binding construct. However, the "protocol" specification is free to 210 choose any data representation format as long as it meets the 211 requirements laid out in the SPPF XML schema definition. As an 212 example, XML and JSON are two widely used data representation 213 formats. 215 This document is organized as follows: 217 o Section 2 provides the terminology 219 o Section 3 provides an overview of SPPF, including functional 220 entities and data model 222 o Section 4 specifies requirements for SPPF transport protocols 224 o Section 5 describes the base framework data structures, the 225 generic response types that MUST be supported by a conforming 226 transport "protocol" specification, and the basic object type most 227 first class objects extend from 229 o Section 6 provides a detailed description of the data model object 230 specifications 232 o Section 7 describes the operations that are supported by the data 233 model 235 o Section 8 defines XML considerations XML parsers must meet to 236 conform to this specification 238 o Sections 9 - 11 discuss security, internationalization and IANA 239 considerations 241 o Section 12 normatively defines the SPPF using its XML Schema 242 Definition. 244 2. Terminology 246 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 247 "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and 248 "OPTIONAL" in this document are to be interpreted as described in 249 [RFC2119]. 251 This document reuses terms from [RFC3261], [RFC5486], use cases and 252 requirements documented in [RFC6461] and the ENUM Validation 253 Architecture [RFC4725]. 255 In addition, this document specifies the following additional terms: 257 SPPF: Session Peering Provisioning Framework, the framework used by 258 a transport protocol to provision data into a Registry (see arrow 259 labeled "1." in Figure 1 of [RFC6461]). It is the primary scope 260 of this document. 262 Client: In the context of SPPF, this is an application that 263 initiates a provisioning request. It is sometimes referred to as 264 a "Registry client". 266 Server: In the context of SPPF, this is an application that 267 receives a provisioning request and responds accordingly. It is 268 sometimes referred to as a Registry. 270 Registry: The Registry operates a master database of Session 271 Establishment Data for one or more Registrants. 273 Registrant: The definition of a Registrant is based on [RFC4725]. 274 It is the end-user, the person or organization that is the 275 "holder" of the Session Establishment Data being provisioned into 276 the Registry by a Registrar. For example, in [RFC6461], a 277 Registrant is pictured as a SIP Service Provider in Figure 2. 279 Within the confines of a Registry, a Registrant is uniquely 280 identified by a well-known ID. 282 Registrar: The definition of a Registrar is based on [RFC4725]. It 283 is an entity that performs provisioning operations on behalf of a 284 Registrant by interacting with the Registry via SPPF operations. 285 In other words the Registrar is the SPPF Client. The Registrar 286 and Registrant roles are logically separate to allow, but not 287 require, a single Registrar to perform provisioning operations on 288 behalf of more than one Registrant. 290 Peering Organization: A Peering Organization is an entity to which 291 a Registrant's SED Groups are made visible using the operations of 292 SPPF. 294 3. Framework High Level Design 296 This section introduces the structure of the data model and provides 297 the information framework for the SPPF. The data model is defined 298 along with all the objects manipulated by a conforming transport 299 protocol and their relationships. 301 3.1. Framework Data Model 303 The data model illustrated and described in Figure 2 defines the 304 logical objects and the relationships between these objects supported 305 by SPPF. SPPF defines protocol operations through which an SPPF 306 client populates a Registry with these logical objects. SPPF clients 307 belonging to different Registrars may provision data into the 308 Registry using a conforming transport protocol that implements these 309 operations 311 The logical structure presented below is consistent with the 312 terminology and requirements defined in [RFC6461]. 314 +-------------+ +-----------------+ 315 | all object | |Egress Route: | 316 | types | 0..n | rant, | 317 +-------------+ +--| egrRteName, | 318 |0..n / | pref, | 319 | / | regxRewriteRule,| 320 |2 / | ingrSedGrp, | 321 +----------------------+ / | svcs | 322 |Organization: | / +-----------------+ 323 | orgId | / 324 +----------------------+ / 325 |0..n / 326 | / 327 |A SED Group is / 328 |associated with / 329 |zero or more / +---[abstract]----+ 330 |Peering / | SED Record: | 331 |Organizations / | rant, | 332 | / | sedName, |0..n 333 |0..n / | sedFunction, |------| 334 +--------+--------------+0..n 0..n| isInSvc, | | 335 |SED Group: |------------------| ttl | | 336 | rant, | +-----------------+ | 337 | sedGrpName, | ^ Various types | 338 | isInSvc, | | of SED Records | 339 | sedRecRef, | | | 340 | peeringOrg, | +-----+------------+ | 341 | sourceIdent, | | | | | 342 | priority, | +----+ +-------+ +----+ | 343 | dgName | | URI| | NAPTR | | NS | | 344 +-----------------------+ +----+ +-------+ +----+ | 345 |0..n | 346 | +-----[abstract]------+ | 347 |0..n |Public Identifier: | | 348 +----------------------+0..n 0..n| rant, | | 349 | Dest Group: |--------------| publicIdentifier, | | 350 | rant, | | dgName | | 351 | dgName | | | | 352 +----------------------+ +---------------------+ | 353 ^ Various types | 354 +---------+-------+------+----------+ of Public | 355 | | | | | Identifiers | 356 +------+ +-----+ +-----+ +-----+ +------+ | 357 | URI | | TNP | | TNR | | RN | | TN |-------------| 358 +------+ +-----+ +-----+ +-----+ +------+ 0..n 360 Figure 2 362 The objects and attributes that comprise the data model can be 363 described as follows (objects listed from the bottom up): 365 o Public Identifier: 366 From a broad perspective a public identifier is a well-known 367 attribute that is used as the key to perform resolution lookups. 368 Within the context of SPPF, a public identifier object can be a 369 Telephone Number (TN), a range of Telephone Numbers, a PSTN 370 Routing Number (RN), a TN prefix, or a URI. 372 An SPPF Public Identifier may be a member of zero or more 373 Destination Groups to create logical groupings of Public 374 Identifiers that share a common set of Session Establishment Data 375 (e.g. routes). 377 A TN Public Identifier may optionally be associated with zero or 378 more individual SED Records. This ability for a Public Identifier 379 to be directly associated with a SED Record, as opposed to forcing 380 membership in one or more Destination Groups, supports use cases 381 where the SED Record contains data specifically tailored to an 382 individual TN Public Identifier. 384 o Destination Group: 385 A named logical grouping of zero or more Public Identifiers that 386 can be associated with one or more SED Groups for the purpose of 387 facilitating the management of their common session establishment 388 information. 390 o SED Group: 391 A SED Group contains a set of SED Record references, a set of 392 Destination Group references, and a set of peering organization 393 identifiers. This is used to establish a three part relationships 394 between a set of Public Identifiers, the session establishment 395 information (SED) shared across these Public Identifiers, and the 396 list of peering organizations whose query responses from the 397 resolution system may include the session establishment 398 information contained in a given SED group. In addition, the 399 sourceIdent element within a SED Group, in concert with the set of 400 peering organization identifiers, enables fine-grained source 401 based routing. For further details about the SED Group and source 402 based routing, refer to the definitions and descriptions in 403 Section 6.1. 405 o SED Record: 406 A SED Record contains the data that a resolution system returns in 407 response to a successful query for a Public Identifier. SED 408 Records are generally associated with a SED Group when the SED 409 within is not specific to a Public Identifier. 411 To support the use cases defined in [RFC6461], SPPF framework 412 defines three type of SED Records: URIType, NAPTRType, and NSType. 413 These SED Records extend the abstract type SedRecType and inherit 414 the common attribute 'priority' that is meant for setting 415 precedence across the SED records defined within a SED Group in a 416 protocol agnostic fashion. 418 o Egress Route: 419 In a high-availability environment, the originating SSP likely has 420 more than one egress paths to the ingress SBE of the target SSP. 421 The Egress Route allows the originating SSP to choose a specific 422 egress SBE to be associated with the target ingress SBE. the 423 'svcs' element specifies ENUM services ((e.g.,E2U+pstn:sip+sip) 424 that are used to identify the SED records associated with the SED 425 Group that will be modified by the originating SSP. 427 o Organization: 428 An Organization is an entity that may fulfill any combination of 429 three roles: Registrant, Registrar, and Peering Organization. All 430 objects in SPPF are associated with two organization identifiers 431 to identify each object's Registrant and Registrar. A SED Group 432 object is also associated with a set of zero or more organization 433 identifiers that identify the peering organization(s) whose 434 resolution query responses may include the session establishment 435 information (SED) defined in the SED Records within that SED 436 Group. A peering organization is an entity that the Registrant 437 intends to share the SED data with. 439 3.2. Time Value 441 Some request and response messages in SPPF include time value(s) 442 defined as type xs:dateTime, a built-in W3C XML Schema Datatype. Use 443 of unqualified local time value is disallowed as it can lead to 444 interoperability issues. The value of time attribute MUST be 445 expressed in Coordinated Universal Time (UTC) format without the 446 timezone digits. 448 "2010-05-30T09:30:10Z" is an example of an acceptable time value for 449 use in SPPF messages. "2010-05-30T06:30:10+3:00" is a valid UTC 450 time, but it is not approved for use in SPPF messages. 452 3.3. Extensibility 454 The framework contains various points of extensibility in form of the 455 "ext" elements. Extensions used beyond the scope of private SPPF 456 installations MUST be documented in an RFC, and the first such 457 extension SHOULD define an IANA registry, holding a list of 458 documented extensions. 460 4. Transport Protocol Requirements 462 This section provides requirements for transport protocols suitable 463 for SPPF. More specifically, this section specifies the services, 464 features, and assumptions that SPPF framework delegates to the chosen 465 transport and envelope technologies. 467 4.1. Connection Oriented 469 The SPPF follows a model where a client establishes a connection to a 470 server in order to further exchange SPPF messages over such point-to- 471 point connection. A transport protocol for SPPF MUST therefore be 472 connection oriented. 474 4.2. Request and Response Model 476 Provisioning operations in SPPF follow the request-response model, 477 where a client sends a request message to initiate a transaction and 478 the server responds with a response. Multiple subsequent request- 479 response exchanges MAY be performed over a single persistent 480 connection. 482 Therefore, a transport protocol for SPPF MUST follow the request- 483 response model by allowing a response to be sent to the request 484 initiator. 486 4.3. Connection Lifetime 488 Some use cases involve provisioning a single request to a network 489 element. Connections supporting such provisioning requests might be 490 short-lived, and may be established only on demand. Other use cases 491 involve either provisioning a large dataset, or a constant stream of 492 small updates, either of which would likely require long-lived 493 connections. 495 Therefore, a protocol suitable for SPPF SHOULD be able to support 496 both short-lived as well as long-lived connections. 498 4.4. Authentication 500 All SPPF objects are associated with a Registrant identifier. An 501 SPPF Client provisions SPPF objects on behalf of Registrants. An 502 authenticated SPP Client is a Registrar. Therefore, the SPPF 503 transport protocol MUST provide means for an SPPF server to 504 authenticate an SPPF Client. 506 4.5. Authorization 508 After successful authentication of the SPPF client as a Registrar the 509 Registry performs authorization checks to determine if the Registrar 510 is authorized to act on behalf of the Registrant whose identifier is 511 included in the SPPF request. Refer to the Security Considerations 512 section for further guidance. 514 4.6. Confidentiality and Integrity 516 SPPF objects that the Registry manages can be private in nature. 517 Therefore, the transport protocol MUST provide means for end-to-end 518 encryption between the SPPF client and Registry. 520 If the data is compromised in-flight between the SPPF client and 521 Registry, it will seriously affect the stability and integrity of the 522 system. Therefore, the transport protocol MUST provide means for 523 data integrity protection. 525 4.7. Near Real Time 527 Many use cases require near real-time responses from the server. 528 Therefore, a DRINKS transport protocol MUST support near real-time 529 response to requests submitted by the client. 531 4.8. Request and Response Sizes 533 Use of SPPF may involve simple updates that may consist of small 534 number of bytes, such as, update of a single public identifier. 535 Other provisioning operations may constitute large number of dataset 536 as in adding millions records to a Registry. As a result, a suitable 537 transport protocol for SPPF SHOULD accommodate dataset of various 538 sizes. 540 4.9. Request and Response Correlation 542 A transport protocol suitable for SPPF MUST allow responses to be 543 correlated with requests. 545 4.10. Request Acknowledgement 547 Data transported in the SPPF is likely crucial for the operation of 548 the communication network that is being provisioned. A SPPF client 549 responsible for provisioning SED to the Registry has a need to know 550 if the submitted requests have been processed correctly. 552 Failed transactions can lead to situations where a subset of public 553 identifiers or even SSPs might not be reachable, or the provisioning 554 state of the network is inconsistent. 556 Therefore, a transport protocol for SPPF MUST provide a response for 557 each request, so that a client can identify whether a request 558 succeeded or failed. 560 4.11. Mandatory Transport 562 At the time of this writing, a choice of transport protocol has been 563 provided in SPP Protocol over SOAP document. To encourage 564 interoperability, the SPPF server MUST provide support for this 565 transport protocol. With time, it is possible that other transport 566 layer choices may surface that agree with the requirements discussed 567 above. 569 5. Base Framework Data Structures and Response Codes 571 SPPF contains some common data structures for most of the supported 572 object types. This section describes these common data structures. 574 5.1. Basic Object Type and Organization Identifiers 576 All first class objects extend the type BasicObjType. It consists of 577 the Registrant organization, the Registrar organization, the date and 578 time of object creation, and the last date and time the object was 579 updated. The Registry MUST store the date and time of the object 580 creation and update, if applicable, for all Get operations (see 581 Section 7). If the client passed in either date and time values, the 582 Registry MUST ignore it. The Registrar performs the SPPF operations 583 on behalf of the Registrant, the organization that owns the object. 585 586 587 588 589 590 591 592 593 595 The identifiers used for Registrants (rant) and Registrars (rar) are 596 instances of OrgIdType. The OrgIdType is defined as a string and all 597 OrgIdType instances MUST follow the textual convention: 598 "namespace:value" (for example "iana-en:32473"). See the IANA 599 Consideration section for more details. 601 5.2. Various Object Key Types 603 The SPPF data model contains various object relationships. In some 604 cases, these object relationships are established by embedding the 605 unique identity of the related object inside the relating object. 606 Note that an object's unique identity is required to Delete or Get 607 the details of an object. The following sub-sections normatively 608 define the various object keys in SPPF and the attributes of those 609 keys. 611 "Name" attributes that are used as components of object key types 612 MUST be treated case insensitive, more specifically, comparison 613 operations MUST use the toCasefold() function, as specified in 614 Section 3.13 of [Unicode6.1]. 616 5.2.1. Generic Object Key Type 618 Most objects in SPPF are uniquely identified by an object key that 619 has the object's name, object's type and its Registrant's 620 organization ID as its attributes. The abstract type called 621 ObjKeyType is where this unique identity is housed. Any concrete 622 representation of the ObjKeyType MUST contain the following: 624 Object Name: The name of the object. 626 Registrant Id: The unique organization ID that identifies the 627 Registrant. 629 Type: The value that represents the type of SPPF object. This is 630 required as different types of objects in SPPF, that belong to the 631 same Registrant, can have the same name. 633 The structure of abstract ObjKeyType is as follows: 635 636 637 638 ---- Generic type that represents the 639 key for various objects in SPPF. ---- 640 641 642 644 5.2.2. Derived Object Key Types 646 The SPPF data model contains certain objects that are uniquely 647 identified by attributes, different from or in addition to, the 648 attributes in the generic object key described in previous section. 649 These kind of object keys are derived from the abstract ObjKeyType 650 and defined in their own abstract key types. Because these object 651 key types are abstract, they MUST be specified in a concrete form in 652 any SPPF conforming transport protocol specification. These are used 653 in Delete and Get operations, and may also be used in Accept and 654 Reject operations. 656 Following are the derived object keys in SPPF data model: 658 o SedGrpOfferKeyType: This uniquely identifies a SED Group object 659 offer. This key type extends from ObjKeyType and MUST also have 660 the organization ID of the Registrant to whom the object is being 661 offered, as one of its attributes. In addition to the Delete and 662 Get operations, these key types are used in Accept and Reject 663 operations on a SED Group Offer object. The structure of abstract 664 SedGrpOfferKeyType is as follows: 666 668 669 670 671 672 ---- Generic type that represents 673 the key for a object offer. ---- 674 675 676 677 678 680 A SED Group Offer object MUST use SedGrpOfferKeyType. Refer to 681 the "Framework Data Model Objects" section of this document for 682 description of SED Group Offer object. 684 o PubIdKeyType: This uniquely identifies a Public Identity object. 685 This key type extends from abstract ObjKeyType. Any concrete 686 definition of PubIdKeyType MUST contain the elements that identify 687 the value and type of Public Identity and also contain the 688 organization ID of the Registrant that is the owner of the Public 689 Identity object. A Public Identity object in SPPF is uniquely 690 identified by the Registrant's organization ID, the value of the 691 public identity, and the type of the public identity object. 693 Consequently, any concrete representation of the PubIdKeyType MUST 694 contain the following attributes: 696 * Registrant Id: The unique organization ID that identifies the 697 Registrant. 699 * Value: The value of the Public Identity. 701 * Type: The type of the Public Identity Object. 703 The PubIdKeyType is used in Delete and Get operations on a Public 704 Identifier object. 706 o The structure of abstract PubIdKeyType is as follows: 708 709 710 711 712 713 ---- Generic type that represents the key for a Pub Id. ---- 714 715 716 717 718 720 A Public Identity object MUST use attributes of PubIdKeyType for its 721 unique identification . Refer to Section 6 for a description of 722 Public Identity object. 724 5.3. Response Message Types 726 This section contains the listing of response types that MUST be 727 defined by the SPPF conforming transport protocol specification and 728 implemented by a conforming SPPF server. 730 +---------------------+---------------------------------------------+ 731 | Response Type | Description | 732 +---------------------+---------------------------------------------+ 733 | Request Succeeded | Any conforming specification MUST define a | 734 | | response to indicate that a given request | 735 | | succeeded. | 736 | | | 737 | Request syntax | Any conforming specification MUST define a | 738 | invalid | response to indicate that a syntax of a | 739 | | given request was found invalid. | 740 | | | 741 | Request too large | Any conforming specification MUST define a | 742 | | response to indicate that the count of | 743 | | entities in the request is larger than the | 744 | | server is willing or able to process. | 745 | | | 746 | Version not | Any conforming specification MUST define a | 747 | supported | response to indicate that the server does | 748 | | not support the version of the SPPF | 749 | | protocol specified in the request. | 750 | | | 751 | Command invalid | Any conforming specification MUST define a | 752 | | response to indicate that the operation | 753 | | and/or command being requested by the | 754 | | client is invalid and/or not supported by | 755 | | the server. | 756 | | | 757 | System temporarily | Any conforming specification MUST define a | 758 | unavailable | response to indicate that the SPPF server | 759 | | is temporarily not available to serve | 760 | | client request. | 761 | | | 762 | Unexpected internal | Any conforming specification MUST define a | 763 | system or server | response to indicate that the SPPF server | 764 | error. | encountered an unexpected error that | 765 | | prevented the server from fulfilling the | 766 | | request. | 767 | | | 768 | Attribute value | Any conforming specification MUST define a | 769 | invalid | response to indicate that the SPPF server | 770 | | encountered an attribute or property in the | 771 | | request that had an invalid/bad value. | 772 | | Optionally, the specification MAY provide a | 773 | | way to indicate the Attribute Name and the | 774 | | Attribute Value to identify the object that | 775 | | was found to be invalid. | 776 | | | 777 | Object does not | Any conforming specification MUST define a | 778 | exist | response to indicate that an object present | 779 | | in the request does not exist on the SPPF | 780 | | server. Optionally, the specification MAY | 781 | | provide a way to indicate the Attribute | 782 | | Name and the Attribute Value that | 783 | | identifies the non-existent object. | 784 | | | 785 | Object status or | Any conforming specification MUST define a | 786 | ownership does not | response to indicate that the operation | 787 | allow for | requested on an object present in the | 788 | operation. | request cannot be performed because the | 789 | | object is in a status that does not allow | 790 | | the said operation or the user requesting | 791 | | the operation is not authorized to perform | 792 | | the said operation on the object. | 793 | | Optionally, the specification MAY provide a | 794 | | way to indicate the Attribute Name and the | 795 | | Attribute Value that identifies the object. | 796 +---------------------+---------------------------------------------+ 798 Table 1: Response Types 800 When the response messages are "parameterized" with the Attribute 801 Name and Attribute Value, then the use of these parameters MUST 802 adhere to the following rules: 804 o Any value provided for the Attribute Name parameter MUST be an 805 exact XSD element name of the protocol data element that the 806 response message is referring to. For example, valid values for 807 "attribute name" are "dgName", "sedGrpName", "sedRec", etc. 809 o The value for Attribute Value MUST be the value of the data 810 element to which the preceding Attribute Name refers. 812 o Response type "Attribute value invalid" MUST be used whenever an 813 element value does not adhere to data validation rules. 815 o Response types "Attribute value invalid" and "Object does not 816 exist" MUST NOT be used interchangeably. Response type "Object 817 does not exist" MUST be returned by an Update/Del/Accept/Reject 818 operation when the data element(s) used to uniquely identify a 819 pre-existing object do not exist. If the data elements used to 820 uniquely identify an object are malformed, then response type 821 "Attribute value invalid" MUST be returned. 823 6. Framework Data Model Objects 825 This section provides a description of the specification of each 826 supported data model object (the nouns) and identifies the commands 827 (the verbs) that MUST be supported for each data model object. 828 However, the specification of the data structures necessary to 829 support each command is delegated to an SPPF conforming transport 830 protocol specification. 832 6.1. Destination Group 834 Destination Group represents a logical grouping of Public Identifiers 835 with common session establishment information. The transport 836 protocol MUST support the ability to Add, Get, and Delete Destination 837 Groups (refer to the "Framework Operations" section of this document 838 for a generic description of various operations). 840 A Destination Group object MUST be uniquely identified by attributes 841 as defined in the description of "ObjKeyType" in the section "Generic 842 Object Key Type" of this document. 844 The DestGrpType object structure is defined as follows: 846 847 848 849 850 851 852 853 854 856 The DestGrpType object is composed of the following elements: 858 o base: All first class objects extend BasicObjType (see 859 Section 5.1). 861 o dgName: The character string that contains the name of the 862 Destination Group. 864 o ext: Point of extensibility described in Section 3.3. 866 6.2. Public Identifier 868 A Public Identifier is the search key used for locating the session 869 establishment data (SED). In many cases, a Public Identifier is 870 attributed to the end user who has a retail relationship with the 871 service provider or Registrant organization. SPPF supports the 872 notion of the carrier-of-record as defined in [RFC5067]. Therefore, 873 the Registrant under whom the Public Identity is being created can 874 optionally claim to be a carrier-of-record. 876 SPPF identifies three types of Public Identifiers: telephone numbers 877 (TN), routing numbers (RN), and URI. SPPF provides structures to 878 manage a single TN, a contiguous range of TNs, and a TN prefix. The 879 transport protocol MUST support the ability to Add, Get, and Delete 880 Public Identifiers (refer to the "Framework Operations" section of 881 this document for a generic description of various operations). 883 A Public Identity object MUST be uniquely identified by attributes as 884 defined in the description of "PubIdKeyType" in the section 885 Section 5.2.2. 887 The abstract XML schema type definition PubIdType is a generalization 888 for the concrete Public Identifier schema types. PubIdType element 889 'dgName' represents the name of a destination group that a given 890 Public Identifier may be a member of. Note that this element may be 891 present multiple times so that a given Public Identifier may be a 892 member of multiple destination groups. The PubIdType object 893 structure is defined as follows: 895 896 897 898 899 901 902 903 904 906 A Public Identifier may be a member of zero or more Destination 907 Groups. When a Public Identifier is member of a Destination Group, 908 it is intended to be associated with SED(s) through the SED Group(s) 909 that are associated with the Destination Group. When a Public 910 Identifier is not member of any Destination Group, it is intended to 911 be associated with SED through the SED Records that are directly 912 associated with the Public Identifier. 914 A telephone number is provisioned using the TNType, an extension of 915 PubIdType. Each TNType object is uniquely identified by the 916 combination of its value contained within element, and its 917 Registrant ID. TNType is defined as follows: 919 920 921 922 923 924 925 927 928 929 930 932 933 934 935 936 937 938 940 941 942 943 944 945 947 TNType consists of the following attributes: 949 o tn: Telephone number to be added to the Registry. 951 o sedRecRef: Optional reference to SED records that are directly 952 associated with the TN Public Identifier. Following the SPPF data 953 model, the SED record could be a protocol agnostic URIType or 954 another type. 956 o corInfo: corInfo is an optional parameter of type CORInfoType that 957 allows the Registrant organization to set forth a claim to be the 958 carrier-of-record (see [RFC5067]). This is done by setting the 959 value of element of the CORInfoType object structure to 960 "true". The other two parameters of the CORInfoType, and 961 are set by the Registry to describe the outcome of the 962 carrier-of-record claim by the Registrant. In general, inclusion 963 of parameter is useful if the Registry has the authority 964 information, such as, the number portability data, etc., in order 965 to qualify whether the Registrant claim can be satisfied. If the 966 carrier-of-record claim disagrees with the authority data in the 967 Registry, whether the TN add operation fails or not is a matter of 968 policy and it is beyond the scope of this document. 970 A routing number is provisioned using the RNType, an extension of 971 PubIDType. The Registrant organization can add the RN and associate 972 it with the appropriate destination group(s) to share the route 973 information. This allows SSPs to use the RN search key to derive the 974 ingress routes for session establishment at the runtime resolution 975 process (see [RFC6116]. Each RNType object is uniquely identified by 976 the combination of its value inside the element, and its 977 Registrant ID. RNType is defined as follows: 979 980 981 982 983 984 985 986 987 988 990 RNType has the following attributes: 992 o rn: Routing Number used as the search key. 994 o corInfo: corInfo is an optional parameter of type CORInfoType that 995 allows the Registrant organization to set forth a claim to be the 996 carrier-of-record (see [RFC5067]) 998 TNRType structure is used to provision a contiguous range of 999 telephone numbers. The object definition requires a starting TN and 1000 an ending TN that together define the span of the TN range. Use of 1001 TNRType is particularly useful when expressing a TN range that does 1002 not include all the TNs within a TN block or prefix. The TNRType 1003 definition accommodates the open number plan as well such that the 1004 TNs that fall between the start and end TN range may include TNs with 1005 different length variance. Whether the Registry can accommodate the 1006 open number plan semantics is a matter of policy and is beyond the 1007 scope of this document. Each TNRType object is uniquely identified 1008 by the combination of its value that in turn is a combination of the 1009 and elements, and its Registrant ID. TNRType 1010 object structure definition is as follows: 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1023 1024 1025 1026 1027 1028 1030 TNRType has the following attributes: 1032 o startTn: Starting TN in the TN range 1034 o endTn: The last TN in the TN range 1036 o corInfo: corInfo is an optional parameter of type CORInfoType that 1037 allows the Registrant organization to set forth a claim to be the 1038 carrier-of-record (see [RFC5067]) 1040 In some cases, it is useful to describe a set of TNs with the help of 1041 the first few digits of the telephone number, also referred to as the 1042 telephone number prefix or a block. A given TN prefix may include 1043 TNs with different length variance in support of open number plan. 1044 Once again, whether the Registry supports the open number plan 1045 semantics is a matter of policy and it is beyond the scope of this 1046 document. The TNPType data structure is used to provision a TN 1047 prefix. Each TNPType object is uniquely identified by the 1048 combination of its value in the element, and its 1049 Registrant ID. TNPType is defined as follows: 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1062 TNPType consists of the following attributes: 1064 o tnPrefix: The telephone number prefix 1066 o corInfo: corInfo is an optional parameter of type CORInfoType that 1067 allows the Registrant organization to set forth a claim to be the 1068 carrier-of-record (see [RFC5067]) 1070 In some cases, a Public Identifier may be a URI, such as an email 1071 address. The URIPubIdType object is comprised of the data element 1072 necessary to house such Public Identifiers. Each URIPubIdType object 1073 is uniquely identified by the combination of its value in the 1074 element, and its Registrant ID. URIPubIdType is defined as follows: 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1087 URIPubIdType consists of the following attributes: 1089 o uri: The value that acts a Public Identifier. 1091 o ext: Point of extensibility described in Section 3.3. 1093 6.3. SED Group 1095 SED Group is a grouping of one or more Destination Group, the common 1096 SED Records, and the list of peer organizations with access to the 1097 SED Records associated with a given SED Group. It is this indirect 1098 linking of public identifiers to their Session Establishment Data 1099 that significantly improves the scalability and manageability of the 1100 peering data. Additions and changes to SED information are reduced 1101 to a single operation on a SED Group or SED Record , rather than 1102 millions of data updates to individual public identifier records that 1103 individually contain their peering data. The transport protocol MUST 1104 support the ability to Add, Get, and Delete SED Groups (refer to the 1105 "Framework Operations" section of this document for a generic 1106 description of various operations). 1108 A SED Group object MUST be uniquely identified by attributes as 1109 defined in the description of "ObjKeyType" in the section "Generic 1110 Object Key Type" of this document. 1112 The SedGrpType object structure is defined as follows: 1114 1115 1116 1117 1118 1119 1121 1123 1125 1127 1128 1129 1130 1131 1132 1133 1135 1136 1137 1138 1139 1140 1141 1143 The SedGrpType object is composed of the following elements: 1145 o base: All first class objects extend BasicObjType (see 1146 Section 5.1). 1148 o sedGrpName: The character string that contains the name of the SED 1149 Group. It uniquely identifies this object within the context of 1150 the Registrant ID (a child element of the base element as 1151 described above). 1153 o sedRecRef: Set of zero or more objects of type SedRecRefType that 1154 house the unique keys of the SED Records (containing the session 1155 establishment data) that the SedGrpType object refers to and their 1156 relative priority within the context of this SED Group. 1158 o dgName: Set of zero or more names of DestGrpType object instances. 1159 Each dgName name, in association with this SED Group's Registrant 1160 ID, uniquely identifies a DestGrpType object instance whose 1161 associated public identifiers are reachable using the session 1162 establishment information housed in this SED Group. An intended 1163 side affect of this is that a SED Group cannot provide session 1164 establishment information for a Destination Group belonging to 1165 another Registrant. 1167 o peeringOrg: Set of zero or more peering organization IDs that have 1168 accepted an offer to receive this SED Group's information. Note 1169 that this identifier "peeringOrg" is an instance of OrgIdType. 1170 The set of peering organizations in this list is not directly 1171 settable or modifiable using the addSedGrpsRqst operation. This 1172 set is instead controlled using the SED offer and accept 1173 operations. 1175 o sourceIdent: Set of zero or more SourceIdentType object instances. 1176 These objects, described further below, house the source 1177 identification schemes and identifiers that are applied at 1178 resolution time as part of source based routing algorithms for the 1179 SED Group. 1181 o isInSvc: A boolean element that defines whether this SED Group is 1182 in service. The session establishment information contained in a 1183 SED Group that is in service is a candidate for inclusion in 1184 resolution responses for public identities residing in the 1185 Destination Group associated with this SED Group. The session 1186 establishment information contained in a SED Group that is not in 1187 service is not a candidate for inclusion in resolution responses. 1189 o priority: Priority value that can be used to provide a relative 1190 value weighting of one SED Group over another. The manner in 1191 which this value is used, perhaps in conjunction with other 1192 factors, is a matter of policy. 1194 o ext: Point of extensibility described in Section 3.3. 1196 As described above, the SED Group contains a set of references to SED 1197 record objects. A SED record object is based on an abstract type: 1198 SedRecType. The concrete types that use SedRecType as an extension 1199 base are NAPTRType, NSType, and URIType. The definitions of these 1200 types are included the SED Record section of this document. 1202 The SedGrpType object provides support for source-based routing via 1203 the peeringOrg data element and more granular source base routing via 1204 the source identity element. The source identity element provides 1205 the ability to specify zero or more of the following in association 1206 with a given SED Group: a regular expression that is matched against 1207 the resolution client IP address, a regular expression that is 1208 matched against the root domain name(s), and/or a regular expression 1209 that is matched against the calling party URI(s). The result will be 1210 that, after identifying the visible SED Groups whose associated 1211 Destination Group(s) contain the lookup key being queried and whose 1212 peeringOrg list contains the querying organizations organization ID, 1213 the resolution server will evaluate the characteristics of the Source 1214 URI, and Source IP address, and root domain of the lookup key being 1215 queried. The resolution server then compares these criteria against 1216 the source identity criteria associated with the SED Groups. The 1217 session establishment information contained in SED Groups that have 1218 source based routing criteria will only be included in the resolution 1219 response if one or more of the criteria matches the source criteria 1220 from the resolution request. The Source Identity data element is of 1221 type SourceIdentType, whose structure is defined as follows: 1223 1224 1225 1226 1228 1229 1230 1232 1233 1234 1235 1236 1237 1238 1240 The SourceIdentType object is composed of the following data 1241 elements: 1243 o sourceIdentScheme: The source identification scheme that this 1244 source identification criteria applies to and that the associated 1245 sourceIdentRegex should be matched against. 1247 o sourceIdentRegex: The regular expression that should be used to 1248 test for a match against the portion of the resolution request 1249 that is dictated by the associated sourceIdentScheme. 1251 o ext: Point of extensibility described in Section 3.3. 1253 6.4. SED Record 1255 SED Group represents a combined grouping of SED Records that define 1256 session establishment information. However, SED Records need not be 1257 created to just serve a single SED Group. SED Records can be created 1258 and managed to serve multiple SED Groups. As a result, a change for 1259 example to the properties of a network node used for multiple routes, 1260 would necessitate just a single update operation to change the 1261 properties of that node. The change would then be reflected in all 1262 the SED Groups whose SED record set contains a reference to that 1263 node. The transport protocol MUST support the ability to Add, Get, 1264 and Delete SED Records (refer to the "Framework Operations" section 1265 of this document for a generic description of various operations). 1267 A SED Record object MUST be uniquely identified by attributes as 1268 defined in the description of "ObjKeyType" in the section "Generic 1269 Object Key Type" of this document. 1271 The SedRecType object structure is defined as follows: 1273 1274 1275 1276 1277 1278 1280 1281 1282 1283 1284 1285 1287 1288 1289 1290 1291 1292 1294 The SedRecType object is composed of the following elements: 1296 o base: All first class objects extend BasicObjType (see 1297 Section 5.1). 1299 o sedName: The character string that contains the name of the SED 1300 Record. It uniquely identifies this object within the context of 1301 the Registrant ID (a child element of the base element as 1302 described above). 1304 o sedFunction: As described in [RFC6461], SED or Session 1305 Establishment Data falls primarily into one of two categories or 1306 functions, LUF and LRF. To remove any ambiguity as to the 1307 function a SED record is intended to provide, this optional 1308 element allows the provisioning party to make his or her 1309 intentions explicit. 1311 o isInSvc: A boolean element that defines whether this SED Record is 1312 in service or not. The session establishment information 1313 contained in a SED Record which is in service is a candidate for 1314 inclusion in resolution responses for Telephone Numbers that are 1315 either directly associated to this SED Record, or for Public 1316 Identities residing in a Destination Group that is associated to a 1317 SED Group which in turn has an association to this SED Record. 1319 o ttl: Number of seconds that an addressing server may cache a 1320 particular SED Record. 1322 As described above, SED records are based on an abstract type: 1323 SedRecType. The concrete types that use SedRecType as an extension 1324 base are NAPTRType, NSType, and URIType. The definitions of these 1325 types are included below. The NAPTRType object is comprised of the 1326 data elements necessary for a NAPTR (see [RFC3403]that contains 1327 routing information for a SED Group. The NSType object is comprised 1328 of the data elements necessary for a DNS name server that points to 1329 another DNS server that contains the desired routing information. 1330 The NSType is relevant only when the resolution protocol is ENUM (see 1331 [RFC6116]). The URIType object is comprised of the data elements 1332 necessary to house a URI. 1334 The data provisioned in a Registry can be leveraged for many purposes 1335 and queried using various protocols including SIP, ENUM and others. 1336 As such, the resolution data represented by the SED records must be 1337 in a form suitable for transport using one of these protocols. In 1338 the NAPTRType for example, if the URI is associated with a 1339 destination group, the user part of the replacement string that 1340 may require the Public Identifier cannot be preset. As a SIP 1341 Redirect, the resolution server will apply pattern on the input 1342 Public Identifier in the query and process the replacement string by 1343 substituting any back reference(s) in the to arrive at the 1344 final URI that is returned in the SIP Contact header. For an ENUM 1345 query, the resolution server will simply return the values of the 1346 and members of the URI. 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1363 1364 1365 1366 1367 1368 1371 1372 1373 1374 1375 1377 1378 1379 1380 1381 1382 1383 1385 1386 1387 1388 1389 1390 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1404 1405 1406 1407 1408 1409 1411 The NAPTRType object is composed of the following elements: 1413 o order: Order value in an ENUM NAPTR, relative to other NAPTRType 1414 objects in the same SED Group. 1416 o svcs: ENUM service(s) that are served by the SBE. This field's 1417 value must be of the form specified in [RFC6116] (e.g., 1418 E2U+pstn:sip+sip). The allowable values are a matter of policy 1419 and not limited by this protocol. 1421 o regx: NAPTR's regular expression field. If this is not included 1422 then the Repl field must be included. 1424 o repl: NAPTR replacement field, should only be provided if the 1425 Regex field is not provided, otherwise the server will ignore it 1427 o ext: Point of extensibility described in Section 3.3. 1429 The NSType object is composed of the following elements: 1431 o hostName: Root-relative host name of the name server. 1433 o ipAddr: Zero or more objects of type IpAddrType. Each object 1434 holds an IP Address and the IP Address type, IPv4 or IP v6. 1436 o ext: Point of extensibility described in Section 3.3. 1438 The URIType object is composed of the following elements: 1440 o ere: The POSIX Extended Regular Expression (ere) as defined in 1441 [RFC3986]. 1443 o uri: the URI as defined in [RFC3986]. In some cases, this will 1444 serve as the replacement string and it will be left to the 1445 resolution server to arrive at the final usable URI. 1447 6.5. SED Group Offer 1449 The list of peer organizations whose resolution responses can include 1450 the session establishment information contained in a given SED Group 1451 is controlled by the organization to which a SED Group object belongs 1452 (its Registrant), and the peer organization that submits resolution 1453 requests (a data recipient, also know as a peering organization). 1454 The Registrant offers access to a SED Group by submitting a SED Group 1455 Offer. The data recipient can then accept or reject that offer. Not 1456 until access to a SED Group has been offered and accepted will the 1457 data recipient's organization ID be included in the peeringOrg list 1458 in a SED Group object, and that SED Group's peering information 1459 become a candidate for inclusion in the responses to the resolution 1460 requests submitted by that data recipient. The transport protocol 1461 MUST support the ability to Add, Get, Delete, Accept and Reject SED 1462 Group Offers (refer to the "Framework Operations" section of this 1463 document for a generic description of various operations). 1465 A SED Group Offer object MUST be uniquely identified by attributes as 1466 defined in the description of "SedGrpOfferKeyType" in the section 1467 "Derived Object Key Types" of this document. 1469 The SedGrpOfferType object structure is defined as follows: 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1485 1486 1487 1488 -- Generic type that represents the key for a SED group offer. Must 1489 be defined in concrete form in the transport specification. -- 1490 1491 1492 1494 1495 1496 1497 1498 1499 1501 The SedGrpOfferType object is composed of the following elements: 1503 o base: All first class objects extend BasicObjType (see 1504 Section 5.1). 1506 o sedGrpOfferKey: The object that identifies the SED that is or has 1507 been offered and the organization that it is or has been offered 1508 to. 1510 o status: The status of the offer, offered or accepted. The server 1511 controls the status. It is automatically set to "offered" when 1512 ever a new SED Group Offer is added, and is automatically set to 1513 "accepted" if and when that offer is accepted. The value of the 1514 element is ignored when passed in by the client. 1516 o offerDateTime: Date and time in UTC when the SED Group Offer was 1517 added. 1519 o acceptDateTime: Date and time in UTC when the SED Group Offer was 1520 accepted. 1522 6.6. Egress Route 1524 In a high-availability environment, the originating SSP likely has 1525 more than one egress path to the ingress SBE of the target SSP. If 1526 the originating SSP wants to exercise greater control and choose a 1527 specific egress SBE to be associated to the target ingress SBE, it 1528 can do so using the EgrRteType object. 1530 An Egress Route object MUST be uniquely identified by attributes as 1531 defined in the description of "ObjKeyType" in the section "Generic 1532 Object Key Type" of this document. 1534 Lets assume that the target SSP has offered as part of his session 1535 establishment data, to share one or more ingress routes and that the 1536 originating SSP has accepted the offer. In order to add the egress 1537 route to the Registry, the originating SSP uses a valid regular 1538 expression to rewrite ingress route in order to include the egress 1539 SBE information. Also, more than one egress route can be associated 1540 with a given ingress route in support of fault-tolerant 1541 configurations. The supporting SPPF structure provides a way to 1542 include route precedence information to help manage traffic to more 1543 than one outbound egress SBE. 1545 The transport protocol MUST support the ability to Add, Get, and 1546 Delete Egress Routes (refer to the "Framework Operations" section of 1547 this document for a generic description of various operations). The 1548 EgrRteType object structure is defined as follows: 1550 1551 1552 1553 1554 1555 1556 1557 1559 1560 1561 1562 1563 1564 1566 The EgrRteType object is composed of the following elements: 1568 o base: All first class objects extend BasicObjType (see 1569 Section 5.1). 1571 o egrRteName: The name of the egress route. 1573 o pref: The preference of this egress route relative to other egress 1574 routes that may get selected when responding to a resolution 1575 request. 1577 o regxRewriteRule: The regular expression re-write rule that should 1578 be applied to the regular expression of the ingress NAPTR(s) that 1579 belong to the ingress route. 1581 o ingrSedGrp: The ingress SED group that the egress route should be 1582 used for. 1584 o svcs: ENUM service(s) that are served by an Egress Route. This 1585 element is used to identify the ingress NAPTRs associated with the 1586 SED Group to which an Egress Route's regxRewriteRule should be 1587 applied. If no ENUM service(s) are associated with an Egress 1588 Route, then the Egress Route's regxRewriteRule should be applied 1589 to all the NAPTRs associated with the SED Group. This field's 1590 value must be of the form specified in [RFC6116] (e.g., 1591 E2U+pstn:sip+sip). The allowable values are a matter of policy 1592 and not limited by this protocol. 1594 o ext: Point of extensibility described in Section 3.3. 1596 7. Framework Operations 1598 In addition to the operation specific object types, all operations 1599 MAY specify the minor version of the protocol that when used in 1600 conjunction with the major version (that can be for instance 1601 specified in the protocol namespace) can serve to identify the 1602 version of the SPPF protocol that the client is using. If the minor 1603 version is not specified, the latest minor version supported by the 1604 SPPF server for the given major version will be used. Additionally, 1605 operations that may potentially modify persistent protocol objects 1606 SHOULD include a transaction ID as well. 1608 7.1. Add Operation 1610 Any conforming transport protocol specification MUST provide a 1611 definition for the operation that adds one or more SPPF objects into 1612 the Registry. If the object, as identified by the request attributes 1613 that form part of the object's key, does not exist, then the Registry 1614 MUST create the object. If the object does exist, then the Registry 1615 MUST replace the current properties of the object with the properties 1616 passed in as part of the Add operation. 1618 Note that this effectively allows to modify a pre-existing object. 1620 If the entity that issued the command is not authorized to perform 1621 this operation an appropriate error message MUST be returned from 1622 amongst the response messages defined in "Response Message Types" 1623 section of the document. 1625 7.2. Delete Operation 1627 Any conforming transport protocol specification MUST provide a 1628 definition for the operation that deletes one or more SPPF objects 1629 from the Registry using the object's key. 1631 If the entity that issued the command is not authorized to perform 1632 this operation an appropriate error message MUST be returned from 1633 amongst the response messages defined in "Response Message Types" 1634 section of the document. 1636 When an object is deleted, any references to that object must of 1637 course also be removed as the SPPF server implementation fulfills the 1638 deletion request. Furthermore, the deletion of a composite object 1639 must also result in the deletion of the objects it contains. As a 1640 result, the following rules apply to the deletion of SPPF object 1641 types: 1643 o Destination Groups: When a destination group is deleted any 1644 references between that destination group and any SED group must 1645 be automatically removed by the SPPF implementation as part of 1646 fulfilling the deletion request. Similarly, any references 1647 between that destination group and any Public Identifier must be 1648 removed by the SPPF implementation as part of fulfilling the 1649 deletion request. 1651 o SED Groups: When a SED group is deleted any references between 1652 that SED group and any destination group must be automatically 1653 removed by the SPPF implementation as part of fulfilling the 1654 deletion request. Similarly any references between that SED group 1655 and any SED records must be removed by the SPPF implementation as 1656 part of fulfilling the deletion request. Furthermore, SED group 1657 offers relating that SED group must also be deleted as part of 1658 fulfilling the deletion request. 1660 o SED Records: When a SED record is deleted any references between 1661 that SED record and any SED group must be removed by the SPPF 1662 implementation as part of fulfilling the deletion request. 1663 Similarly, any reference between that SED record and any Public 1664 Identifier must be removed by the SPPF implementation as part of 1665 fulfilling the deletion request. 1667 o Public Identifiers: When a public identifier is deleted any 1668 references between that public identifier and any referenced 1669 destination group must be removed by the SPPF implementation as 1670 part of fulfilling the deletion request. Any references to SED 1671 records associated directly to that Public Identifier must also be 1672 deleted by the SPPF implementation as part of fulfilling the 1673 deletion request. 1675 7.3. Get Operations 1677 At times, on behalf of the Registrant, the Registrar may need to get 1678 information about SPPF objects that were previously provisioned in 1679 the Registry. A few examples include logging, auditing, and pre- 1680 provisioning dependency checking. This query mechanism is limited to 1681 aid provisioning scenarios and should not be confused with query 1682 protocols provided as part of the resolution system (e.g. ENUM and 1683 SIP). 1685 Any conforming "protocol" specification MUST provide a definition for 1686 the operation that queries the details of one or more SPPF objects 1687 from the Registry using the object's key. If the entity that issued 1688 the command is not authorized to perform this operation an 1689 appropriate error message MUST be returned from amongst the response 1690 messages defined in Section 5.3. 1692 If the response to the Get operation includes object(s) that extend 1693 the BasicObjType, the Registry MUST include the 'cDate' and 'mDate', 1694 if applicable. 1696 7.4. Accept Operations 1698 In SPPF, a SED Group Offer can be accepted or rejected by, or on 1699 behalf of, the Registrant to whom the SED Group has been offered 1700 (refer "Framework Data Model Objects" section of this document for a 1701 description of the SED Group Offer object). The Accept operation is 1702 used to accept the SED Group Offers. Any conforming transport 1703 protocol specification MUST provide a definition for the operation to 1704 accept SED Group Offers by, or on behalf of the Registrant, using the 1705 SED Group Offer object key. 1707 Not until access to a SED Group has been offered and accepted will 1708 the Registrant's organization ID be included in the peeringOrg list 1709 in that SED Group object, and that SED Group's peering information 1710 become a candidate for inclusion in the responses to the resolution 1711 requests submitted by that Registrant. A SED Group Offer that is in 1712 the "offered" status is accepted by, or on behalf of, the Registrant 1713 to which it has been offered. When the SED Group Offer is accepted 1714 the the SED Group Offer is moved to the "accepted" status and adds 1715 that data recipient's organization ID into the list of peerOrgIds for 1716 that SED Group. 1718 If the entity that issued the command is not authorized to perform 1719 this operation an appropriate error message MUST be returned from 1720 amongst the response messages defined in "Response Message Types" 1721 section of the document. 1723 7.5. Reject Operations 1725 In SPPF, a SED Group Offer object can be accepted or rejected by, or 1726 on behalf of, the Registrant to whom the SED Group has been offered 1727 (refer "Framework Data Model Objects" section of this document for a 1728 description of the SED Group Offer object). Furthermore, that offer 1729 may be rejected, regardless of whether or not it has been previously 1730 accepted. The Reject operation is used to reject the SED Group 1731 Offers. When the SED Group Offer is rejected that SED Group Offer is 1732 deleted, and, if appropriate, the data recipient's organization ID is 1733 removed from the list of peeringOrg IDs for that SED Group. Any 1734 conforming transport protocol specification MUST provide a definition 1735 for the operation to reject SED Group Offers by, or on behalf of the 1736 Registrant, using the SED Group Offer object key. 1738 If the entity that issued the command is not authorized to perform 1739 this operation an appropriate error message MUST be returned from 1740 amongst the response messages defined in "Response Message Types" 1741 section of the document. 1743 7.6. Get Server Details Operation 1745 In SPPF, Get Server Details operation can be used to request certain 1746 details about the SPPF server that include the SPPF server's current 1747 status, the major/minor version of the SPPF protocol supported by the 1748 SPPF server. 1750 Any conforming transport protocol specification MUST provide a 1751 definition for the operation to request such details from the SPPF 1752 server. If the entity that issued the command is not authorized to 1753 perform this operation an appropriate error message MUST be returned 1754 from amongst the response messages defined in "Response Message 1755 Types" section of the document. 1757 8. XML Considerations 1759 XML serves as the encoding format for SPPF, allowing complex 1760 hierarchical data to be expressed in a text format that can be read, 1761 saved, and manipulated with both traditional text tools and tools 1762 specific to XML. 1764 XML is case sensitive. Unless stated otherwise, XML specifications 1765 and examples provided in this document MUST be interpreted in the 1766 character case presented to develop a conforming implementation. 1768 This section discusses a small number of XML-related considerations 1769 pertaining to SPPF. 1771 8.1. Namespaces 1773 All SPPF elements are defined in the namespaces in the IANA 1774 Considerations section and in the Formal Framework Specification 1775 section of this document. 1777 8.2. Versioning and Character Encoding 1779 All XML instances SHOULD begin with an declaration to 1780 identify the version of XML that is being used, optionally identify 1781 use of the character encoding used, and optionally provide a hint to 1782 an XML parser that an external schema file is needed to validate the 1783 XML instance. 1785 Conformant XML parsers recognize both UTF-8 (defined in [RFC3629]) 1786 and UTF-16 (defined in [RFC2781]); per [RFC2277] UTF-8 is the 1787 RECOMMENDED character encoding for use with SPPF. 1789 Character encodings other than UTF-8 and UTF-16 are allowed by XML. 1790 UTF-8 is the default encoding assumed by XML in the absence of an 1791 "encoding" attribute or a byte order mark (BOM); thus, the "encoding" 1792 attribute in the XML declaration is OPTIONAL if UTF-8 encoding is 1793 used. SPPF clients and servers MUST accept a UTF-8 BOM if present, 1794 though emitting a UTF-8 BOM is NOT RECOMMENDED. 1796 Example XML declarations: 1798 1800 9. Security Considerations 1802 Many SPPF implementations manage data that is considered confidential 1803 and critical. Furthermore, SPPF implementations can support 1804 provisioning activities for multiple Registrars and Registrants. As 1805 a result any SPPF implementation must address the requirements for 1806 confidentiality, authentication, and authorization. 1808 9.1. Confidentiality and Authentication 1810 With respect to confidentiality and authentication, the transport 1811 protocol requirements section of this document contains security 1812 properties that the transport protocol must provide so that 1813 authenticated endpoints can exchange data confidentially and with 1814 integrity protection. Refer to that section and the resulting 1815 transport protocol specification document for the specific solutions 1816 to authentication and confidentiality. 1818 9.2. Authorization 1820 With respect to authorization, the SPPF server implementation must 1821 define and implement a set of authorization rules that precisely 1822 address (1) which Registrars will be authorized to create/modify/ 1823 delete each SPPF object type for given Registrant(s) and (2) which 1824 Registrars will be authorized to view/get each SPPF object type for 1825 given Registrant(s). These authorization rules are a matter of 1826 policy and are not specified within the context of SPPF. However, 1827 any SPPF implementation must specify these authorization rules in 1828 order to function in a reliable and safe manner. 1830 9.3. Denial of Service 1832 Guidance on Denial-of-Service (DoS) issues in general is given in 1833 [RFC4732], "Internet Denial of Service Considerations", which also 1834 gives a general vocabulary for describing the DoS issue. 1836 SPPF is a high-level client-server protocol that can be implemented 1837 on lower-level mechanisms such as remote procedure call and web- 1838 service API protocols. As such, it inherits any Denial-of-Service 1839 issues inherent to the specific lower-level mechanism used for any 1840 implementation of SPPF. SPPF also has its own set of higher-level 1841 exposures that are likely to be independent of lower-layer mechanism 1842 choices. 1844 9.3.1. DoS Issues Inherited from Transport Mechanism 1846 SPPF implementation is in general dependent on the selection and 1847 implementation of a lower-level transport protocol and a binding 1848 between that protocol and SPPF. The archetypal SPPF implementation 1849 uses XML (http://www.w3.org/TR/xml/) representation in a SOAP 1850 (http://www.w3.org/TR/soap/) request/response framework over HTTP 1851 ([RFC7230]), and probably also uses TLS ([RFC5246]) for on-the wire 1852 data integrity and participant authentication, and might use HTTP 1853 Digest authentication ([RFC2609]). 1855 The typical deployment scenario for SPPF is to have servers in a 1856 managed facility, and therefore techniques such as Network Ingress 1857 Filtering ([RFC2609]) are generally applicable. In short, any DoS 1858 mechanism affecting a typical HTTP implementation would affect such 1859 an SPPF implementation, and the mitigation tools for HTTP in general 1860 also therefore apply to SPPF. 1862 SPPF does not directly specify an authentication mechanism, instead 1863 relying on the lower-level transport protocol to provide for 1864 authentication. In general, authentication is an expensive 1865 operation, and one apparent attack vector is to flood an SPPF server 1866 with repeated requests for authentication, thereby exhausting its 1867 resources. SPPF implementations SHOULD therefore be prepared to 1868 handle authentication floods, perhaps by noting repeated failed login 1869 requests from a given source address and blocking that source 1870 address. 1872 9.3.2. DoS Issues Specific to SPPF 1874 The primary defense mechanism against DoS within SPPF is 1875 authentication. Implementations MUST tightly control access to the 1876 SPPF service, SHOULD implement DoS and other policy control 1877 screening, and MAY employ a variety of policy violation reporting and 1878 response measures such as automatic blocking of specific users and 1879 alerting of operations personnel. In short, the primary SPPF 1880 response to DoS-like activity by a user is to block that user or 1881 subject their actions to additional review. 1883 SPPF allows a client to submit multiple-element or "batch" requests 1884 that may insert or otherwise affect a large amount of data with a 1885 single request. In the simplest case, the server progresses 1886 sequentially through each element in a batch, completing one and 1887 before starting the next. Mid-batch failures are handled by stopping 1888 the batch and rolling-back the data store to its pre-request state. 1889 This "stop and roll-back" design provides a DoS opportunity. A 1890 hostile client could repeatedly issue large batch requests with one 1891 or more failing elements, causing the server to repeatedly stop and 1892 roll-back large transactions. The suggested response is to monitor 1893 clients for such failures, and take administrative action (such as 1894 blocking the user) when an excessive number of roll-backs is 1895 reported. 1897 An additional suggested response is for an implementer to set their 1898 maximum allowable XML message size, and their maximum allowable batch 1899 size at a level that they feel protects their operational instance, 1900 given the hardware sizing they have in place and the expected load 1901 and size needs that their users expect. 1903 9.4. Information Disclosure 1905 It is not uncommon for the logging systems to document on-the-wire 1906 messages for various purposes, such as, debug, audit, and tracking. 1907 At the minimum, the various support and administration staff will 1908 have access to these logs. Also, if an unprivileged user gains 1909 access to the SPPF deployments and/or support systems, it will have 1910 access to the information that is potentially deemed confidential. 1911 To manage information disclosure concerns beyond the transport level, 1912 SPPF implementations MAY provide support for encryption at the SPPF 1913 object level. 1915 9.5. Non Repudiation 1917 In some situations, it may be required to protect against denial of 1918 involvement (see [RFC4949]) and tackle non-repudiation concerns in 1919 regards to SPPF messages. This type of protection is useful to 1920 satisfy authenticity concerns related to SPPF messages beyond the 1921 end-to-end connection integrity, confidentiality, and authentication 1922 protection that the transport layer provides. This is an optional 1923 feature and some SPPF implementations MAY provide support for it. 1925 9.6. Replay Attacks 1927 Anti-replay protection ensures that a given SPPF object replayed at a 1928 later time doesn't affect the integrity of the system. SPPF provides 1929 at least one mechanism to fight against replay attacks. Use of the 1930 optional client transaction identifier allows the SPPF client to 1931 correlate the request message with the response and to be sure that 1932 it is not a replay of a server response from earlier exchanges. Use 1933 of unique values for the client transaction identifier is highly 1934 encouraged to avoid chance matches to a potential replay message. 1936 9.7. Man in the Middle 1938 The SPPF client or Registrar can be a separate entity acting on 1939 behalf of the Registrant in facilitating provisioning transactions to 1940 the Registry. Further, the transport layer provides end-to-end 1941 connection protection between SPPF client and the SPPF server. 1942 Therefore, man-in-the-middle attack is a possibility that may affect 1943 the integrity of the data that belongs to the Registrant and/or 1944 expose peer data to unintended actors in case well-established 1945 peering relationships already exist. 1947 10. Internationalization Considerations 1949 Character encodings to be used for SPPF elements are described in 1950 Section 8.2. The use of time elements in the protocol is specified 1951 in Section 3.2. Where human-readable languages are used in the 1952 protocol, those messages SHOULD be tagged according to [RFC5646], and 1953 the transport protocol MUST support a respective mechanism to 1954 transmit such tags together with those human-readable messages. If 1955 tags are absent, the language of the message defaults to "en" 1956 (English). 1958 11. IANA Considerations 1960 11.1. URN Assignments 1962 This document uses URNs to describe XML namespaces and XML schemas 1963 conforming to a Registry mechanism described in [RFC3688]. 1965 Two URI assignments are requested. 1967 Registration request for the SPPF XML namespace: 1968 urn:ietf:params:xml:ns:sppf:base:1 1969 Registrant Contact: IESG 1970 XML: None. Namespace URIs do not represent an XML specification. 1972 Registration request for the XML schema: 1973 URI: urn:ietf:params:xml:schema:sppf:1 1974 Registrant Contact: IESG 1975 XML: See the "Formal Specification" section of this document 1976 (Section 12). 1978 11.2. Organization Identifier Namespace Registry 1980 IANA is requested to create and maintain a Registry entitled "SPPF 1981 OrgIdType Namespaces". Strings used as OrgIdType Namespace 1982 identifiers MUST conform to the following syntax in the Augmented 1983 Backus-Naur Form (ABNF) [RFC5234] 1985 namespace = ALPHA * (ALPHA/DIGIT/"-") 1987 Assignments consist of the OrgIdType namespace string, and the 1988 definition of the associated namespace. This document makes the 1989 following initial assignment for the OrgIdType Namespaces: 1991 OrgIdType namespace string Namespace 1992 -------------------------- --------- 1993 IANA Enterprise Numbers iana-en 1995 Future assignments are to be made through the well known IANA Policy 1996 "RFC Required" (see section 4.1 of [RFC5226]) 1998 12. Formal Specification 2000 This section provides the draft XML Schema Definition for SPPF 2001 Protocol. 2003 2004 2008 2009 2010 ---- Generic Object key types to be defined by specific 2011 Transport/Architecture. The types defined here can 2012 be extended by the specific architecture to 2013 define the Object Identifiers ---- 2014 2015 2016 2018 2019 2020 ---- Generic type that represents the 2021 key for various objects in SPPF. ---- 2022 2023 2024 2025 2026 2027 2028 2029 2030 ---- Generic type that represents 2031 the key for a SED group offer. ---- 2032 2033 2034 2035 2036 2038 2039 2040 2041 2042 2043 ----Generic type that 2044 represents the key 2045 for a Pub Id. ---- 2046 2047 2048 2049 2050 2052 2053 2054 ---- Object Type Definitions ---- 2055 2056 2058 2059 2060 2061 2062 2063 2065 2067 2069 2071 2072 2073 2075 2076 2077 2078 2079 2080 2081 2082 2083 2085 2086 2087 2088 2089 2090 2091 2092 2093 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2223 2224 2225 2226 2227 2228 2229 2230 2231 ---- Abstract Object and Element Type Definitions ---- 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2398 13. Acknowledgments 2400 This document is a result of various discussions held in the DRINKS 2401 working group and within the DRINKS protocol design team, with 2402 contributions from the following individuals, in alphabetical order: 2403 Alexander Mayrhofer, David Schwartz, Deborah A Guyton, Lisa 2404 Dusseault, Manjul Maharishi, Mickael Marrache, Otmar Lendl, Richard 2405 Shockey, Samuel Melloul, Sumanth Channabasappa, Syed Ali, Vikas 2406 Bhatia, and Jeremy Barkan 2408 14. References 2410 14.1. Normative References 2412 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 2413 Requirement Levels", BCP 14, RFC 2119, March 1997. 2415 [RFC2277] Alvestrand, H., "IETF Policy on Character Sets and 2416 Languages", BCP 18, RFC 2277, January 1998. 2418 [RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO 2419 10646", STD 63, RFC 3629, November 2003. 2421 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, 2422 January 2004. 2424 [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform 2425 Resource Identifier (URI): Generic Syntax", STD 66, RFC 2426 3986, January 2005. 2428 [RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an 2429 IANA Considerations Section in RFCs", BCP 26, RFC 5226, 2430 May 2008. 2432 [RFC5234] Crocker, D. and P. Overell, "Augmented BNF for Syntax 2433 Specifications: ABNF", STD 68, RFC 5234, January 2008. 2435 14.2. Informative References 2437 [RFC2609] Guttman, E., Perkins, C., and J. Kempf, "Service Templates 2438 and Service: Schemes", RFC 2609, June 1999. 2440 [RFC2781] Hoffman, P. and F. Yergeau, "UTF-16, an encoding of ISO 2441 10646", RFC 2781, February 2000. 2443 [RFC3261] Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, 2444 A., Peterson, J., Sparks, R., Handley, M., and E. 2445 Schooler, "SIP: Session Initiation Protocol", RFC 3261, 2446 June 2002. 2448 [RFC3403] Mealling, M., "Dynamic Delegation Discovery System (DDDS) 2449 Part Three: The Domain Name System (DNS) Database", RFC 2450 3403, October 2002. 2452 [RFC4725] Mayrhofer, A. and B. Hoeneisen, "ENUM Validation 2453 Architecture", RFC 4725, November 2006. 2455 [RFC4732] Handley, M., Rescorla, E., and IAB, "Internet Denial-of- 2456 Service Considerations", RFC 4732, December 2006. 2458 [RFC4949] Shirey, R., "Internet Security Glossary, Version 2", RFC 2459 4949, August 2007. 2461 [RFC5067] Lind, S. and P. Pfautz, "Infrastructure ENUM 2462 Requirements", RFC 5067, November 2007. 2464 [RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security 2465 (TLS) Protocol Version 1.2", RFC 5246, August 2008. 2467 [RFC5486] Malas, D. and D. Meyer, "Session Peering for Multimedia 2468 Interconnect (SPEERMINT) Terminology", RFC 5486, March 2469 2009. 2471 [RFC5646] Phillips, A. and M. Davis, "Tags for Identifying 2472 Languages", BCP 47, RFC 5646, September 2009. 2474 [RFC6116] Bradner, S., Conroy, L., and K. Fujiwara, "The E.164 to 2475 Uniform Resource Identifiers (URI) Dynamic Delegation 2476 Discovery System (DDDS) Application (ENUM)", RFC 6116, 2477 March 2011. 2479 [RFC6461] Channabasappa, S., "Data for Reachability of Inter-/Intra- 2480 NetworK SIP (DRINKS) Use Cases and Protocol Requirements", 2481 RFC 6461, January 2012. 2483 [RFC7230] Fielding, R. and J. Reschke, "Hypertext Transfer Protocol 2484 (HTTP/1.1): Message Syntax and Routing", RFC 7230, June 2485 2014. 2487 [Unicode6.1] 2488 The Unicode Consortium, "The Unicode Standard - Version 2489 6.1", Unicode 6.1, January 2012. 2491 Authors' Addresses 2493 Kenneth Cartwright 2494 TNS 2495 1939 Roland Clarke Place 2496 Reston, VA 20191 2497 USA 2499 Email: kcartwright@tnsi.com 2500 Vikas Bhatia 2501 TNS 2502 1939 Roland Clarke Place 2503 Reston, VA 20191 2504 USA 2506 Email: vbhatia@tnsi.com 2508 Syed Wasim Ali 2509 NeuStar 2510 46000 Center Oak Plaza 2511 Sterling, VA 20166 2512 USA 2514 Email: syed.ali@neustar.biz 2516 David Schwartz 2517 XConnect 2518 316 Regents Park Road 2519 London N3 2XJ 2520 United Kingdom 2522 Email: dschwartz@xconnect.net