Babel Hashed Message Authentication Code (HMAC) Cryptographic Authentication
draft-ovsienko-babel-hmac-authentication-09
The information below is for an old version of the document that is already published as an RFC.
Document | Type |
This is an older version of an Internet-Draft that was ultimately published as RFC 7298.
|
|
---|---|---|---|
Author | Denis Ovsienko | ||
Last updated | 2014-07-11 (Latest revision 2014-04-18) | ||
RFC stream | Independent Submission | ||
Intended RFC status | Experimental | ||
Formats | |||
IETF conflict review | conflict-review-ovsienko-babel-hmac-authentication | ||
Stream | ISE state | Published RFC | |
Consensus boilerplate | Unknown | ||
Document shepherd | Eliot Lear | ||
Shepherd write-up | Show Last changed 2014-03-21 | ||
IESG | IESG state | Became RFC 7298 (Experimental) | |
Telechat date | (None) | ||
Responsible AD | (None) | ||
Send notices to | (None) | ||
IANA | IANA review state | Version Changed - Review Needed | |
IANA action state | No IANA Actions |
draft-ovsienko-babel-hmac-authentication-09
Network Working Group Sean Turner Internet Draft sn3rd Intended Status: Standards Track January 22, 2017 Expires: July 26, 2017 EST Extensions draft-turner-est-extensions-08.txt Abstract The EST (Enrollment over Secure Transport) protocol defined a Well- Known URI (Uniform Resource Identifier): /.well-known/est. EST also defined several path components that clients use for PKI (Public Key Infrastructure) services, namely certificate enrollment (e.g., /simpleenroll). In some sense, the services provided by the path components can be thought of as PKI management-related packages. There are additional PKI-related packages a client might need as well as other security-related packages, such as firmware, trust anchors, and symmetric, asymmetric, and encrypted keys. This document also specifies the PAL (Package Availability List), which is an XML (Extensible Markup Language) file or JSON (Javascript Object Notation) object that clients use to retrieve packages available and authorized for them. This document extends the EST server path components to provide these additional services. Status of this Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at http://datatracker.ietf.org/drafts/current/. 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." Copyright Notice Copyright (c) 2017 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 (http://trustee.ietf.org/license-info) in effect on the date of Turner Expires July 26, 2017 [Page 1] Internet-Draft EST Extensions January 22, 2017 publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Definitions . . . . . . . . . . . . . . . . . . . . . . . 5 1.2. Authentication and Authorization . . . . . . . . . . . . . 6 1.3. TLS Cipher Suites . . . . . . . . . . . . . . . . . . . . 6 1.4. URI Configuration . . . . . . . . . . . . . . . . . . . . 6 1.5. Content-Transfer-Encoding . . . . . . . . . . . . . . . . 6 1.6. Message Types . . . . . . . . . . . . . . . . . . . . . . 7 1.7. Key Words . . . . . . . . . . . . . . . . . . . . . . . . 9 2. Locate Available Packages . . . . . . . . . . . . . . . . . . 9 2.1. PAL Format . . . . . . . . . . . . . . . . . . . . . . . . 10 2.1.1. PAL Package Types . . . . . . . . . . . . . . . . . . 11 2.1.2. PAL XML Schema . . . . . . . . . . . . . . . . . . . . 16 2.1.3. PAL JSON Object . . . . . . . . . . . . . . . . . . . 19 2.2. Request PAL . . . . . . . . . . . . . . . . . . . . . . . 20 2.3. Provide PAL . . . . . . . . . . . . . . . . . . . . . . . 20 3. Distribute EE Certificates . . . . . . . . . . . . . . . . . . 21 3.1. EE Certificate Request . . . . . . . . . . . . . . . . . . 22 3.2. EE Certificate Response . . . . . . . . . . . . . . . . . 22 4. Distribute CRLs and ARLs . . . . . . . . . . . . . . . . . . . 22 4.1. CRL Request . . . . . . . . . . . . . . . . . . . . . . . 23 4.2. CRL Response . . . . . . . . . . . . . . . . . . . . . . . 23 5. Symmetric Keys, Receipts, and Errors . . . . . . . . . . . . . 23 5.1. Symmetric Keys . . . . . . . . . . . . . . . . . . . . . . 23 5.1.1. Distribute Symmetric Keys . . . . . . . . . . . . . . 24 5.1.2. Symmetric Key Response . . . . . . . . . . . . . . . . 24 5.2. Symmetric Key Receipts and Errors . . . . . . . . . . . . 25 5.2.1. Provide Symmetric Key Receipt or Error . . . . . . . . 26 5.2.2. Symmetric Key Receipt or Error Response . . . . . . . 27 6. Firmware, Receipts, and Errors . . . . . . . . . . . . . . . . 27 6.1. Firmware . . . . . . . . . . . . . . . . . . . . . . . . . 27 6.1.1. Distribute Firmware . . . . . . . . . . . . . . . . . 27 6.1.2. Firmware Response . . . . . . . . . . . . . . . . . . 28 6.2. Firmware Receipts and Errors . . . . . . . . . . . . . . . 28 6.2.1. Provide Firmware Receipt or Error . . . . . . . . . . 29 6.2.2. Firmware Receipt or Error Response . . . . . . . . . . 29 7. Trust Anchor Management Protocol . . . . . . . . . . . . . . . 29 7.1. TAMP Status Query, Trust Anchor Update, Apex Trust Anchor Update, . . . . . . . . . . . . . . . . . . . . . . 30 Turner Expires July 26, 2017 [Page 2] Internet-Draft EST Extensions January 22, 2017 Community Update, and Sequence Number Adjust . . . . . . . . 30 7.1.1. Request TAMP Packages . . . . . . . . . . . . . . . . 30 7.1.2. Return TAMP Packages . . . . . . . . . . . . . . . . . 30 7.2. TAMP Response, Confirm, and Errors . . . . . . . . . . . . 31 7.2.1. Provide TAMP Response, Confirm, or Error . . . . . . . 31 7.2.2. TAMP Response, Confirm, and Error Response . . . . . . 31 8. Asymmetric Keys, Receipts, and Errors . . . . . . . . . . . . 32 8.1. Asymmetric Key Encapsulation . . . . . . . . . . . . . . . 32 8.2. Asymmetric Key Package Receipts and Errors . . . . . . . . 33 8.3. PKCS#12 . . . . . . . . . . . . . . . . . . . . . . . . . 34 8.3.1. Server-Side Key Generation Request . . . . . . . . . . 34 8.3.2. Server-Side Key Generation Response . . . . . . . . . 34 9. PAL & Certificate Enrollment . . . . . . . . . . . . . . . . . 34 10. Security Considerations . . . . . . . . . . . . . . . . . . . 37 11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 38 11.1. PAL Name Space . . . . . . . . . . . . . . . . . . . . . 38 11.2. PAL Schema . . . . . . . . . . . . . . . . . . . . . . . 38 11.3. PAL Package Types . . . . . . . . . . . . . . . . . . . . 38 12. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 39 13. References . . . . . . . . . . . . . . . . . . . . . . . . . 39 13.1. Normative References . . . . . . . . . . . . . . . . . . 39 13.2. Informative References . . . . . . . . . . . . . . . . . 44 Appendix A. Example Use of PAL . . . . . . . . . . . . . . . . . 44 Appendix B. Additional CSR Attributes . . . . . . . . . . . . . . 46 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 47 1. Introduction The EST (Enrollment over Secure Transport) protocol [RFC7030] defines the Well-Known URI (Uniform Resource Identifier) /.well-known/est to support selected PKI (Public Key Infrastructure) related services with path components (PCs) such as simple enrollment with /simpleenroll, rekey/renew with /simplereenroll, etc. A server that wishes to support additional PKI-related services and other security- related packages could use the same .well-known URI by defining additional PCs. This document defines six such PCs: o /pal - The PAL (Package Availability List) provides a list of all known packages available and authorized for a client. By accessing the service provided by this PC first, the client can walk through the PAL and download all the packages necessary to begin operating securely. The PAL essentially points to other PCs including the ones defined in this document as well as those defined in [RFC7030], which include /cacerts, /simpleenroll, /simplereenroll, /fullcmc, /serverkeygen, and /csrattrs. The /pal PC is described in Section 2. Turner Expires July 26, 2017 [Page 3] 3.2. LocalTS LocalTS is a 32-bit unsigned integer variable, it is the TS part of a per-interface TS/PC number. LocalTS is a strictly per-interface variable not intended to be changed by the operator. Its initialization is explained in Section 5.1. 3.3. LocalPC LocalPC is a 16-bit unsigned integer variable, it is the PC part of a per-interface TS/PC number. LocalPC is a strictly per-interface variable not intended to be changed by the operator. Its initialization is explained in Section 5.1. 3.4. MaxDigestsIn MaxDigestsIn is an unsigned integer parameter conceptually purposed for limiting the amount of CPU time spent processing a received authenticated packet. The receiving procedure performs the most CPU- intensive operation, the HMAC computation, only at most MaxDigestsIn (Section 5.4 item 7) times for a given packet. MaxDigestsIn value MUST be at least 2. An implementation SHOULD make MaxDigestsIn a per-interface parameter, but MAY make it specific to the whole protocol instance. An implementation SHOULD allow the operator to change the value of MaxDigestsIn at runtime or by means of Babel speaker restart. An implementation MUST allow the operator to discover the effective value of MaxDigestsIn at runtime or from the system documentation. 3.5. MaxDigestsOut MaxDigestsOut is an unsigned integer parameter conceptually purposed for limiting the amount of a sent authenticated packet's space spent on authentication data. The sending procedure adds at most MaxDigestsOut (Section 5.3 item 5) HMAC results to a given packet, concurring with the output buffer management explained in Section 6.2. The MaxDigestsOut value MUST be at least 2. An implementation SHOULD make MaxDigestsOut a per-interface parameter, but MAY make it specific to the whole protocol instance. An implementation SHOULD allow the operator to change the value of MaxDigestsOut at runtime or by means of Babel speaker restart, in a safe range. The maximum safe value of MaxDigestsOut is implementation-specific (see Section 6.2). An implementation MUST allow the operator to discover the effective value of MaxDigestsOut at runtime or from the system documentation. Ovsienko Expires October 20, 2014 [Page 12] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 3.6. ANM Table The ANM (Authentic Neighbours Memory) table resembles the neighbour table defined in Section 3.2.3 of [BABEL]. Note that the term "neighbour table" means the neighbour table of the original Babel specification, and the term "ANM table" means the table defined herein. Indexing of the ANM table is done in exactly the same way as indexing of the neighbour table, but purpose, field set and associated procedures are different. The conceptual purpose of the ANM table is to provide longer term replay attack protection than it would be possible using the neighbour table. Expiry of an inactive entry in the neighbour table depends on the last received Hello Interval of the neighbour and typically stands for tens to hundreds of seconds (see Appendix A and Appendix B of [BABEL]). Expiry of an inactive entry in the ANM table depends only on the local speaker's configuration. The ANM table retains (for at least the amount of seconds set by ANM timeout parameter defined in Section 3.7) a copy of TS/PC number advertised in authentic packets by each remote Babel speaker. The ANM table is indexed by pairs of the form (Interface, Source). Every table entry consists of the following fields: o Interface An implementation-specific reference to the local node's interface that the authentic packet was received through. o Source The source address of the Babel speaker that the authentic packet was received from. o LastTS A 32-bit unsigned integer, the TS part of a remote TS/PC number. o LastPC A 16-bit unsigned integer, the PC part of a remote TS/PC number. Each ANM table entry has an associated aging timer, which is reset by the receiving procedure (Section 5.4 item 9). If the timer expires, the entry is deleted from the ANM table. An implementation SHOULD use a persistent memory (NVRAM) to retain the contents of ANM table across restarts of the Babel speaker, but Ovsienko Expires October 20, 2014 [Page 13] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 only as long as both the Interface field reference and expiry of the aging timer remain correct. An implementation MUST make it clear, if and how persistent memory is used for ANM table. An implementation SHOULD allow the operator to retrieve the current contents of ANM table at runtime. An implementation SHOULD allow the operator to remove some or all of ANM table entries at runtime or by means of Babel speaker restart. 3.7. ANM Timeout ANM timeout is an unsigned integer parameter. An implementation SHOULD make ANM timeout a per-interface parameter, but MAY make it specific to the whole protocol instance. ANM timeout is conceptually purposed for limiting the maximum age (in seconds) of entries in the ANM table standing for inactive Babel speakers. The maximum age is immediately related to replay attack protection strength. The strongest protection is achieved with the maximum possible value of ANM timeout set, but it may not provide the best overall result for specific network segments and implementations of this mechanism. In the first turn, implementations unable to maintain local TS/PC number strictly increasing across Babel speaker restarts will reuse the advertised TS/PC numbers after each restart (see Section 5.1). The neighbouring speakers will treat the new packets as replayed and discard them until the aging timer of respective ANM table entry expires or the new TS/PC number exceeds the one stored in the entry. Another possible, but less probable, case could be an environment using IPv6 for Babel datagrams exchange and involving physical moves of network interfaces hardware between Babel speakers. Even performed without restarting the speakers, these would cause random drops of the TS/PC number advertised for a given (Interface, Source) index, as viewed by neighbouring speakers, since IPv6 link-local addresses are typically derived from interface hardware addresses. Assuming that in such cases the operators would prefer to use a lower ANM timeout value to let the entries expire on their own rather than having to manually remove them from the ANM table each time, an implementation SHOULD set the default value of ANM timeout to a value between 30 and 300 seconds. At the same time, network segments may exist with every Babel speaker having its advertised TS/PC number strictly increasing over the deployed lifetime. Assuming that in such cases the operators would prefer using a much higher ANM timeout value, an implementation SHOULD allow the operator to change the value of ANM timeout at runtime or by means of Babel speaker restart. An implementation MUST allow the operator to discover the effective value of ANM timeout at Ovsienko Expires October 20, 2014 [Page 14] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 runtime or from the system documentation. 3.8. Configured Security Associations A Configured Security Association (CSA) is a data structure conceptually purposed for associating authentication keys and hash algorithms with Babel interfaces. All CSAs are managed in finite sequences, one sequence per interface ("interface's sequence of CSAs" hereafter). Each interfaceInternet-Draft EST Extensions January 22, 2017 o /eecerts - EE (End-Entity) certificates are needed by the client when they invoke a security protocol for communicating with a peer (i.e., they become operational and do something meaningful as opposed to just communicating with the infrastructure). If the infrastructure knows the certificate(s) needed by the client, then providing the peer's certificate avoids the client having to discover the peer's certificate. This service is not meant to be a general purpose repository to which clients query a "repository" and then get a response; this is purely a push mechanism. The /eecerts PC is described in Section 3. o /crls - CRLs (Certificate Revocation Lists) and Authority Revocation Lists (ARLs) are also needed by the client when they validate certificate paths. CRLs (and ARLs) from TAs (Trust Anchors) and intermediate CAs (Certification Authorities) are needed to validate the certificates used to generate the client's certificate or the peer's certificate, which is provided by the /eecerts PC, and providing them saves the client from having to "discover" them and then retrieve them. CRL "discovery" is greatly aided by the inclusion of the CRL Distribution Point certificate extension [RFC5280], but this extension is not always present in certificates and requires another connection to retrieve them. Like the /eecerts PC, this service is not meant to be a general purpose repository to which clients query a repository and then get a response; this is purely a push mechanism. The /crls PC is described in Section 4. o /symmetrickeys - In some cases, clients use symmetric keys when communicating with their peers. If the client's peers are known by the server a priori, then providing them saves the client or an administrator from later having to find, retrieve and install them. Like the /eecerts and /crls PCs, this service is not meant to be a general purpose repository to which clients query a repository and then get a response; this is purely a push mechanism for the keys themselves. However, things do not always go as planned and clients need to inform the server about any errors. If things did go well, then the client, if requested, needs to provide a receipt. The /symmetrickeys and /symmetrickeys/return PCs are described in Section 5. o /firmware - Some client firmware and software support automatic updates mechanism and some do not. For those that do not, the /firmware PC provides a mechanism for the infrastructure to inform the client that a firmware and software updates are available. Because updates do not always go as planned and because sometimes the server needs to know whether the firmware was received and processed, this PC also provides a mechanism to return errors and receipts. The /firmware and /firmware/return Turner Expires July 26, 2017 [Page 4] Internet-Draft EST Extensions January 22, 2017 PCs are defined in Section 6. o /tamp - To control the TAs in client TA databases, servers use the /tamp PC to request that clients retrieve a TAMP query, update, and adjust packages and clients use the /tamp/return PC to return response, confirm, and error. The /tamp and /tamp/return PCs are defined in Section 7. This document also extends the /est/serverkeygen PC [RFC7030] to support (see Section 8): o Returning asymmetric key package receipts and errors. o Encapsulating returned asymmetric keys in additional CMS content types. o Returning server-generated public key pairs encapsulated in PKCS#12 [RFC7292]. While the motivation is to provide packages to clients during enrollment so that they can perform securely after enrollment, the services defined in this specification can be used after enrollment. 1.1. Definitions Familiarity with Using Cryptographic Message Syntax (CMS) to Protect Firmware Packages [RFC4108], Certificate Management over CMS (CMC) [RFC5272], Cryptographic Message Syntax (CMS) Encrypted Key Package [RFC6032], Cryptographic Message Syntax (CMS) [RFC5652][RFC6268], Trust Anchor Management Protocol (TAMP) [RFC5934], Cryptographic Message Syntax (CMS) Content Constraints Extension [RFC6010], CMS Symmetric Key Package Content Type [RFC6031], Enrollment over Secure Transport protocol [RFC7030], CMS Key Package Receipt and Error Content Types [RFC7191] is assumed. Also, familiarity with the CMS protecting content types signed data and encrypted data is assumed; CMS signed data and encrypted data are defined in [RFC5652] and encrypted key package is defined in [RFC6032]. In addition to the definitions found in [RFC7030], the following definitions are used in this document: Agent: An entity that performs functions on behalf of a client. Agents can service a) one or more clients on the same network as the server, b) clients on non-IP based networks, or c) clients that have an air gap [RFC4949] between themselves and the server; interactions between the agent and client in the last two cases are beyond the scope of this document. Before an agent can service clients, the agent must have a trust relationship with the server, be authorized Turner Expires July 26, 2017 [Page 5] Internet-Draft EST Extensions January 22, 2017 to act on behalf of clients. Client: A device that ultimately consumes and uses the packages to enable communications. In other words, the client is the end-point for the packages and an agent may have one or more clients. To avoid confusion, this document henceforth uses the term client to refer to both agents and clients. Package: An object that contains one or more content types. There are numerous types of packages: Asymmetric Keys, Symmetric Keys, Encrypted Keys, CRLs, Public Key Certificate Management, Firmware, Public Key Certificates, and TAMP packages. All of these packages are digitally signed and encapsulated in a CMS signed data [RFC5652][RFC6268] (except the public key certificates and CRLs that are already digitally signed); Firmware receipts and errors, TAMP responses, confirms, and errors, as well as Key Package receipts and errors can be optionally signed. Certificate and CRLs are included in a package that uses signed data, which is often referred to as a degenerate CMS or "certs-only" or "crls-only" message [RFC5751][RFC6268], but no signature or content is present; hence the name certs-only and crls-only. 1.2. Authentication and Authorization Client and server authentication as well as client and server authorization are as defined in [RFC7030]. The requirements for each are discussed in the request and response sections of each of the PCs defined by this document. The requirements for the TA databases are as specified in [RFC7030] as well. 1.3. TLS Cipher Suites TLS cipher suite and issues associated with them are as defined in [RFC7030]. 1.4. URI Configuration As specified in Section 3.1 of [RFC7030], the client is configured with sufficient information to form the server URI [RFC3986]. Like EST, this configuration mechanism is beyond the scope of this document. 1.5. Content-Transfer-Encoding A Content-Transfer encoding of "base64" [RFC2045] is used for all client server interactions. Turner Expires July 26, 2017 [Page 6] Internet-Draft EST Extensions January 22, 2017 1.6. Message Types This document uses existing media types for the messages as specified by FTP and HTTP [RFC2585], application/pkcs10 [RFC5967], and CMC [RFC5272]. For consistency with [RFC5273], each distinct EST message type uses an HTTP Content-Type header with a specific media type. The EST messages and their corresponding media types for each operation are: +--------------------+--------------------------+-------------------+ | Message type | Request media type | Request section(s)| | | Response media type(s) | Response section | | (per operation) | Source(s) of types | | +====================+==========================+===================+ | Locate Available | N/A | Section 2.2 | | Packages | application/xml or | Section 2.3 | | | application/json | | | | [RFC7303][RFC4627] | | | /pal | | | +====================+==========================+===================+ | Distribute EE | N/A | Section 3.1 | | Certificates | application/pkcs7-mime | Section 3.2 | | | [RFC5751] | | | /eecerts | | | +====================+==========================+===================+ | Distribute CRLs | N/A | Section 4.1 | | | application/pkcs7-mime | Section 4.2 | | | [RFC5751] | | | /crls | | | +====================+==========================+===================+ | Symmetric Key | N/A | Section 5.1.1 | | Distribution | application/cms | Section 5.1.2 | | | [RFC7193] | | | /symmetrickeys | | | +====================+==========================+===================+ | Return Symmetric | application/cms | Section 5.2.1 | | Key | N/A | Section 5.2.2 | | Receipts/Errors | [RFC7193] | | | | | | | /symmetrickeys/ | | | | return | | | +====================+==========================+===================+ | Firmware | N/A | Section 6.1.1 | | Distribution | application/cms | Section 6.1.2 | | | [RFC7193] | | Turner Expires July 26, 2017 [Page 7] Internet-Draft EST Extensions January 22, 2017 | /firmware | | | +====================+==========================+===================+ | Return Firmware | application/cms | Section 6.2.1 | | Receipts/Errors | N/A | Section 6.2.2 | | | [RFC7193] | | | /firmware/return | | | +====================+==========================+===================+ | Trust Anchor | N/A | Section 7.1.1 | | Management | application/ | Section 7.1.2 | | | tamp-status-query | | | | tamp-update | | | | tamp-apex-update | | | | tamp-community-update | | | | tamp-sequence-adjust | | | | [RFC5934] | | | /tamp | | | +====================+==========================+===================+ | Return TAMP | application/ | Section 7.2.1 | | Responses/ | tamp-status-query-response | | | Confirms/ | tamp-update-confirm | | | Errors | tamp-apex-update-confirm | | | | tamp-community-update-confirm | | | | tamp-sequence-adjust-confirm | | | | tamp-error | | | | N/A | Section 7.2.2 | | | [RFC5934] | | | /tamp/return | | | +====================+==========================+===================+ | Server-Side Key | application/pkcs10 with | Section 8.1 | | Generation | content type attribute | | | | CSR | | | | application/cms | Section 8.1 | | /serverkeygen | [RFC7193] | | +====================+==========================+===================+ | Return Asymmetric | application/cms | Section 8.2 | | Key | N/A | Section 8.2 | | Receipts/Errors | [RFC7193] | | | | | | | /serverkeygen/ | | | | return | | | +====================+==========================+===================+ | Server-Side Key | application/pkcs10 | Section 8.3.1 | | Generation: | application/pkcs12 | Section 8.3.2 | | PKCS#12 | | | | | | | | /serverkeygen | [RFC7193] | | +====================+==========================+===================+ Turner Expires July 26, 2017 [Page 8] Internet-Draft EST Extensions January 22, 2017 1.7. Key Words The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. 2. Locate Available Packages The PAL (Package Availability List) is either an XML (Extensible Markup Language) file [XML] or JSON (Javascript Object Notation) [RFC7159] object that furnishes information for packages that are currently available and authorized for retrieval by a client. It provides client specific: o Advertisements for available packages that can be retrieved from the server; o Notifications to begin public key certificate management or to return package receipts and errors; and o Advertisement for another PAL. A client can use this service to determine all of the security- related products for bootstrapping or to periodically poll the server in order to determine if there are updated packages available for it. To get the /pal PC, the client and server need to mutually authenticate each other with TLS and authorize each other. Clients retrieve their PAL and processes it to determine the packages available for it. Clients include the HTTP Accept header [RFC2616] to indicate whether they support XML or JSON. | | Client | Establish TLS | Server | Session | |<-------------------->| | | | Request PAL | | (HTTP GET Request) | |--------------------->| |<---------------------| | Deliver PAL | | (HTTP GET Response) | | | | Request package by | | specified URI | | (HTTP GET or POST | | Request) | |--------------------->| Turner Expires July 26, 2017 [Page 9] Internet-Draft EST Extensions January 22, 2017 |<---------------------| | Deliver requested | | CMS package product | | (HTTP GET or POST | | Response) | | | repeat as necessary Figure 1 - /pal Message Sequence The client MUST authenticate the server as specified in [RFC7030] and the client MUST verify server's authorization as specified in [RFC7030]. The server MUST authenticate the client as specified in [RFC7030] and the server MUST verify client authorization as specified in [RFC7030]. PAL support is OPTIONAL. It is shown in figures throughout this document but clients need not support the PAL to access services offered by the server. 2.1. PAL Format Each PAL is composed of zero (i.e., minOccurs=0) or more entries (an array in JSON), each of which is composed of the following four elements all of which MUST be present (i.e., minOccurs=1): o The <type> element uniquely identifies each package that a client may retrieve from the server with a 4-digit field (a number in JSON). The PAL Package Types are defined in Section 2.1.1. o The <date> element is a 20-character field (a string in JSON) that contains either: * The date and time (expressed as Generalized Time: YYYY-MM- DDTHH:MM:SSZ) that the client last successfully downloaded the identified package from the server, or * 0001-01-01T00:00:00Z (i.e., 0), if: - There is no indication the client has successfully downloaded the identified package, or - The PAL entry corresponds to a pointer to the next PAL or the server is requesting a package from the client (e.g., certification request, receipt, error). Turner Expires July 26, 2017 [Page 10] Internet-Draft EST Extensions January 22, 2017 o The <size> element indicates the size in bytes of the package (a number in JSON). A package size of zero (i.e., "0" without the quotes) indicates that the client needs to begin a transaction or return an error or receipt. o The <info> element provides either an SKI (Subject Key Identifier), DN (Distinguished Name), Issuer and Serial Number tuple or a URI (a string in JSON). When a URI [RFC3986] is included it indicates the location where the identified package can be retrieved. When a DN, SKI, or Issuer Name and Serial Number tuple is included it points to a certificate that is the subject of the notification (i.e., the certificate to be rekeyed/renewed). Clients are often limited by the size of objects they can consume, the PAL is not immune to these limitations. As opposed to picking a limit for all clients, a special package type is defined, see Section 2.1.1, to indicate that another PAL is available. Servers can use this value to limit the size of the PALs provided to clients. When the <date> element is not zero (i.e., 0001-01-01T00:00:00Z) it MUST be represented in a form that matches the dateTime production in "canonical representation" [XMLSCHEMA]. Implementations SHOULD NOT rely on time resolution finer than seconds and MUST NOT generate time instants that specify leap seconds. 2.1.1. PAL Package Types Table 1 lists the PAL package types that are defined by this document: NOTE: DS is Digital Signature and KE is Key Establishment. Package Package Description Number -------- --------------------------------------------------- 0000: Reserved 0001: Additional PAL value present 0002: X.509 CA certificate 0003: X.509 EE certificate 0004: X.509 ARL 0005: X.509 CRL 0006: Start DS certificate enrollment with CSR attribute 0007: Start DS certificate enrollment 0008: DS certificate enrollment (success) 0009: DS certificate enrollment (failure) 0010: Start DS certificate re-enrollment 0011: DS certificate re-enrollment (success) Turner Expires July 26, 2017 [Page 11] Internet-Draft EST Extensions January 22, 2017 0012: DS certificate re-enrollment (failure) 0013: Start KE certificate enrollment with CSR attribute 0014: Start KE certificate enrollment 0015: KE certificate enrollment (success) 0016: KE certificate enrollment (failure) 0017: Start KE certificate re-enrollment 0018: KE certificate re-enrollment (success) 0019: KE certificate re-enrollment (failure) 0020: Asymmetric Key Package (PKCS#8) 0021: Asymmetric Key Package (CMS) 0022: Asymmetric Key Package (PKCS#12) 0023: Asymmetric Key Package Receipt or Error 0024: Symmetric Key Package 0025: Symmetric Key Package Receipt or Error 0026: Firmware Package 0027: Firmware Package Receipt or Error 0028: TAMP Status Query 0029: TAMP Status Query Response or Error 0030: Trust Anchor Update 0031: Trust Anchor Update Confirm or Error 0032: Apex Trust Anchor Update 0033: Apex Trust Anchor Update Confirm or Error 0034: Community Update 0035: Community Update Confirm or Error 0036: Sequence Number Adjust 0037: Sequence Number Adjust Confirm or Error Table 1 - PAL Package Types PAL package types are essentially hints about the type of package the client is about to retrieve or is asked to return. Savvy clients can parse the packages to determine what has been provided, but in some instances it is better to know before retrieving the package. The hint provided here does not obviate the need for clients to check the type of package provided before they store it possibly in specially allocated locations (i.e., some clients might store Root ARLs separately from intermediate CRLs). For packages provided by the client, the server is asking the client to provide an enrollment package, receipt, response, confirm or error. The PAL package types have the following meaning: NOTE: The semantics behind Codes 0002 and 0006-0021 are defined in [RFC7030]. 0000 Reserved: Reserved for future use. 0001 Additional PAL value present: Indicates that this PAL entry Turner Expires July 26, 2017 [Page 12] Internet-Draft EST Extensions January 22, 2017 refers to another PAL by referring to another /pal URI, which is defined in this section. This PAL package type limits the size of PALs to a more manageable size for clients. 0002 X.509 CA certificate: Indicates that one or more CA certificates [RFC5280] are available for the client by pointing to a /cacerts URI, which is defined in [RFC7030]. 0003 X.509 EE certificate: Indicates that one or more EE certificate [RFC5280] is available for the client by pointing to an /eecerts URI, which is defined in Section 3. 0004 X.509 ARL: Indicates that one or more ARL (Authority Revocation List) [RFC5280] is available for the client by pointing to a /crls URI, which is defined in Section 4. 0005 X.509 CRL: Indicates that one or more CRL (Certificate Revocation List) [RFC5280] is available for the client by pointing to a /crls URI, which is defined in Section 4. NOTE: See Section 9 for additional information about PAL and certificate enrollment interaction. See Appendix B for additional informative information. 0006 Start DS (Digital Signature) certificate enrollment with CSR: Indicates that the client begin enrolling their DS certificate (i.e., those certificates for which the key usage extension will have digital signature set) using a template provided by the server with a CSR (Certificate Signing Request) attribute (see Appendix B). The PAL entry points to a /csrattrs URI, which is defined in [RFC7030]. 0007 Start DS (Digital Signature) certificate enrollment: Indicates that the client begin enrolling their DS certificate. The PAL entry points to a /simpleenroll URI, which is defined in [RFC7030]. 0008 DS certificate enrollment (success): Indicates that the client retrieve a successful certification response. The PAL entry points to a /simpleenroll or a /fullcmc URI, which are both defined in [RFC7030]. 0009 DS certificate enrollment (failure): Indicates that the client retrieve a failed certification response for a DS certificate. This PAL entry points to a /simpleenroll or a /fullcmc URI. 0010 Start DS certificate re-enrollment: Indicates that the client rekey/renew a DS certificate. The PAL entry points to a Turner Expires July 26, 2017 [Page 13] Internet-Draft EST Extensions January 22, 2017 /simplereenroll or a /fullcmc URI. 0011 DS certificate re-enrollment (success): See PAL package type 0008. 0012 DS certificate re-enrollment (failure): See PAL package type 0009. NOTE: The KE (Key Establishment) responses that follow use the same URIs as DS certificates except in the requested certificates the key usage extension request will have only either key agreement or key transport set. 0013 Start KE certificate enrollment with CSR: See PAL package type 0006. 0014 Start KE certificate enrollment: See PAL package type 0007. 0015 KE certificate enrollment (success): See PAL package type 0008. 0016 KE certificate enrollment (failure): See PAL package type 0009. 0017 Start KE certificate re-enrollment: See PAL package type 0010. 0018 KE certificate re-enrollment (success): See PAL package type 0011. 0019 KE certificate re-enrollment (failure): See PAL package type 0012. NOTE: The variations on the asymmetric key packages is due to the number of CMS content types that can be used to protect the asymmetric key; the syntax for the asymmetric key is the same but additional ASN.1 is needed to include it in a signed data (i.e., the ASN.1 needs to be a CMS content type not the private key info type). See Section 8 of this document for additional information. 0020 Asymmetric Key Package (PKCS#8): Indicates that an asymmetric key generated by the server is available for the client; the package is an asymmetric key without additional encryption as specified in Section 4.4.2 of [RFC7030]. The PAL entry points to a /serverkeygen or a /fullcmc URI, which are defined in [RFC7030]. 0021 Asymmetric Key Package (CMS): See PAL package type 0020. The difference being that the package available is an asymmetric key package [RFC5958] that is signed and encapsulated in a signed data content type, as specified in Section 4.4.2 of Turner Expires July 26, 2017 [Page 14] Internet-Draft EST Extensions January 22, 2017 [RFC7030]. Also, see Section 8.1 of this document. 0022 Asymmetric Key Package (PKCS#12): See PAL package type 0020. The difference being that the package available is PKCS12 [RFC7292] content type. See Section 8.3 of this document. 0023 Asymmetric Key Package Receipt or Error: Indicates that the server wants the client to return a key package receipt or error [RFC7191] to the /serverkeygen/return URI, which is defined in Section 8. 0024 Symmetric Key Package: Indicates that a symmetric key package [RFC6031] is available for the client by pointing to a /symmetrickeys URI, which is defined in Section 5. 0025 Symmetric Key Package Receipt or Error: Indicates that the server wants the client to return a key package receipt or an error [RFC7191] to the /symmetrickeys/return URI, which is defined in Section 5. 0026 Firmware Package: Indicates that a firmware package [RFC4108] is available for the client using the /firmware URI, which is defined in Section 6. 0027 Firmware Package Receipt or Error: Indicates that the server wants the client to return a firmware package load receipt or error [RFC4108] to the /firmware/return URI, which is defined in Section 6. NOTE: The /tamp and tamp/return URIs are defined in Section 7. 0028 TAMP Status Query: Indicates that a TAMP Status Query package [RFC5934] is available for the client using the /tamp URI. 0029 TAMP Status Query Response or Error: Indicates that the server wants the client to return a TAMP Status Query Response or Error [RFC5934] to the /tamp/return URI. 0030 Trust Anchor Update: Indicates that a Trust Anchor Update package [RFC5934] is available for the client using the /tamp URI. 0031 Trust Anchor Update Confirm or Error: Indicates that the server wants the client to return a Trust Anchor Update Confirm or Error [RFC5934] to the /tamp/return URI. 0032 Apex Trust Anchor Update: Indicates that an Apex Trust Anchor Update package [RFC5934] is available for the client using the Turner Expires July 26, 2017 [Page 15] Internet-Draft EST Extensions January 22, 2017 /tamp URI. 0033 Apex Trust Anchor Update Confirm or Error: Indicates that the server wants the client to return an Apex Trust Anchor Update Confirm or Error [RFC5934] to the /tamp/return URI. 0034 Community Update: Indicates that a Community Update package [RFC5934] is available for the client using the /tamp URI. 0035 Community Update Confirm or Error: Indicates that the server wants the client to return a Community Update Confirm or Error [RFC5934] to the /tamp/return URI. 0036 Sequence Number Adjust: Indicates that a Sequence Number Adjust package [RFC5934] is available for the client using the /tamp URI. 0037 Sequence Number Adjust Confirm or Error: Indicates that the server wants the client to return a Sequence Number Adjust Confirm or Error [RFC5934] to the /tamp/return URI. 2.1.2. PAL XML Schema The name space is specified in Section 11.1. The fields in the schema were discussed earlier in Sections 2.1 and 2.1.1. <?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:pal="urn:ietf:params:xml:ns:pal" targetNamespace="urn:ietf:params:xml:ns:pal" elementFormDefault="qualified" attributeFormDefault="unqualified" version="1.0"> <xsd:annotation> <xsd:documentation> This schema defines the types and elements needed to retrieve client packages from the server or for the client to post packages to the server. </xsd:documentation> </xsd:annotation> <!-- ===== Element Declarations ===== --> <xsd:element name="pal" type="pal:PAL" /> &'s sequence of CSAs, as an integral part of the Babel speaker configuration, MAY be intended for a persistent storage as long as this conforms with the implementation's key management policy. The default state of an interface's sequence of CSAs is empty, which has a special meaning of no authentication configured for the interface. The sending (Section 5.3 item 1) and the receiving (Section 5.4 item 1) procedures address this convention accordingly. A single CSA structure consists of the following fields: o HashAlgo An implementation-specific reference to one of the hash algorithms supported by this implementation (see Section 2.1). o KeyChain A finite sequence of elements ("KeyChain sequence" hereafter) representing authentication keys, each element being a structure consisting of the following fields: * LocalKeyID An unsigned integer of an implementation-specific bit length. * AuthKeyOctets A sequence of octets of an arbitrary, known length to be used as the authentication key. * KeyStartAccept The time that this Babel speaker will begin considering this authentication key for accepting packets with authentication data. * KeyStartGenerate The time that this Babel speaker will begin considering this Ovsienko Expires October 20, 2014 [Page 15] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 authentication key for generating packet authentication data. * KeyStopGenerate The time that this Babel speaker will stop considering this authentication key for generating packet authentication data. * KeyStopAccept The time that this Babel speaker will stop considering this authentication key for accepting packets with authentication data. Since there is no limit imposed on the number of CSAs per interface, but the number of HMAC computations per sent/received packet is limited (through MaxDigestsOut and MaxDigestsIn respectively), only a fraction of the associated keys and hash algorithms may appear used in the process. The ordering of elements within a sequence of CSAs and within a KeyChain sequence is important to make the association selection process deterministic and transparent. Once this ordering is deterministic at the Babel interface level, the intermediate data derived by the procedure defined in Section 5.2 will be deterministically ordered as well. An implementation SHOULD allow an operator to set any arbitrary order of elements within a given interface's sequence of CSAs and within the KeyChain sequence of a given CSA. Regardless if this requirement is or isn't met, the implementation MUST provide a mean to discover the actual element order used. Whichever order is used by an implementation, it MUST be preserved across Babel speaker restarts. Note that none of the CSA structure fields is constrained to contain unique values. Section 6.4 explains this in more detail. It is possible for the KeyChain sequence to be empty, although this is not the intended manner of CSAs use. The KeyChain sequence has a direct prototype, which is the "key chain" syntax item of some existing router configuration languages. Whereas an implementation already implements this syntax item, it is suggested to reuse it, that is, to implement a CSA syntax item referring to a key chain item instead of reimplementing the latter in full. 3.9. Effective Security Associations An Effective Security Association (ESA) is a data structure immediately used in sending (Section 5.3) and receiving (Section 5.4) procedures. Its conceptual purpose is to determine a runtime Ovsienko Expires October 20, 2014 [Page 16] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 interface between those procedures and the deriving procedure defined in Section 5.2. All ESAs are temporary data units managed as elements of finite sequences that are not intended for a persistent storage. Element ordering within each such finite sequence ("sequence of ESAs" hereafter) MUST be preserved as long as the sequence exists. A single ESA structure consists of the following fields: o HashAlgo An implementation-specific reference to one of the hash algorithms supported by this implementation (see Section 2.1). o KeyID A 16-bit unsigned integer. o AuthKeyOctets A sequence of octets of an arbitrary, known length to be used as the authentication key. Note that among the protocol data structures introduced by this mechanism ESA is the only one not directly interfaced with the system operator (see Figure 1), it is not immediately present in the protocol encoding either. However, ESA is not just a possible implementation technique, but an integral part of this specification: the deriving (Section 5.2), the sending (Section 5.3), and the receiving (Section 5.4) procedures are defined in terms of the ESA structure and its semantics provided herein. ESA is as meaningful for a correct implementation as the other protocol data structures. 4. Updates to Protocol Encoding 4.1. Justification Choice of encoding is very important in the long term. The protocol encoding limits various authentication mechanism designs and encodings, which in turn limit future developments of the protocol. Considering existing implementations of Babel protocol instance itself and related modules of packet analysers, the current encoding of Babel allows for compact and robust decoders. At the same time, this encoding allows for future extensions of Babel by three (not excluding each other) principal means defined by Section 4.2 and Section 4.3 of [BABEL] and further discussed in Ovsienko Expires October 20, 2014 [Page 17] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 [I-D.chroboczek-babel-extension-mechanism]: a. A Babel packet consists of a four-octet header followed by a packet body, that is, a sequence of TLVs (see Figure 2). Besides the header and the body, an actual Babel datagram may have an arbitrary amount of trailing data between the end of the packet body and the end of the datagram. An instance of the original protocol silently ignores such trailing data. b. The packet body uses a binary format allowing for 256 TLV types and imposing no requirements on TLV ordering or number of TLVs of a given type in a packet. [BABEL] allocates TLV types 0 through 10 (see Table 1), defines TLV body structure for each and establishes the requirement for a Babel protocol instance to ignore any unknown TLV types silently. This makes it possible to examine a packet body (to validate the framing and/or to pick particular TLVs for further processing) considering only the type (to distinguish between a Pad1 TLV and any other TLV) and the length of each TLV, regardless if and how many additional TLV types are eventually deployed. c. Within each TLV of the packet body there may be some "extra data" after the "expected length" of the TLV body. An instance of the original protocol silently ignores any such extra data. Note that any TLV types without the expected length defined (such as PadN TLV) cannot be extended with the extra data. Considering each principal extension mean for the specific purpose of adding authentication data items to each protocol packet, the following arguments can be made: o Use of the TLV extra data of some existing TLV type would not be a solution, since no particular TLV type is guaranteed to be present in a Babel packet. o Use of the TLV extra data could also conflict with future developments of the protocol encoding. o Since the packet trailing data is currently unstructured, using it would involve defining an encoding structure and associated procedures, adding to the complexity of both specification and implementation and increasing the exposure to protocol attacks such as fuzzing. o A naive use of the packet trailing data would make it unavailable to any future extension of Babel. Since this mechanism is possibly not the last extension and since some other extensions may allow no other embedding means except the packet trailing Ovsienko Expires October 20, 2014 [Page 18] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 data, the defined encoding structure would have to enable multiplexing of data items belonging to different extensions. Such a definition is out of the scope of this work. o Deprecating an extension (or only its protocol encoding) that uses purely purpose-allocated TLVs is as simple as deprecating the TLVs. o Use of purpose-allocated TLVs is transparent for both the original protocol and any its future extensions, regardless of the embedding mean(s) used by the latter. Considering all of the above, this mechanism neither uses the packet trailing data nor uses the TLV extra data, but uses two new TLV types: type 11 for a TS/PC number and type 12 for an HMAC result (see Table 1). 4.2. TS/PC TLV The purpose of a TS/PC TLV is to store a single TS/PC number. There is exactly one TS/PC TLV in an authenticated Babel packet. 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type = 11 | Length | PacketCounter | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Timestamp | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Fields: Type Set to 11 to indicate a TS/PC TLV. Length The length in octets of the body, exclusive of the Type and Length fields. PacketCounter A 16-bit unsigned integer in network byte order, the PC part of a TS/PC number stored in this TLV. Timestamp A 32-bit unsigned integer in network byte order, the TS part of a TS/PC number stored in this TLV. Note that the ordering of PacketCounter and Timestamp in the TLV structure is opposite to the ordering of TS and PC in "TS/PC" term and the 48-bit equivalent (see Section 2.3). Considering the "expected length" and the "extra data" in the Ovsienko Expires October 20, 2014 [Page 19] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 definition of Section 4.3 of [BABEL], the expected length of a TS/PC TLV body is unambiguously defined as 6 octets. The receiving procedure correctly processes any TS/PC TLV with body length not less than the expected, ignoring any extra data (Section 5.4 items 3 and 9). The sending procedure produces a TS/PC TLV with body length equal to the expected and Length field set respectively (Section 5.3 item 3). Future Babel extensions (such as sub-TLVs) MAY modify the sending procedure to include the extra data after the fixed-size TS/PC TLV body defined herein, making necessary adjustments to Length TLV field, "Body length" packet header field and output buffer management explained in Section 6.2. 4.3. HMAC TLV The purpose of an HMAC TLV is to store a single HMAC result. To assist a receiver in reproducing the HMAC computation, LocalKeyID modulo 2^16 of the authentication key is also provided in the TLV. There is at least one HMAC TLV in an authenticated Babel packet. 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type = 12 | Length | KeyID | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Digest... +-+-+-+-+-+-+-+-+-+-+-+- Fields: Type Set to 12 to indicate an HMAC TLV. Length The length in octets of the body, exclusive of the Type and Length fields. KeyID A 16-bit unsigned integer in network byte order. Digest A variable-length sequence of octets, which is at least 16 octets long (see Section 2.2). Considering the "expected length" and the "extra data" in the definition of Section 4.3 of [BABEL], the expected length of an HMAC TLV body is not defined. The receiving and the padding procedures process every octet of the Digest field, deriving the field boundary from the Length field value (Section 5.4 item 7 and Section 2.2 respectively). The sending procedure produces HMAC TLVs with Length field precisely sizing the Digest field to match digest length of the Ovsienko Expires October 20, 2014 [Page 20] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 hash algorithm used (Section 5.3 items 5 and 8). The HMAC TLV structure defined herein is final, future Babel extensions MUST NOT extend it with any extra data. 5. Updates to Protocol Operation 5.1. Per-Interface TS/PC Number Updates The LocalTS and LocalPC interface-specific variables constitute the TS/PC number of a Babel interface. This number is advertised in the TS/PC TLV of authenticated Babel packets sent from that interface. There is only one property mandatory for the advertised TS/PC number: its 48-bit equivalent (see Section 2.3) MUST be strictly increasing within the scope of a given interface of a Babel speaker as long as the protocol instance is continuously operating. This property combined with ANM tables of neighbouring Babel speakers provides them with the most basic replay attack protection. Initialization and increment are two principal updates performed on an interface TS/PC number. The initialization is performed when a new interface becomes a part of a Babel protocol instance. The increment is performed by the sending procedure (Section 5.3 item 2) before advertising the TS/PC number in a TS/PC TLV. Depending on particular implementation method of these two updates the advertised TS/PC number may possess additional properties improving the replay attack protection strength. This includes, but is not limited to the methods below. a. The most straightforward implementation would use LocalTS as a plain wrap counter, defining the updates as follows: initialization Set LocalPC to 0, set LocalTS to 0. increment Increment LocalPC by 1. If LocalPC wraps (0xFFFF + 1 = 0x0000), increment LocalTS by 1. In this case the advertised TS/PC numbers would be reused after each Babel protocol instance restart, making neighbouring speakers reject authenticated packets until the respective ANM table entries expire or the new TS/PC number exceeds the old (see Section 3.6 and Section 3.7). b. A more advanced implementation could make a use of any 32-bit unsigned integer timestamp (number of time units since an arbitrary epoch) such as the UNIX timestamp, whereas the lt;!-- ===== Complex Data Element Type Definitions ===== --> <xsd:complexType name="PAL"> <xsd:annotation> Turner Expires July 26, 2017 [Page 16] Internet-Draft EST Extensions January 22, 2017 <xsd:documentation> This type defines the Package Availability List (PAL). </xsd:documentation> </xsd:annotation> <xsd:sequence> <xsd:element name="message" type="pal:PALEntry" minOccurs="0"> <xsd:annotation> <xsd:documentation> Contains information about the package and a link that the client uses to download or post the package. </xsd:documentation> </xsd:annotation> </xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="PALEntry"> <xsd:annotation> <xsd:documentation> This type defines a product in the PAL. </xsd:documentation> </xsd:annotation> <xsd:sequence> <xsd:element name="type" type="pal:PackageType" minOccurs="1" maxOccurs="1"> </xsd:element> <xsd:element name="date" type="pal:GeneralizedTimeType" minOccurs="1" maxOccurs="1"> </xsd:element> <xsd:element name="size" type="pal:PackageSizeType" minOccurs="1" maxOccurs="1"> </xsd:element> <xsd:element name="info" type="pal:PackageInfoType" minOccurs="1" maxOccurs="1"> </xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="PackageInfoType"> <xsd:annotation> <xsd:documentation> This type allows a choice of X.500 Distinguished Name, Subject Key Identifier, Issuer and Serial Number tuple, or URI. </xsd:documentation> </xsd:annotation> <xsd:choice> <xsd:element name="dn" type="pal:DistinguishedName" /> Turner Expires July 26, 2017 [Page 17] Internet-Draft EST Extensions January 22, 2017 <xsd:element name="ski" type="pal:SubjectKeyIdentifier" /> <xsd:element name="iasn" type="pal:IssuerAndSerialNumber" /> <xsd:element name="uri" type="pal:ThisURI" /> </xsd:choice> </xsd:complexType> <xsd:complexType name="IssuerAndSerialNumber"> <xsd:annotation> <xsd:documentation> This type holds the issuer Distinguished Name and serial number of a referenced certificate. </xsd:documentation> </xsd:annotation> <xsd:sequence> <xsd:element name="issuer" type="pal:DistinguishedName" /> <xsd:element name="serial" type="xsd:integer" /> </xsd:sequence> </xsd:complexType> <!-- =====Simple Data Element Type Definitions ===== --> <xsd:simpleType name="PackageType"> <xsd:annotation> <xsd:documentation> Identifies each package that a client may retrieve from the server with a 4-digit field. </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:string"> <xsd:maxLength value="4" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="GeneralizedTimeType"> <xsd:annotation> <xsd:documentation> Indicates the date and time (YYYY-MM-DDTHH:MM:SSZ) the client last acknowledged successful receipt of the package or 0001-01-01T00:00:00Z if there is no indication the package has been downloaded or the PAL entry corresponds to a pointer to the next PAL. </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:dateTime"> <xsd:pattern value= "((000[1-9])|(00[1-9][0-9])|(0[1-9][0-9]{2})| ([1-9][0-9]{3}))-((0[1-9])|(1[012]))-((0[1-9])| ([12][0-9])|(3[01]))T(([01][0-9])|(2[0-3])) Turner Expires July 26, 2017 [Page 18] Internet-Draft EST Extensions January 22, 2017 ((:[0-5][0-9])(:[0-5][0-9])Z" /> <xsd:minInclusive value="2013-05-23T00:00:00Z" /> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="PackageSizeType"> <xsd:annotation> <xsd:documentation> Indicates the package's size. </xsd:documentation> </xsd:annotation> <xsd:pattern value="[0-9]+" /> </xsd:simpleType> <xsd:simpleType name="DistinguishedName"> <xsd:annotation> <xsd:documentation> This type holds an X.500 Distinguished Name. </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:string" /> <xsd:maxLength value="1024" /> </xsd:simpleType> <xsd:simpleType name="SubjectKeyIdentifier"> <xsd:annotation> <xsd:documentation> This type holds a hex string representing the value of a certificate's SubjectKeyIdentifier. </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:hexBinary" /> <xsd:maxLength value="1024" /> </xsd:simpleType> <xsd:simpleType name="ThisURI"> <xsd:annotation> <xsd:documentation> This type holds a URI, but is length limited. </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:anyURI" /> <xsd:maxLength value="1024" /> </xsd:simpleType> </xsd:schema> 2.1.3. PAL JSON Object Turner Expires July 26, 2017 [Page 19] Internet-Draft EST Extensions January 22, 2017 The following is an example PAL JSON object. The fields in the object were discussed earlier in Sections 2.1 and 2.1.1. [ { "Type": 0003, "Date": "2016-12-29T09:28:00Z", "Size": 1234, "Info": "https://www.example.com/.well-known/est/eecerts/1234" } { "Type": 0003, "Date": "2016-12-29T09:28:00Z", "Size": 1234, "Info": "https://www.example.com/.well-known/est/eecerts/9876" } ] 2.2. Request PAL Clients request their PAL with an HTTP GET [RFC7231] using an operation path of "/pal". Clients indicate whether they would prefer XML or JSON by including the HTTP Accept header [RFC2616] with either "application/xml" or "application/json&Ovsienko Expires October 20, 2014 [Page 21] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 timestamp itself spans a reasonable time range and is guaranteed against a decrease (such as one resulting from network time use). The updates would be defined as follows: initialization Set LocalPC to 0, set LocalTS to 0. increment If the current timestamp is greater than LocalTS, set LocalTS to the current timestamp and LocalPC to 0, then consider the update complete. Otherwise increment LocalPC by 1 and, if LocalPC wraps, increment LocalTS by 1. In this case the advertised TS/PC number would remain unique across the speaker's deployed lifetime without the need for any persistent storage. However, a suitable timestamp source is not available in every implementation case. c. Another advanced implementation could use LocalTS in a way similar to the "wrap/boot counter" suggested in Section 4.1.1 of [OSPF3-AUTH], defining the updates as follows: initialization Set LocalPC to 0. If there is a TS value stored in NVRAM for the current interface, set LocalTS to the stored TS value, then increment the stored TS value by 1. Otherwise set LocalTS to 0 and set the stored TS value to 1. increment Increment LocalPC by 1. If LocalPC wraps, set LocalTS to the TS value stored in NVRAM for the current interface, then increment the stored TS value by 1. In this case the advertised TS/PC number would also remain unique across the speaker's deployed lifetime, relying on NVRAM for storing multiple TS numbers, one per interface. As long as the TS/PC number retains its mandatory property stated above, it is up to the implementor, which TS/PC number updates methods are available and if the operator can configure the method per-interface and/or at runtime. However, an implementation MUST disclose the essence of each update method it includes, in a comprehensible form such as natural language description, pseudocode, or source code. An implementation MUST allow the operator to discover, which update method is effective for any given interface, either at runtime or from the system documentation. These requirements are necessary to enable the optimal (see Section 3.7) management of ANM timeout in a network segment. Ovsienko Expires October 20, 2014 [Page 22] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 Note that wrapping (0xFFFFFFFF + 1 = 0x00000000) of LastTS is unlikely, but possible, causing the advertised TS/PC number to be reused. Resolving this situation requires replacing all authentication keys of the involved interface. In addition to that, if the wrap was caused by a timestamp reaching its end of epoch, using this mechanism will be impossible for the involved interface until some different timestamp or update implementation method is used. 5.2. Deriving ESAs from CSAs Neither receiving nor sending procedures work with the contents of interface's sequence of CSAs directly, both (Section 5.4 item 4 and Section 5.3 item 4 respectively) derive a sequence of ESAs from the sequence of CSAs and use the derived sequence (see Figure 1). There are two main goals achieved through this indirection: o Elimination of expired authentication keys and deduplication of security associations. This is done as early as possible to keep subsequent procedures focused on their respective tasks. o Maintenance of particular ordering within the derived sequence of ESAs. The ordering deterministically depends on the ordering within the interface's sequence of CSAs and the ordering within KeyChain sequence of each CSA. The particular correlation maintained by this procedure implements a concept of fair (independent of number of keys contained by each) competition between CSAs. The deriving procedure uses the following input arguments: o input sequence of CSAs o direction (sending or receiving) o current time (CT) The processing of input arguments begins with an empty output sequence of ESAs and consists of the following steps: 1. Make a temporary copy of the input sequence of CSAs. 2. Remove all expired authentication keys from each KeyChain sequence of the copy, that is, any keys such that: * for receiving: KeyStartAccept is greater than CT or KeyStopAccept is less than CT Ovsienko Expires October 20, 2014 [Page 23] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 * for sending: KeyStartGenerate is greater than CT or KeyStopGenerate is less than CT Note well that there are no special exceptions. Remove all expired keys, even if there are no keys left after that (see Section 7.4). 3. Use the copy to populate the output sequence of ESAs as follows: 1. When the KeyChain sequence of the first CSA contains at least one key, use its first key to produce an ESA with fields set as follows: HashAlgo Set to HashAlgo of the current CSA. KeyID Set to LocalKeyID modulo 2^16 of the current key of the current CSA. AuthKeyOctets Set to AuthKeyOctets of the current key of the current CSA. Append this ESA to the end of the output sequence. 2. When the KeyChain sequence of the second CSA contains at least one key, use its first key the same way and so forth until all first keys of the copy are processed. 3. When the KeyChain sequence of the first CSA contains at least two keys, use its second key the same way. 4. When the KeyChain sequence of the second CSA contains at least two keys, use its second key the same way and so forth until all second keys of the copy are processed. 5. And so forth until all keys of all CSAs of the copy are processed, exactly once each. In the description above the ordinals ("first", "second", and so on) with regard to keys stand for an element position after the removal of expired keys, not before. For example, if a KeyChain sequence was { Ka, Kb, Kc, Kd } before the removal and became { Ka, Kd } after, then Ka would be the "first" element and Kd would be the "second". 4. Deduplicate the ESAs in the output sequence, that is, wherever two or more ESAs exist that share the same (HashAlgo, KeyID, AuthKeyOctets) triplet value, remove all of these ESAs except the one closest to the beginning of the sequence. Ovsienko Expires October 20, 2014 [Page 24] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 The resulting sequence will contain zero or more unique ESAs, ordered in a way deterministically correlated with ordering of CSAs within the original input sequence of CSAs and ordering of keys within each KeyChain sequence. This ordering maximizes the probability of having equal amount of keys per original CSA in any N first elements of the resulting sequence. Possible optimizations of this deriving procedure are outlined in Section 6.3. 5.3. Updates to Packet Sending Perform the following authentication-specific processing after the instance of the original protocol considers an outgoing Babel packet ready for sending, but before the packet is actually sent (see Figure 1). After that send the packet regardless if the authentication-specific processing modified the outgoing packet or left it intact. 1. If the current outgoing interface's sequence of CSAs is empty, finish authentication-specific processing and consider the packet ready for sending. 2. Increment TS/PC number of the current outgoing interface as explained in Section 5.1. 3. Add to the packet body (see the note at the end of this section) a TS/PC TLV with fields set as follows: Type Set to 11. Length Set to 6. PacketCounter Set to the current value of LocalPC variable of the current outgoing interface. Timestamp Set to the current value of LocalTS variable of the current outgoing interface. Note that the current step may involve byte order conversion. 4. Derive a sequence of ESAs using procedure defined in Section 5.2 with the current interface's sequence of CSAs as the input sequence of CSAs, the current time as CT and "sending" as the direction. Proceed to the next step even if the derived sequence is empty. 5. Iterate over the derived sequence using its ordering. For each ESA add to the packet body (see the note at the end of this section) an HMAC TLV with fields set as follows: Ovsienko Expires October 20, 2014 [Page 25] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 Type Set to 12. Length Set to 2 plus digest length of HashAlgo of the current ESA. KeyID Set to KeyID of the current ESA. Digest Size exactly equal to the digest length of HashAlgo of the current ESA. Pad (see Section 2.2) using the source address of the current packet (see Section 6.1). As soon as there are MaxDigestsOut HMAC TLVs added to the current packet body, immediately proceed to the next step. Note that the current step may involve byte order conversion. 6. Increment the "Body length" field value of the current packet header by the total length of TS/PC and HMAC TLVs appended to the current packet body so far. Note that the current step may involve byte order conversion. 7. Make a temporary copy of the current packet. 8. Iterate over the derived sequence again, using the same order and number of elements. For each ESA (and respectively for each HMAC TLV recently appended to the current packet body) compute an HMAC result (see Section 2.4) using the temporary copy (not the original packet) as Text, HashAlgo of the current ESA as H, and AuthKeyOctets of the current ESA as K. Write the HMAC result to the Digest field of the current HMAC TLV (see Table 4) of the current packet (not the copy). 9. After this point, allow no more changes to the current packet header and body and consider it ready for sending. Note that even when the derived sequence of ESAs is empty, the packet is sent anyway with only a TS/PC TLV appended to its body. Although such a packet would not be authenticated, the presence of the sole TS/PC TLV would indicate authentication key exhaustion to operators of neighbouring Babel speakers. See also Section 7.4. Also note that it is possible to place the authentication-specific TLVs in the packet's sequence of TLVs in a number of different valid ways so long as there is exactly one TS/PC TLV in the sequence and the ordering of HMAC TLVs relative to each other, as produced in step 5 above, is preserved. Ovsienko Expires October 20, 2014 [Page 26] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 For example, see Figure 2. The diagrams represent a Babel packet without (D1) and with (D2, D3, D4) authentication-specific TLVs. The optional trailing data block that is present in D1 is preserved in D2, D3, and D4. Indexing (1, 2, ..., n) of the HMAC TLVs means the order in which the sending procedure produced them (and respectively the HMAC results). In D2 the added TLVs are appended: the previously existing TLVs are followed by the TS/PC TLV, which is followed by the HMAC TLVs. In D3 the added TLVs are prepended: the TS/PC TLV is the first and is followed by the HMAC TLVs, which are followed by the previously existing TLVs. In D4 the added TLVs are intermixed with the previously existing TLVs and the TS/PC TLV is placed after the HMAC TLVs. All three packets meet the requirements above. Implementors SHOULD use appending (D2) for adding the authentication- specific TLVs to the sequence, this is expected to result in more straightforward implementation and troubleshooting in most use cases. 5.4. Updates to Packet Receiving Perform the following authentication-specific processing after an incoming Babel packet is received from the local network stack, but before it is acted upon by the Babel protocol instance (see Figure 1). The final action conceptually depends not only upon the result of the authentication-specific processing, but also on the current value of RxAuthRequired parameter. Immediately after any processing step below accepts or refuses the packet, either deliver the packet to the instance of the original protocol (when the packet is accepted or RxAuthRequired is FALSE) or discard it (when the packet is refused and RxAuthRequired is TRUE). 1. If the current incoming interface's sequence of CSAs is empty, accept the packet. 2. If the current packet does not contain exactly one TS/PC TLV, refuse it. 3. Perform a lookup in the ANM table for an entry having Interface equal to the current incoming interface and Source equal to the source address of the current packet. If such an entry does not exist, immediately proceed to the next step. Otherwise, compare the entry's LastTS and LastPC field values with Timestamp and PacketCounter values respectively of the TS/PC TLV of the packet. That is, refuse the packet, if at least one of the following two conditions is true: * Timestamp is less than LastTS Ovsienko Expires October 20, 2014 [Page 27] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 * Timestamp is equal to LastTS and PacketCounter is not greater than LastPC Note that the current step may involve byte order conversion. 4. Derive a sequence of ESAs using procedure defined in Section 5.2 with the current interface's sequence of CSAs as the input sequence of CSAs, current time as CT and "receiving" as the direction. If the derived sequence is empty, refuse the packet. 5. Make a temporary copy of the current packet. 6. Pad (see Section 2.2) every HMAC TLV present in the temporary copy (not the original packet) using the source address of the original packet. 7. Iterate over all the HMAC TLVs of the original input packet (not the copy) using their order of appearance in the packet. For each HMAC TLV look up all ESAs in the derived sequence such that 2 plus digest length of HashAlgo of the ESA is equal to Length of the TLV and KeyID of the ESA is equal to value of KeyID of the TLV. Iterate over these ESAs in the relative order of their appearance on the full sequence of ESAs. Note that nesting the iterations the opposite way (over ESAs, then over HMAC TLVs) would be wrong. For each of these ESAs compute an HMAC result (see Section 2.4) using the temporary copy (not the original packet) as Text, HashAlgo of the current ESA as H, and AuthKeyOctets of the current ESA as K. If the current HMAC result exactly matches the contents of Digest field of the current HMAC TLV, immediately proceed to the next step. Otherwise, if the number of HMAC computations done for the current packet so far is equal to MaxDigestsIn, immediately proceed to the next step. Otherwise follow the normal order of iterations. Note that the current step may involve byte order conversion. 8. Refuse the input packet unless there was a matching HMAC result in the previous step. 9. Modify the ANM table, using the same index as for the entry lookup above, to contain an entry with LastTS set to the value of Timestamp and LastPC set to the value of PacketCounter fields of the TS/PC TLV of the current packet. That is, either add a new ANM table entry or update the existing one, depending on the result of the entry lookup above. Reset the entry's aging timer to the current value of ANM timeout. Ovsienko Expires October 20, 2014 [Page 28] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 Note that the current step may involve byte order conversion. 10. Accept the input packet. An implementation SHOULD before the authentication-specific processing above perform those basic procedures of the original protocol that don't take any protocol actions upon the contents of the packet but discard it unless the packet is sufficiently well- formed for further processing. Although exact composition of such procedures belongs to the scope of the original protocol, it seems reasonable to state that a packet SHOULD be discarded early, regardless if any authentication-specific processing is due, unless its source address conforms to Section 3.1 of [BABEL] and is not the receiving speaker's own address (see item (e) of Section 9). Note that RxAuthRequired affects only the final action, but not the defined flow of authentication-specific processing. The purpose of this is to preserve authentication-specific processing feedback (such as log messages and event counters updates) even with RxAuthRequired set to FALSE. This allows an operator to predict the effect of changing RxAuthRequired from FALSE to TRUE during a migration scenario (Section 7.3) implementation. 5.5. Authentication-Specific Statistics Maintenance A Babel speaker implementing this mechanism SHOULD maintain a set of counters for the following events, per protocol instance and per interface: a. Sending of an unauthenticated Babel packet through an interface having an empty sequence of CSAs (Section 5.3 item 1). b. Sending of an unauthenticated Babel packet with a TS/PC TLV but without any HMAC TLVs due to an empty derived sequence of ESAs (Section 5.3 item 4). c. Sending of an authenticated Babel packet containing both TS/PC and HMAC TLVs (Section 5.3 item 9). d. Accepting of a Babel packet received through an interface having an empty sequence of CSAs (Section 5.4 item 1). e. Refusing of a received Babel packet due to an empty derived sequence of ESAs (Section 5.4 item 4). f. Refusing of a received Babel packet that does not contain exactly one TS/PC TLV (Section 5.4 item 2). Ovsienko Expires October 20, 2014 [Page 29] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 g. Refusing of a received Babel packet due to the TS/PC TLV failing the ANM table check (Section 5.4 item 3). In the view of future extensions this event SHOULD leave out some small amount, per current (Interface, Source, LastTS, LastPC) tuple, of the packets refused due to Timestamp value being equal to LastTS and PacketCounter value being equal to LastPC. h. Refusing of a received Babel packet missing any HMAC TLVs (Section 5.4 item 8). i. Refusing of a received Babel packet due to none of the processed HMAC TLVs passing the ESA check (Section 5.4 item 8). j. Accepting of a received Babel packet having both TS/PC and HMAC TLVs (Section 5.4 item 10). k. Delivery of a refused packet to the instance of the original protocol due to RxAuthRequired parameter set to FALSE. Note that terms "accepting" and "refusing" are used in the sense of the receiving procedure, that is, "accepting" does not mean a packet delivered to the instance of the original protocol purely because the RxAuthRequired parameter is set to FALSE. Event counters readings SHOULD be available to the operator at runtime. 6. Implementation Notes 6.1. Source Address Selection for Sending Section 3.1 of [BABEL] allows for exchange of protocol datagrams using IPv4 or IPv6 or both. The source address of the datagram is a unicast (link-local in the case of IPv6) address. Within an address family used by a Babel speaker there may be more than one addresses eligible for the exchange and assigned to the same network interface. The original specification considers this case out of scope and leaves it up to the speaker's network stack to select one particular address as the datagram source address. But the sending procedure requires (Section 5.3 item 5) exact knowledge of packet source address for proper padding of HMAC TLVs. As long as a network interface has more than one addresses eligible for the exchange within the same address family, the Babel speaker SHOULD internally choose one of those addresses for Babel packet sending purposes and make this choice to both the sending procedure and the network stack (see Figure 1). Wherever this requirement cannot be met, this limitation MUST be clearly stated in the system documentation to allow an operator to plan network address management Ovsienko Expires October 20, 2014 [Page 30] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 accordingly. 6.2. Output Buffer Management An instance of the original protocol buffers produced TLVs until the buffer becomes full or a delay timer has expired. This is performed independently for each Babel interface with each buffer sized according to the interface MTU (see Sections 3.1 and 4 of [BABEL]). Since TS/PC and HMAC TLVs and any other TLVs, in the first place those of the original protocol, share the same packet space (see Figure 2) and respectively the same buffer space, a particular portion of each interface buffer needs to be reserved for 1 TS/PC TLV and up to MaxDigestsOut HMAC TLVs. The amount (R) of this reserved buffer space is calculated as follows: R = St + MaxDigestsOut * Sh = = 8 + MaxDigestsOut * (4 + Lmax) St Is the size of a TS/PC TLV. Sh Is the size of an HMAC TLV. Lmax Is the maximum digest length in octets possible for a particular interface. It SHOULD be calculated based on particular interface's sequence of CSAs, but MAY be taken as the maximum digest length supported by particular implementation. An implementation allowing for per-interface value of MaxDigestsOut or Lmax has to account for different value of R across different interfaces, even having the same MTU. An implementation allowing for runtime change of the value of R (due to MaxDigestsOut or Lmax) has to take care of the TLVs already buffered by the time of the change, especially when the value of R increases. The maximum safe value of MaxDigestsOut parameter depends on the interface MTU and maximum digest length used. In general, at least 200-300 octets of a Babel packet should be always available to data other than TS/PC and HMAC TLVs. An implementation following the requirements of Section 4 of [BABEL] would send packets sized 512 octets or larger. If, for example, the maximum digest length is 64 octets and MaxDigestsOut value is 4, the value of R would be 280, leaving less than a half of a 512-octet packet for any other TLVs. As long as the interface MTU is larger or digest length is smaller, higher values of MaxDigestsOut can be used safely. Ovsienko Expires October 20, 2014 [Page 31] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 6.3. Optimizations of ESAs Deriving The following optimizations of the ESAs deriving procedure can reduce amount of CPU time consumed by authentication-specific processing, preserving an implementation's effective behaviour. a. The most straightforward implementation would treat the deriving procedure as a per-packet action. But since the procedure is deterministic (its output depends on its input only), it is possible to significantly reduce the number of times the procedure is performed. The procedure would obviously return the same result for the same input arguments (sequence of CSAs, direction, CT) values. However, it is possible to predict when the result will remain the same even for a different input. That is, when the input sequence of CSAs and the direction both remain the same but CT changes, the result will remain the same as long as CT's order on the time axis (relative to all critical points of the sequence of CSAs) remains unchanged. Here, the critical points are KeyStartAccept and KeyStopAccept (for the "receiving" direction) and KeyStartGenerate and KeyStopGenerate (for the "sending" direction) of all keys of all CSAs of the input sequence. In other words, in this case the result will remain the same as long as both none of the active keys expire and none of the inactive keys enter into operation. An implementation optimized this way would perform the full deriving procedure for a given (interface, direction) pair only after an operator's change to the interface's sequence of CSAs or after reaching one of the critical points mentioned above. b. Considering that the sending procedure iterates over at most MaxDigestsOut elements of the derived sequence of ESAs (Section 5.3 item 5), there would be little sense in the case of "sending" direction in returning more than MaxDigestsOut ESAs in the derived sequence. Note that a similar optimization would be relatively difficult in the case of "receiving" direction, since the number of ESAs actually used in examining a particular received packet (not to be confused with the number of HMAC computations) depends on additional factors besides just MaxDigestsIn. 6.4. Security Associations Duplication This specification defines three data structures as finite sequences: a KeyChain sequence, an interface's sequence of CSAs, and a sequence of ESAs. There are associated semantics to take into account during Ovsienko Expires October 20, 2014 [Page 32] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 implementation, in that the same element can appear multiple times at different positions of the sequence. In particular, none of CSA structure fields (including HashAlgo, LocalKeyID, and AuthKeyOctets) alone or in a combination has to be unique within a given CSA, or within a given sequence of CSAs, or within all sequences of CSAs of a Babel speaker. In the CSA space defined this way, for any two authentication keys their one field (in)equality would not imply their another field (in)equality. In other words, it is acceptable to have more than one authentication key with the same LocalKeyID or the same AuthKeyOctets or both at a time. It is a conscious design decision that CSA semantics allow for duplication of security associations. Consequently, ESA semantics allow for duplication of intermediate ESAs in the sequence until the explicit deduplication (Section 5.2 item 4). One of the intentions of this is to define the security association management in a way that allows the addressing of some specifics of Babel as a mesh routing protocol. For example, a system operator configuring a Babel speaker to participate in more than one administrative domain could find each domain using its own authentication key (AuthKeyOctets) under the same LocalKeyID value, e.g., a "well-known" or "default" value like 0 or 1. Since reconfiguring the domains to use distinct LocalKeyID values isn't always feasible, the multi-domain Babel speaker using several distinct authentication keys under the same LocalKeyID would make a valid use case for such duplication. Furthermore, if in this situation the operator decided to migrate one of the domains to a different LocalKeyID value in a seamless way, respective Babel speakers would use the same authentication key (AuthKeyOctets) under two different LocalKeyID values for the time of the transition (see also item (f) of Section 9). This would make a similar use case. Another intention of this design decision is to decouple security association management from authentication key management as much as possible, so that the latter, be it manual keying or a key management protocol, could be designed and implemented independently (as respective reasoning made in Section 3.1 of [RIP2-AUTH] still applies). This way the additional key management constraints, if any, would remain out of scope of this authentication mechanism. A similar thinking justifies LocalKeyID field having bit length in ESA structure definition, but not in that of CSA. Ovsienko Expires October 20, 2014 [Page 33] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 7. Network Management Aspects 7.1. Backward Compatibility Support of this mechanism is optional, it does not change the default behaviour of a Babel speaker and causes no compatibility issues with speakers properly implementing the original Babel specification. Given two Babel speakers, one implementing this mechanism and configured for authenticated exchange (A) and another not implementing it (B), these would not distribute routing information uni-directionally or form a routing loop or experience other protocol logic issues specific purely to the use of this mechanism. The Babel design requires a bi-directional neighbour reachability condition between two given speakers for a successful exchange of routing information. Apparently, in the case above neighbour reachability would be uni-directional. Presence of TS/PC and HMAC TLVs in Babel packets sent by A would be transparent to B. But lack of authentication data in Babel packets send by B would make them effectively invisible to the instance of the original protocol of A. Uni-directional links are not specific to use of this mechanism, they naturally exist on their own and are properly detected and coped with by the original protocol (see Section 3.4.2 of [BABEL]). 7.2. Multi-Domain Authentication The receiving procedure treats a packet as authentic as soon as one of its HMAC TLVs passes the check against the derived sequence of ESAs. This allows for packet exchange authenticated with multiple (hash algorithm, authentication key) pairs simultaneously, in combinations as arbitrary as permitted by MaxDigestsIn and MaxDigestsOut. For example, consider three Babel speakers with one interface each, configured with the following CSAs: o speaker A: (hash algorithm H1; key SK1), (hash algorithm H1; key SK2) o speaker B: (hash algorithm H1; key SK1) o speaker C: (hash algorithm H1; key SK2) Packets sent by A would contain 2 HMAC TLVs each, packets sent by B and C would contain 1 HMAC TLV each. A and B would authenticate the exchange between themselves using H1 and SK1; A and C would use H1 and SK2; B and C would discard each other's packets. Ovsienko Expires October 20, 2014 [Page 34] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 Consider a similar set of speakers configured with different CSAs: o speaker D: (hash algorithm H2; key SK3), (hash algorithm H3; key SK4) o speaker E: (hash algorithm H2; key SK3), (hash algorithm H4, keys SK5 and SK6) o speaker F: (hash algorithm H3; keys SK4 and SK7), (hash algorithm H5, key SK8) Packets sent by D would contain 2 HMAC TLVs each, packets sent by E and F would contain 3 HMAC TLVs each. D and E would authenticate the exchange between themselves using H2 and SK3; D and F would use H3 and SK4; E and F would discard each other's packets. The simultaneous use of H4, SK5, and SK6 by E, as well as use of SK7, H5, and SK8 by F (for their own purposes) would remain insignificant to A. An operator implementing a multi-domain authentication should keep in mind that values of MaxDigestsIn and MaxDigestsOut may be different both within the same Babel speaker and across different speakers. Since the minimum value of both parameters is 2 (see Section 3.4 and Section 3.5), when more than 2 authentication domains are configured simultaneously it is advised to confirm that every involved speaker can handle sufficient number of HMAC results for both sending and receiving. The recommended method of Babel speaker configuration for multi- domain authentication is not only using a different authentication key for each domain, but also using a separate CSA for each domain, even when hash algorithms are the same. This allows for fair competition between CSAs and sometimes limits the consequences of a possible misconfiguration to the scope of one CSA. See also item (f) of Section 9. 7.3. Migration to and from Authenticated Exchange It is common in practice to consider a migration to authenticated exchange of routing information only after the network has already been deployed and put to an active use. Performing the migration in a way without regular traffic interruption is typically demanded, and this specification allows a smooth migration using the RxAuthRequired interface parameter defined in Section 3.1. This measure is similar to the "transition mode" suggested in Section 5 of [OSPF3-AUTH]. An operator performing the migration needs to arrange configuration changes as follows: Ovsienko Expires October 20, 2014 [Page 35] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 1. Decide on particular hash algorithm(s) and key(s) to be used. 2. Identify all speakers and their involved interfaces that need to be migrated to authenticated exchange. 3. For each of the speakers and the interfaces to be reconfigured first set RxAuthRequired parameter to FALSE, then configure necessary CSA(s). 4. Examine the speakers to confirm that Babel packets are successfully authenticated according to the configuration (supposedly, through examining ANM table entries and authentication-specific statistics, see Figure 1) and address any discrepancies before proceeding further. 5. For each of the speakers and the reconfigured interfaces set the RxAuthRequired parameter to TRUE. Likewise, temporarily setting RxAuthRequired to FALSE can be used to migrate smoothly from an authenticated packet exchange back to unauthenticated one. 7.4. Handling of Authentication Keys Exhaustion This specification employs a common concept of multiple authenticaion keys co-existing for a given interface, with two independent lifetime ranges associated with each key (one for sending and another for receiving). It is typically recommended to configure the keys using finite lifetimes, adding new keys before the old keys expire. However, it is obviously possible for all keys to expire for a given interface (for sending or receiving or both). Possible ways of addressing this situation raise their own concerns: o Automatic switching to unauthenticated protocol exchange. This behaviour invalidates the initial purposes of authentication and is commonly viewed as "unacceptable" ([RIP2-AUTH] Section 5.1, [OSPF2-AUTH] Section 3.2, [OSPF3-AUTH] Section 3, [OSPF3-AUTH-BIS] Section 3). o Stopping routing information exchange over the interface. This behaviour is likely to impact regular traffic routing and is commonly viewed as "not advisable" ([RIP2-AUTH], [OSPF2-AUTH], [OSPF3-AUTH]), although [OSPF3-AUTH-BIS] is different in this regard. o Use of the "most recently expired" key over its intended lifetime range. This behaviour is recommended for implementation in [RIP2-AUTH], [OSPF2-AUTH], [OSPF3-AUTH], but not in Ovsienko Expires October 20, 2014 [Page 36] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 [OSPF3-AUTH-BIS]. The use may become a problem due to an offline cryptographic attack (see item (f) of Section 9) or a compromise of the key. In addition, telling a recently expired key from a key never ever been in a use may be impossible after a router restart. Design of this mechanism prevents the automatic switching to unauthenticated exchange and is consistent with similar authentication mechanisms in this regard. But since the best choice between two other options depends on local site policy, this decision is left up to the operator rather than the implementor (in a way resembling the "fail secure" configuration knob described in Section 5.1 of [RIP2-AUTH]). Although the deriving procedure does not allow for any exceptions in expired keys filtering (Section 5.2 item 2), the operator can trivially enforce one of the two remaining behaviour options through local key management procedures. In particular, when using the key over its intended lifetime is more preferred than regular traffic disruption, the operator would explicitly leave the old key expiry time open until the new key is added to the router configuration. In the opposite case the operator would always configure the old key with a finite lifetime and bear associated risks. 8. Implementation Status [RFC Editor: before publication please remove this section and the reference to [RFC6982], along the offered experiment of which this section exists to assist document reviewers.] At the time of this writing the original Babel protocol is available in two free, production-quality implementations, both of which support IPv4 and IPv6 routing but exchange Babel packets using IPv6 only: o The "standalone" babeld, a BSD-licensed software with source code publicly available [1]. That implementation does not support this authentication mechanism. o The integrated babeld component of Quagga-RE, a work derived from Quagga routing protocol suite, a GPL-lisensed software with source code publicly available [2]. That implementation supports this authentication mechanism as defined in revision 09 of this document. It supports both Ovsienko Expires October 20, 2014 [Page 37] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 mandatory-to-implement hash algorithms (RIPEMD-160 and SHA-1) and a few additional algorithms (SHA-224, SHA-256, SHA-384, SHA-512 and Whirlpool). It does not support more than one link-local IPv6 address per interface. It does not distinguish refused replayed packets for purpose of logging in the sense of item (g) of Section 5.5 and does not check the packet source address before the authentication-specific processing as suggested in Section 5.4. It implements authentication-specific parameters, data structures and methods as follows (whether a parameter can be "changed at runtime", it is done by means of CLI and can also be set in a configuration file): * MaxDigestsIn value is fixed to 4. * MaxDigestsOut value is fixed to 4. * RxAuthRequired value is specific to each interface and can be changed at runtime. * ANM Table contents is not retained across speaker restarts, can be retrieved and reset (all entries at once) by means of CLI. * ANM Timeout value is specific to the whole protocol instance, has a default value of 300 seconds and can be changed at runtime. * Ordering of elements within each interface's sequence of CSAs is arbitrary as set by operator at runtime. CSAs are implemented to refer to existing key chain syntax items. Elements of an interface's sequence of CSAs are constrained to be unique reference-wise, but not contents-wise, that is, it is possible to duplicate security associations using a different key chain name to contain the same keys. * Ordering of elements within each KeyChain sequence is fixed to the sort order of LocalKeyID. LocalKeyID is constrained to be unique within each KeyChain sequence. * TS/PC number updates method can be configured at runtime for the whole protocol instance to one of two methods standing for items (a) and (b) of Section 5.1. The default method is (b). * Most of the authentication-specific statistics counters listed in Section 5.5 are implemented (per protocol instance and per each interface) and their readings are available by means of CLI with an option to log respective events into a file. No other implementations of this authentication mechanism are Ovsienko Expires October 20, 2014 [Page 38] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 known to exist, thus interoperability can only be assessed on paper. The only existing implementation has been tested to be fully compatible with itself regardless of a speaker CPU endianness. 9. Security Considerations Use of this mechanism implies requirements common to a use of shared authentication keys, including, but not limited to: o holding the keys secret, o including sufficient amounts of random bits into each key, o rekeying on a regular basis, and o never reusing a used key for a different purpose That said, proper design and implementation of a key management policy is out of scope of this work. Many publications on this subject exist and should be used for this purpose (BCP 107 [RFC4107], BCP 132 [RFC4962], and [RFC6039] may be suggested as starting points). It is possible for a network that exercises authentication keys rollover to experience accidental expiration of all the keys for a network interface as discussed at greater length in Section 7.4. With that and the guidance of Section 5.1 of [RIP2-AUTH] in mind, in such an event the Babel speaker MUST send a "last key expired" notification to the operator (e.g. via syslog, SNMP, and/or other implementation-specific means), most likely in relation to the item (b) of Section 5.5. Also, any actual occurrence of an authentication key expiration MUST cause a security event to be logged by the implementation. The log item MUST include at least a note that the authentication key has expired, the Babel routing protocol instance(s) affected, the network interface(s) affected, the LocalKeyID that is affected, and the current date/time. Operators are encouraged to check such logs as an operational security practice. Considering particular attacks being in-scope or out of scope on one hand and measures taken to protect against particular in-scope attacks on the other, the original Babel protocol and this authentication mechanism are in line with similar datagram-based routing protocols and their respective mechanisms. In particular, the primary concerns addressed are: Ovsienko Expires October 20, 2014 [Page 39] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 a. Peer Entity Authentication The Babel speaker authentication mechanism defined herein is believed to be as strong as is the class itself that it belongs to. This specification is built on fundamental concepts implemented for authentication of similar routing protocols: per- packet authentication, use of HMAC construct, use of shared keys. Although this design approach does not address all possible concerns, it is so far known to be sufficient for most practical cases. b. Data Integrity Meaningful parts of a Babel datagram are the contents of the Babel packet (in the definition of Section 4.2 of [BABEL]) and the source address of the datagram (Section 3.5.3 ibid.). This mechanism authenticates both parts using the HMAC construct, so that making any meaningful change to an authenticated packet after it has been emitted by the sender should be as hard as attacking the HMAC construct itself or successfully recovering the authentication key. Note well that any trailing data of the Babel datagram is not meaningful in the scope of the original specification and does not belong to the Babel packet. Integrity of the trailing data is respectively not protected by this mechanism. At the same time, although any TLV extra data is also not meaningful in the same scope, its integrity is protected, since this extra data is a part of the Babel packet (see Figure 2). c. Denial of Service Proper deployment of this mechanism in a Babel network significantly increases the efforts required for an attacker to feed arbitrary Babel PDUs into protocol exchange (with an intent of attacking a particular Babel speaker or disrupting exchange of regular traffic in a routing domain). It also protects the neighbour table from being flooded with forged speaker entries. At the same time, this protection comes with a price of CPU time being spent on HMAC computations. This may be a concern for low- performance CPUs combined with high-speed interfaces, as sometimes seen in embedded systems and hardware routers. The MaxDigestsIn parameter, which is used to limit the maximum amount of CPU time spent on a single received Babel packet, addresses this concern to some extent. Ovsienko Expires October 20, 2014 [Page 40] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 d. Reflection Attacks Given the approach discussed in item (b), the only potential reflection attack on this mechanism could be replaying exact copies of Babel packets back to the sender from the same source address. The mitigation in this case is straightforward and is discussed in Section 5.4. The following in-scope concern is only partially addressed: e. Replay Attacks This specification establishes a basic replay protection measure (see Section 3.6), defines a timeout parameter affecting its strength (see Section 3.7), and outlines implementation methods also affecting protection strength in several ways (see Section 5.1). The implementor's choice of the timeout value and particular implementation methods may be suboptimal due to, for example, insufficient hardware resources of the Babel speaker. Furthermore, it may be possible that an operator configures the timeout and the methods to address particular local specifics and this further weakens the protection. An operator concerned about replay attack protection strength should understand these factors and their meaning in a given network segment. That said, a particular form of replay attack on this mechanism remains possible anyway. Whether there are two or more network segments using the same CSA and there is an adversary that captures Babel packets on one segment and replays on another (and vice versa due to the bi-directional reachability requirement for neighbourship), some of the speakers on one such segment will detect the "virtual" neighbours from another and may prefer them for some destinations. This applies even more so as Babel doesn't require a common pre-configured network prefix between neighbours. A reliable solution to this particular problem, which Section 4.5 of [RFC7186] discusses as well, is not currently known. It is recommended that the operators use distinct CSAs for distinct network segments. The following in-scope concerns are not addressed: f. Offline Cryptographic Attacks This mechanism is obviously subject to offline cryptographic attacks. As soon as an attacker has obtained a copy of an authenticated Babel packet of interest (which gets easier to do Ovsienko Expires October 20, 2014 [Page 41] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 in wireless networks), he has got all the parameters of the authentication-specific processing performed by the sender, except authentication key(s) and choice of particular hash algorithm(s). Since digest lengths of common hash algorithms are well-known and can be matched with those seen in the packet, complexity of this attack is essentially that of the authentication key attack. Viewing the cryptographic strength of particular hash algorithms as a concern of its own, the main practical means of resisting offline cryptographic attacks on this mechanism are periodic rekeying and use of strong keys with a sufficient number of random bits. It is important to understand that in the case of multiple keys being used within single interface (for a multi-domain authentication or during a key rollover) the strength of the combined configuration would be that of the weakest key, since only one successful HMAC test is required for an authentic packet. Operators concerned about offline cryptographic attacks should enforce the same strength policy for all keys used for a given interface. Note that a special pathological case is possible with this mechanism. Whenever two or more authentication keys are configured for a given interface such that all keys share the same AuthKeyOctets and the same HashAlgo, but LocalKeyID modulo 2^16 is different for each key, these keys will not be treated as duplicate (Section 5.2 item 4), but an HMAC result computed for a given packet will be the same for each of these keys. In the case of sending procedure this can produce multiple HMAC TLVs with exactly the same value of the Digest field, but different values of KeyID field. In this case the attacker will see that the keys are the same, even without the knowledge of the key itself. Reuse of authentication keys is not the intended use case of this mechanism and should be strongly avoided. g. Non-repudiation This specification relies on a use of shared keys. There is no timestamp infrastructure and no key revocation mechanism defined to address a shared key compromise. Establishing the time that a particular authentic Babel packet was generated is thus not possible. Proving that a particular Babel speaker had actually sent a given authentic packet is also impossible as soon as the shared key is claimed compromised. Even with the shared key not being compromised, reliably identifying the speaker that had actually sent a given authentic Babel packet is not possible any Ovsienko Expires October 20, 2014 [Page 42] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 better than proving the speaker belongs to the group sharing the key (any of the speakers sharing a key can impose any other speaker sharing the same key). h. Confidentiality Violations The original Babel protocol does not encrypt any of the information contained in its packets. The contents of a Babel packet is trivial to decode, revealing network topology details. This mechanism does not improve this situation in any way. Since routing protocol messages are not the only kind of information subject to confidentiality concerns, a complete solution to this problem is likely to include measures based on the channel security model, such as IPSec and WPA2 at the time of this writing. i. Key Management Any authentication key exchange/distribution concerns are left out of scope. However, the internal representation of authentication keys (see Section 3.8) allows for diverse key management means, manual configuration in the first place. j. Message Deletion Any message deletion attacks are left out of scope. Since a datagram deleted by an attacker cannot be distinguished from a datagram naturally lost in transmission and since datagram-based routing protocols are designed to withstand a certain loss of packets, the currently established practice is treating authentication purely as a per-packet function without any added detection of lost packets. 10. IANA Considerations [RFC Editor: please do not remove this section.] At the time of this publication Babel TLV Types namespace did not have an IANA registry. TLV types 11 and 12 were assigned (see Table 1) to the TS/PC and HMAC TLV types by Juliusz Chroboczek, designer of the original Babel protocol. Therefore, this document has no IANA actions. 11. Acknowledgements Thanks to Randall Atkinson and Matthew Fanto for their comprehensive Ovsienko Expires October 20, 2014 [Page 43] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 work on [RIP2-AUTH] that initiated a series of publications on routing protocols authentication, including this one. This specification adopts many concepts belonging to the whole series. Thanks to Juliusz Chroboczek, Gabriel Kerneis, and Matthieu Boutier. This document incorporates many technical and editorial corrections based on their feedback. Thanks to all contributors to Babel, because this work would not be possible without the prior works. Thanks to Dominic Mulligan for editorial proofreading of this document. Thanks to Riku Hietamaki for suggesting the test vectors section. Thanks to Joel Halpern, Jim Schaad, Randall Atkinson, and Stephen Farrell for providing (in chronological order) valuable feedback on draft versions of this document. Thanks to Jim Gettys and Dave Taht for developing CeroWrt wireless router project and collaborating on many integration issues. A practical need for Babel authentication emerged during a research based on CeroWrt that eventually became the very first use case of this mechanism. Thanks to Kunihiro Ishiguro and Paul Jakma for establishing GNU Zebra and Quagga routing software projects respectively. Thanks to Werner Koch, the author of Libgcrypt. The very first implementation of this mechanism was made on base of Quagga and Libgcrypt. This document was produced using the xml2rfc ([RFC2629]) authoring tool. 12. References 12.1. Normative References [RFC2104] Krawczyk, H., Bellare, M., and R. Canetti, "HMAC: Keyed- Hashing for Message Authentication", RFC 2104, February 1997. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC4291] Hinden, R. and S. Deering, "IP Version 6 Addressing Architecture", RFC 4291, February 2006. [FIPS-198] US National Institute of Standards & Technology, "The Keyed-Hash Message Authentication Code (HMAC)", FIPS Ovsienko Expires October 20, 2014 [Page 44] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 PUB 198-1, July 2008. [BABEL] Chroboczek, J., "The Babel Routing Protocol", RFC 6126, April 2011. 12.2. Informative References [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, June 1999. [RFC3315] Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C., and M. Carney, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)", RFC 3315, July 2003. [RFC3931] Lau, J., Townsley, M., and I. Goyret, "Layer Two Tunneling Protocol - Version 3 (L2TPv3)", RFC 3931, March 2005. [RFC4030] Stapp, M. and T. Lemon, "The Authentication Suboption for the Dynamic Host Configuration Protocol (DHCP) Relay Agent Option", RFC 4030, March 2005. [RFC4107] Bellovin, S. and R. Housley, "Guidelines for Cryptographic Key Management", BCP 107, RFC 4107, June 2005. [RFC4270] Hoffman, P. and B. Schneier, "Attacks on Cryptographic Hashes in Internet Protocols", RFC 4270, November 2005. [RFC4302] Kent, S., "IP Authentication Header", RFC 4302, December 2005. [RIP2-AUTH] Atkinson, R. and M. Fanto, "RIPv2 Cryptographic Authentication", RFC 4822, February 2007. [RFC4962] Housley, R. and B. Aboba, "Guidance for Authentication, Authorization, and Accounting (AAA) Key Management", BCP 132, RFC 4962, July 2007. [RFC5176] Chiba, M., Dommety, G., Eklund, M., Mitton, D., and B. Aboba, "Dynamic Authorization Extensions to Remote Authentication Dial In User Service (RADIUS)", RFC 5176, January 2008. [ISIS-AUTH-A] Li, T. and R. Atkinson, "IS-IS Cryptographic Authentication", RFC 5304, October 2008. [ISIS-AUTH-B] Ovsienko Expires October 20, 2014 [Page 45] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 Bhatia, M., Manral, V., Li, T., Atkinson, R., White, R., and M. Fanto, "IS-IS Generic Cryptographic Authentication", RFC 5310, February 2009. [OSPF2-AUTH] Bhatia, M., Manral, V., Fanto, M., White, R., Barnes, M., Li, T., and R. Atkinson, "OSPFv2 HMAC-SHA Cryptographic Authentication", RFC 5709, October 2009. [RFC6039] Manral, V., Bhatia, M., Jaeggli, J., and R. White, "Issues with Existing Cryptographic Protection Methods for Routing Protocols", RFC 6039, October 2010. [RFC6151] Turner, S. and L. Chen, "Updated Security Considerations for the MD5 Message-Digest and the HMAC-MD5 Algorithms", RFC 6151, March 2011. [RFC6194] Polk, T., Chen, L., Turner, S., and P. Hoffman, "Security Considerations for the SHA-0 and SHA-1 Message-Digest Algorithms", RFC 6194, March 2011. [OSPF3-AUTH] Bhatia, M., Manral, V., and A. Lindem, "Supporting Authentication Trailer for OSPFv3", RFC 6506, February 2012. [RFC6709] Carpenter, B., Aboba, B., and S. Cheshire, "Design Considerations for Protocol Extensions", RFC 6709, September 2012. [RFC6982] Sheffer, Y. and A. Farrel, "Improving Awareness of Running Code: The Implementation Status Section", RFC 6982, July 2013. [I-D.chroboczek-babel-extension-mechanism] Chroboczek, J., "Extension Mechanism for the Babel Routing Protocol", draft-chroboczek-babel-extension-mechanism-00 (work in progress), June 2013. [OSPF3-AUTH-BIS] Bhatia, M., Manral, V., and A. Lindem, "Supporting Authentication Trailer for OSPFv3", RFC 7166, March 2014. [RFC7183] Herberg, U., Dearlove, C., and T. Clausen, "Integrity Protection for the Neighborhood Discovery Protocol (NHDP) and Optimized Link State Routing Protocol Version 2 (OLSRv2)", RFC 7183, April 2014. quot;, respectively. 2.3. Provide PAL If the server has a PAL for the client, the server response MUST contain an HTTP 200 response code with a content-type of "application/xml" [RFC7303] or "application/json" [RFC4627] and a Content-Transfer-Encoding of "base64". When the server constructs a PAL, an order of precedence for PAL offerings is based on the following rationale: o /cacerts and /crls packages are the most important because they support validation decisions on certificates used to sign and encrypt other listed PAL items. o /csrattrs are the next in importance, since they provide information that the server would like the client to include in its certificate enrollment request. o /simpleenroll, /simplereenroll, and /fullcmc packages items are next in importance, since they can impact a certificate used by the client to sign CMS content or a certificate to establish keys for encrypting content exchanged with the client. Turner Expires July 26, 2017 [Page 20] Internet-Draft EST Extensions January 22, 2017 * A client engaged in a certificate management SHOULD accept and process CA-provided transactions as soon as possible to avoid undue delays that might lead to protocol failure. o /symmetrickeys, /firmware, /tamp, and /eecerts packages containing keys and other types of products are last. Precedence SHOULD be given to packages that the client has not previously downloaded. The items listed in a PAL may not identify all of the packages available for a device. This can be for any of the following reasons: The server may temporarily withhold some outstanding PAL items to simplify client processing. If a CA has more than one certificate ready to begin a certificate management protocol with a client, the server will provide a notice for one at a time. Pending notices will be serviced in order of the earliest date when the certificate will be used. When rejecting a request the server specifies either an HTTP 4xx error, or an HTTP 5xx error. All other return codes are handled as specified in Section 4.2.3 of [RFC7030] (i.e., 202 handling and all other HTTP response codes). 3. Distribute EE Certificates Numerous mechanisms exist for clients to query repositories for certificates. The service provided by the /eecerts PC is different in that it is not a general purpose query for client certificates instead it allows the server to provide peer certificates to a client that the server knows through an out-of-band mechanism that the client will be communicating with. For example, a router being provisioned that connects to two peers can be provisioned with not only its certificate but also with the peers' certificates. The server need not authenticate or authorize the client for distributing an EE certificate because the package contents are already signed by a CA (i.e., the certificate(s) in a certs-only message are already signed by a CA). The message flow is similar to Figure 1 except that the connection need not be HTTPS: | | Client | Establish TLS | Server | Session | |<-------------------->| | | | Request PAL | Turner Expires July 26, 2017 [Page 21] Internet-Draft EST Extensions January 22, 2017 | (HTTP GET Request) | |--------------------->| |<---------------------| | Deliver PAL | | (HTTP GET Response) | | | | Request EE Cert(s) | | (HTTP GET Request) | |--------------------->| |<---------------------| | Deliver EE Cert(s) | | (HTTP GET Response) | | | Figure 2 - /eecerts Message Sequence 3.1. EE Certificate Request Clients request EE certificates with an HTTP GET [RFC7231] using an operation path of "/eecerts". 3.2. EE Certificate Response The response and processing of the returned error codes is identical to that in Section 4.1.3 of [RFC7030] except that the certificate provided is not the one issued to the client but is instead one of more client's peer certificates is returned in the certs-only message. Clients MUST reject EE certificates that do not validate to an authorized TA. 4. Distribute CRLs and ARLs CRLs (and ARLs) are needed in many instances to perform certificate path validation [RFC5280]. They can be obtained from repositories if their location is provided in the certificate. However, the client needs to parse the certificate and perform an additional round trip to retrieve them. Providing CRLs at the time of bootstrap would obviate the need for the client to parse certificate and aid those clients who might be unable to retrieve the CRL. Clients are free to obtain CRLs on which they rely from sources other than the server (e.g., a local directory). The /crls PC allows servers to distribute CRLs at the same time clients retrieve their certificate(s) and CA certificate(s) as well as peer certificates. The server need not authenticate or authorize the client for distributing a CRL because the package is already signed by a CA Turner Expires July 26, 2017 [Page 22] Internet-Draft EST Extensions January 22, 2017 (i.e., the CRLs in a crls-only message are already signed by a CA). The message flow is as depicted in Figure 2 but with "CRL(s)" instead of "EE Cert(s)". 4.1. CRL Request Clients request CRLs with an HTTP GET [RFC7231] using an operation path of "/crls". 4.2. CRL Response The response and processing of the response is identical to that in Section 4.1.3 of [RFC7030] except that instead of providing the issued certificate one of more CRLs are returned in the crls-only message. Clients MUST reject CRLs that do not validate to an authorized TA. 5. Symmetric Keys, Receipts, and Errors In addition to public keys, clients often need one or more symmetric keys to communicate with their peers. The /symmetrickeys PC allows the server to distribute symmetric keys to clients. Distribution of keys does not always work as planned and clients need a way to inform the server that something has gone wrong; they also need a way to inform the server, if asked, that the distribution process has successfully completed. The /symmetrickeys/return PC allows client to provide errors and receipts. Clients MUST authenticate the server and clients MUST check server's authorization. The server MUST authenticate clients and the server MUST check the client's authorization. HTTP GET [RFC7231] is used when the server provides the key to the client (see Section 5.1) using the /symmetrickeys PC; HTTP POST [RFC7231] is used when the client provides a receipt (see Section 5.2) or an error (see Section 5.2) to the server with the /symmetrickeys/return PC. 5.1. Symmetric Keys Servers use /symmetrickeys to provide clients symmetric keys; symmetric key package is defined in [RFC6031]. As with the /serverkeygen PC defined in [RFC7030], the default Turner Expires July 26, 2017 [Page 23] Internet-Draft EST Extensions January 22, 2017 distribution method of the symmetric key uses the encryption mode of the negotiated TLS cipher suite. Keys are not protected by preferred key wrapping methods such as AES Key Wrap [RFC3394] or AES Key Wrap with Padding [RFC5649] because encryption of the symmetric key beyond that provided by TLS is OPTIONAL. Therefore, the cipher suite used to return the symmetric key MUST offer commensurate cryptographic strength with the symmetric key being delivered to the client. The cipher suite use MUST NOT have NULL encryption algorithm as this will disclose the unprotected symmetric key. It is strongly RECOMMENDED that servers always return encrypted symmetric keys. The following depicts the protocol flow: | | Client | Establish TLS | Server | Session | |<-------------------->| | | | Request PAL | | (HTTP GET Request) | |--------------------->| |<---------------------| | Deliver PAL | | (HTTP GET Response) | | | | Req Symmetric Key | | (HTTP GET Request) | |--------------------->| |<---------------------| | Res Symmetric Key | | (HTTP GET Response) | | | Figure 3 - /symmetrickeys Message Sequence 5.1.1. Distribute Symmetric Keys Clients request the symmetric key from the server with an HTTP GET [RFC7231] using an operation path of "/symmetrickeys". 5.1.2. Symmetric Key Response If the request is successful, the server response MUST have an HTTP 200 response code with a Content-Type of application/cms [RFC7193] and a Content-Transfer-Encoding of "base64". The optional application/cms encapsulatingContent and innerContent parameters SHOULD be included with the Content-Type to indicate the protection afforded to the returned symmetric key. The returned content varies: Turner Expires July 26, 2017 [Page 24] Internet-Draft EST Extensions January 22, 2017 o If additional encryption is not being employed, the content associated with application/cms is a DER-encoded [X.690] symmetric key package. o If additional encryption is employed, the content associated with application/cms is DER-encoded enveloped data that encapsulates a signed data that further encapsulates a symmetric key package. o If additional encryption and origin authentication is employed, the content associated with application/cms is a DER-encoded signed data that encapsulates an enveloped data that encapsulates a signed data that further encapsulates a symmetric key package. o If CCC (CMS Content Constraints) [RFC6010] is supported the content associated with application/cms is a DER-encoded encrypted key package [RFC6032]. Encrypted key package provides three choices to encapsulate keys: encrypted data, enveloped data, and authenticated enveloped data. Prior to employing one of these three encryption choices the key package can be encapsulated in a signed data. How the server knows whether the client supports the encrypted key package is beyond the scope of this document. When rejecting a request, the server specifies either an HTTP 4xx error, or an HTTP 5xx error. If a symmetric key package (which might be signed) or an encrypted key package (which might be signed before and after encryption) is digitally signed, the client MUST reject it if the digital signature does not validate back to an authorized TA. [RFC3370], [RFC5753], [RFC5754], [RFC6033], [RFC6160], and [RFC6161] provide algorithm details for use when protecting the symmetric key package and encrypted key package. 5.2. Symmetric Key Receipts and Errors Clients use /symmetrickeys/return to provide symmetric key package receipts; the key package receipt content type is defined in [RFC7191]. Clients can be configured to automatically return receipts after processing a symmetric key package, return receipts based on processing of the key-package-identifier-and-receipt-request attribute [RFC7191], or return receipts when prompted by a PAL entry. Servers can indicate that clients return a receipt by including the key-package-identifier-and-receipt-request attribute in a signed data as a signed attribute. However, this attribute only appears when Turner Expires July 26, 2017 [Page 25] Internet-Draft EST Extensions January 22, 2017 additional encryption is employed (see Section 5.1.2). Clients also use /symmetrickeys/return to return symmetric key package errors; the key package error content type is defined in [RFC7191]. Clients can be configured to automatically return errors after processing a symmetric key package or based on a PAL entry. The following depicts the protocol flow: | | Client | Establish TLS | Server | Session | |<-------------------->| | | | Request PAL | | (HTTP GET Request) | |--------------------->| |<---------------------| | Deliver PAL | | (HTTP GET Response) | | | | Return Receipt/Error | | (HTTP POST Request) | |--------------------->| |<---------------------| | (HTTP POST Response) | | status code only | | no content | | | Figure 4 - /symmetrickeys/return Message Sequence 5.2.1. Provide Symmetric Key Receipt or Error Clients return symmetric key receipts and errors to the server with an HTTP POST [RFC7231] using an operation path of "/symmetrickeys/return" and a Content-Transfer-Encoding of "base64". The returned content varies: o The key package receipt is digitally signed [RFC7191], the Content-Type is application/cms [RFC7193] and the associated content is signed data, which encapsulates a key package receipt. o If the key package error is not digitally signed, the Content- Type is application/cms and the associated content is key package error. If the key package error is digitally signed, the Content-Type is application/cms and the associated content is signed data, which encapsulates a key package error. Turner Expires July 26, 2017 [Page 26] Internet-Draft EST Extensions January 22, 2017 The optional application/cms encapsulatingContent and innerContent parameters SHOULD be included with the Content-Type to indicate the protection afforded to the receipt or error. [RFC3370], [RFC5753], [RFC5754], and [RFC7192] provide algorithm details for use when protecting the key package receipt or key package error. 5.2.2. Symmetric Key Receipt or Error Response If the client successfully provides a receipt or error, the server response has an HTTP 200 response code with no content. When rejecting a request, the server specifies either an HTTP 4xx error, or an HTTP 5xx error. If a key package receipt or key package error is digitally signed, the server MUST reject it if the digital signature does not validate back to an authorized TA. 6. Firmware, Receipts, and Errors Servers can distribute object code for cryptographic algorithms and software with the firmware package [RFC4108]. Clients MUST authenticate the server and clients MUST check server's authorization. Server MUST authenticate the client and the server MUST check the client's authorization. The /firmware PC uses an HTTP GET [RFC7231] and the /firmware/return PC uses an HTTP POST [RFC7231]. GET is used when the client retrieves firmware from the server (see Section 6.1); POST is used when the client provides a receipt (see Section 6.2) or an error (see Section 6.2). 6.1. Firmware The /firmware URI is used by servers to provide firmware packages to clients. The message flow is as depicted in Figure 3 modulo replacing "Symmetric Key" with "Firmware Package". 6.1.1. Distribute Firmware Clients request firmware from the server with an HTTP GET [RFC7231] Turner Expires July 26, 2017 [Page 27] Internet-Draft EST Extensions January 22, 2017 using an operation path of "/firmware". 6.1.2. Firmware Response If the request is successful, the server response MUST have an HTTP 200 response code with a Content-Type of "application/cms" [RFC7193] and a Content-Transfer-Encoding of "base64". The optional encapsulatingContent and innerContent parameters SHOULD be included with Content-Type to indicate the protection afforded to the returned firmware. The returned content varies: o If the firmware is unprotected, then the Content-Type is application/cms and the content is the DER-encoded [X.690] firmware package. o If the firmware is compressed, then the Content-Type is application/cms and the content is the DER-encoded [X.690] compressed data that encapsulates the firmware package. o If the firmware is encrypted, then the Content-Type is application/cms and the content is the DER-encoded [X.690] encrypted data that encapsulates the firmware package (which might be compressed prior to encryption). o If the firmware is signed, then the Content-Type is application/cms and the content is the DER-encoded [X.690] signed data that encapsulates the firmware package (which might be compressed, encrypted, or compressed and then encrypted prior to signature). How the server knows whether the client supports the unprotected, signed, compressed and/or encrypted firmware package is beyond the scope of this document When rejecting a request, the server specifies either an HTTP 4xx error, or an HTTP 5xx error. If a firmware package is digitally signed, the client MUST reject it if the digital signature does not validate back to an authorized TA. [RFC3370], [RFC5753], and [RFC5754] provide algorithm details for use when protecting the firmware package. 6.2. Firmware Receipts and Errors Clients use the /firmware/return PC to provide firmware package load receipts and errors [RFC4108]. Clients can be configured to automatically return receipts and errors after processing a firmware Turner Expires July 26, 2017 [Page 28] Internet-Draft EST Extensions January 22, 2017 package or based on a PAL entry. The message flow is as depicted in Figure 4 modulo the receipt or error is for a firmware package. 6.2.1. Provide Firmware Receipt or Error Clients return firmware receipts and errors to the server with an HTTP POST [RFC7231] using an operation path of "/firmware/return" and a Content-Transfer-Encoding of "base64". The optional encapsulatingContent and innerContent parameters SHOULD be included with Content-Type to indicate the protection afforded to the returned firmware receipt or error. The returned content varies: o If the firmware receipt is not digitally signed, the Content-Type is application/cms [RFC7193] and the content is the DER-encoded firmware receipt. o If the firmware receipt is digitally signed, the Content-Type is application/cms and the content is the DER-encoded signed data encapsulating the firmware receipt. o If the firmware error is not digitally signed, the Content-Type is application/cms and the content is the DER-encoded firmware error. o If the firmware error is digitally signed, the Content-Type is application/cms and the content is the DER-encoded signed data encapsulating the firmware error. [RFC3370], [RFC5753], and [RFC5754] provide algorithm details for use when protecting the firmware receipt or firmware error. 6.2.2. Firmware Receipt or Error Response If the request is successful, the server response MUST have an HTTP 200 response code with no content. When rejecting a request, the server MUST specify either an HTTP 4xx error, or an HTTP 5xx error. If a firmware receipt or firmware error is digitally signed, the server MUST reject it if the digital signature does not validate back to an authorized TA. 7. Trust Anchor Management Protocol Servers distribute TAMP packages to manage TAs in a client's trust Turner Expires July 26, 2017 [Page 29] Internet-Draft EST Extensions January 22, 2017 anchor databases; TAMP packages are defined in [RFC5934]. TAMP will allow the flexibility for a device to load authorities while maintaining an operational state. Unlike other systems that require new software loads when new PKI Roots are authorized for use, TAMP allows for automated management of roots for provisioning or replacement as needed. Clients MUST authenticate the server and clients MUST check server's authorization. Server MUST authenticate the client and the server MUST check the client's authorization. The /tamp PC uses an HTTP GET [RFC7231] and the tamp/return PC uses an HTTP POST [RFC7231]. GET is used when the server requests that the client retrieve a TAMP package (see Section 7.1); POST is used when the client provides a confirm (see Section 7.2), provides a response (see Section 7.2), or provides an error (see Section 7.2) for the TAMP package. 7.1. TAMP Status Query, Trust Anchor Update, Apex Trust Anchor Update, Community Update, and Sequence Number Adjust Clients use the /tamp PC to retrieve the TAMP packages: TAMP Status Query, Trust Anchor Update, Apex Trust Anchor Update, Community Update, and Sequence Number Adjust. Clients can be configured to periodically poll the server for these packages or contact the server based on a PAL entry. The message flow is as depicted in Figure 3 modulo replacing "Symmetric Key" with the appropriate TAMP message. 7.1.1. Request TAMP Packages Clients request the TAMP packages from the server with an HTTP GET [RFC7231] using an operation path of "/tamp". 7.1.2. Return TAMP Packages If the request is successful, the server response MUST have an HTTP 200 response code with Content-Transfer-Encoding of "base64" and a Content-Type of: o application/tamp-status-query for TAMP Status Query o application/tamp-update for Trust Anchor Update o application/tamp-apex-update for Apex Trust Anchor Update o application/tamp-community-update for Community Update o application/tamp-sequence-adjust for Sequence Number Adjust Turner Expires July 26, 2017 [Page 30] Internet-Draft EST Extensions January 22, 2017 As specified in [RFC5934], these content types are digitally signed and clients must support validating the packages directly signed by TAs. For this specification, client MUST support validation with a certificate and clients MUST reject it if the digital signature does not validate back to an authorized TA. [RFC3370], [RFC5753], and [RFC5754] provide algorithm details for use when protecting the TAMP packages. 7.2. TAMP Response, Confirm, and Errors Clients return the TAMP Status Query Response, Trust Anchor Update Confirm, Apex Trust Anchor Update Confirm, Community Update Confirm, Sequence Number Adjust Confirm, and TAMP Error to servers using the /tamp/return PC. Clients can be configured to automatically return responses, confirms, and errors after processing a TAMP package or based on a PAL entry. The message flow is as depicted in Figure 4 modulo replacing "Receipt/Error" with the appropriate TAMP response, confirm, or error. 7.2.1. Provide TAMP Response, Confirm, or Error Clients provide the TAMP responses, confirms, and errors to the server with an HTTP POST using an operation path of "/tamp/return". The Content-Transfer-Encoding is "base64" and the Content-Type is: o application/tamp-status-query-response for TAMP Status Query Response o application/tamp-update-confirm for Trust Anchor Update Confirm o application/tamp-apex-update-confirm for Apex Trust Anchor Update Confirm o application/tamp-community-update-confirm for Community Update Confirm o application/tamp-sequence-adjust-confirm for Sequence Number Adjust Confirm o application/tamp-error for TAMP Error As specified in [RFC5934], these content types should be signed. If signed, a signed data encapsulates the TAMP content. [RFC3370], [RFC5753], and [RFC5754] provide algorithm details for use when protecting the TAMP packages. 7.2.2. TAMP Response, Confirm, and Error Response If the request is successful, the server response MUST have an HTTP Turner Expires July 26, 2017 [Page 31] Internet-Draft EST Extensions January 22, 2017 200 response code with no content. When rejecting a request, the server MUST specify either an HTTP 4xx error, or an HTTP 5xx error. If the package is digitally signed, the server MUST reject it if digital signature does not validate back to an authorized TA. 8. Asymmetric Keys, Receipts, and Errors [RFC7030] defines the /serverkeygen PC to support server-side generation of asymmetric keys. Keys are returned either as an unprotected PKCS#8 when additional security beyond TLS is not employed or as a CMS asymmetric key package content type that is encapsulated in a signed data content type that is further encapsulated in an enveloped data content type when additional security beyond TLS is requested. Some implementations prefer the use of other CMS content types to encapsulate the asymmetric key package; this document extends the content types that can be returned in Section 8.1. [RFC7191] defines content types for key package receipts and errors. This document defines the /serverkeygen/return PC to add support for returning receipts and errors for asymmetric key packages in Section 8.2. PKCS#12 [RFC7292], sometimes referred to as "PFX" (Personal inFormation eXchange), "P12", and "PKCS#12" files, are often used to distribute asymmetric private keys and the associated certificate. This document extends the /serverkeygen PC to allow servers to distribute using PKCS#12 server-generated asymmetric private keys and the associated certificate to clients in Section 8.3. 8.1. Asymmetric Key Encapsulation CMS supports a number of content types to encapsulate other CMS content types; [RFC7030] includes one such possibility; note that when only relying on TLS the returned key is not a CMS content type. This document extends the CMS content types that can be returned. If the client supports CCC [RFC6010], then the client can indicate that it supports encapsulated asymmetric keys in the encrypted key package [RFC5958] by including the encrypted key package's OID in a content type attribute [RFC2985] in the CSR (Certificate Signing Request), aka the certification request, it provides to the server. If the server knows a prior that the client supports the encrypted key package content type, then the client need not include the content type attribute in the CSR. Turner Expires July 26, 2017 [Page 32] Internet-Draft EST Extensions January 22, 2017 In all instances defined herein, the Content-Type is "application/cms" [RFC7193] the Content-Transfer-Encoding is "base64". The optional encapsulatingContent and innerContent parameters SHOULD be included with Content-Type to indicate the protection afforded to the returned asymmetric key package. If additional encryption and origin authentication is employed, the content associated with application/cms is a DER-encoded signed data that encapsulates an enveloped data that encapsulates a signed data that further encapsulates an asymmetric key package. If CCC (CMS Content Constraints) is supported and additional encryption is employed, the content associated with application/cms is a DER-encoded encrypted key package [RFC6032] content type that encapsulates a signed data that further encapsulates an asymmetric key package. If CCC is supported and additional encryption and additional origin authentication is employed, the content associated with application/cms is a DER-encoded signed data that encapsulates an encrypted key package content type that encapsulates a signed data that further encapsulates an asymmetric key package. Encrypted key package [RFC6032] provides three choices to encapsulate keys, encrypted data, enveloped data, and authenticated data, with enveloped data being the mandatory to implement choice. When rejecting a request, the server specifies either an HTTP 4xx error, or an HTTP 5xx error. If a asymmetric key package or an encrypted key package is digitally signed, the client MUST reject it if the digital signature does not validate back to an authorized TA. [RFC3370], [RFC5753], [RFC5754], [RFC6033], [RFC6161], and [RFC6162] provide algorithm details for use when protecting the asymmetric key package and encrypted key package. 8.2. Asymmetric Key Package Receipts and Errors Clients can be configured to automatically return receipts after processing an asymmetric key package, return receipts based on processing of the key-package-identifier-and-receipt-request attribute [RFC7191], or return receipts when prompted by a PAL entry. Servers can indicate that clients return a receipt by including the key-package-identifier-and-receipt-request attribute [RFC7191] in a signed data as a signed attribute. Turner Expires July 26, 2017 [Page 33] Internet-Draft EST Extensions January 22, 2017 The protocol flow is identical to that depicted in Figure 4 modulo the receipt or error is for asymmetric keys. The server and client processing is as described in Section 5.2.1 and 5.2.2 modulo the PC, which for Asymmetric Key Packages is "/serverkeygen/return". 8.3. PKCS#12 PFX is widely deployed and supports protecting keys in the same fashion as CMS but it does so differently. 8.3.1. Server-Side Key Generation Request Similar to the other server-generated asymmetric keys provided through the /serverkeygen PC: o The certificate request is HTTPS POSTed and is the same format as for the "/simpleenroll" and "/simplereenroll" path extensions with the same content-type and transfer encoding. o In all respects, the server SHOULD treat the CSR as it would any enroll or re-enroll CSR; the only distinction here is that the server MUST ignore the public key values and signature in the CSR. These are included in the request only to allow re-use of existing codebases for generating and parsing such requests. PBE (password based encryption) shrouding of PKCS#12 is supported and this specification makes no attempt to alter this defacto standard. As such, there is no support of the DecryptKeyIdentifier specified in [RFC7030] for use with PKCS#12 (i.e., "enveloping" is not supported). 8.3.2. Server-Side Key Generation Response If the request is successful, the server response MUST have an HTTP 200 response code with a content-type of "application/pkcs12" that consists of a base64-encoded DER-encoded [X.690] PFX [RFC7292] with a Content-Transfer-Encoding of "base64". Note that this response is different than the response returned in Section 4.4.2 of [RFC7030] because here the private key and the certificate are included in the same PFX. When rejecting a request, the server MUST specify either an HTTP 4xx error or an HTTP 5xx error. If the content-type is not set, the response data MUST be a plaintext human-readable error message. 9. PAL & Certificate Enrollment Turner Expires July 26, 2017 [Page 34] Internet-Draft EST Extensions January 22, 2017 The /fullcmc PC is defined in [RFC7030]; the CMC (Certificate Management over Cryptographic Message Syntax) requirements and packages are defined in [RFC5272], [RFC5273], [RFC5274], and [RFC6402]. This section describes PAL interactions. Under normal circumstances the client-server interactions for PKI enrollment are as follows: Client Server ---------------------> POST req: PKIRequest Content-Type: application/pkcs10 or POST req: PKIRequest Content-Type: application/pkcs7-mime smime-type=CMC-request <-------------------- POST res: PKIResponse Content-Type: application/pkcs7-mime smime-type=certs-only or POST res: PKIResponse Content-Type: application/pkcs7-mime smime-type=CMC-response if the response is rejected during the same session: Client Server ---------------------> POST req: PKIRequest Content-Type: application/pkcs10 or POST req: PKIRequest Content-Type: application/pkcs7-mime smime-type=CMC-request <-------------------- POST res: empty HTTPS Status Code or POST res: PKIResponse Content-Type: application/pkcs7-mime smime-type=CMC-response if the request is to be filled later: Client Server Turner Expires July 26, 2017 [Page 35] Internet-Draft EST Extensions January 22, 2017 ---------------------> POST req: PKIRequest Content-Type: application/pkcs10 or POST req: PKIRequest Content-Type: application/pkcs7-mime smime-type=CMC-request <-------------------- POST res: empty HTTPS Status Code + Retry-After or POST res: PKIResponse (pending) Content-Type: application/pkcs7-mime smime-type=CMC-response ---------------------> POST req: PKIRequest (same request) Content-Type: application/pkcs10 or POST req: PKIRequest (CMC Status Info only) Content-Type: application/pkcs7-mime smime-type=CMC-request <-------------------- POST res: PKIResponse Content-Type: application/pkcs7-mime smime-type=certs-only or POST res: PKIResponse Content-Type: application/pkcs7-mime smime-type=CMC-response With the PAL, the client begins after pulling the PAL and a Start Issuance PAL package type essentially adding the following before the request: Client Server ---------------------> GET req: PAL <-------------------- GET res: PAL Content-Type: application/xml The client then proceeds as above with a simple PKI Enroll, Full CMC Turner Expires July 26, 2017 [Page 36] Internet-Draft EST Extensions January 22, 2017 Enrollment, or begin enrollment assisted with a CSR: Client Server ---------------------> GET req: DS certificate with CSR <-------------------- GET res: PAL Content-Type: application/csr-attrs For immediately rejected request, CMC works well. If the server prematurely closes the connection, then the procedures in Section 8.2.4 of [RFC7231] apply. But, this might leave the client and server in a different state. The client could merely resubmit the request but another option, documented herein, is for the client to instead download the PAL to see if the server has processed the request. Clients might also use this process when they are unable to remain connected to the server for the entire enrollment process; if the server does not or is not able to return a PKIData indicating a status of pending, then the client will not know whether the request was received. If a client uses the PAL and reconnects to determine if the certification or rekey/renew request was processed: o Clients MUST authenticate the server and clients MUST check server's authorization. o Server MUST authenticate the client and the server MUST check the client's authorization. o Clients retrieve the PAL using the /pal URI. o Clients and servers use the operation path of "/simpleenroll", "simplereenroll", or "/fullcmc", based on the PAL entry, with an HTTP GET [RFC7231] to get the success or failure response. Responses are as specified in [RFC7030]. 10. Security Considerations This document relies on many other specifications. For HTTP, HTTPS, and TLS security considerations see [RFC7231], [RFC2818], and [RFC5246]; for URI security considerations see [RFC3986]; for content type security considerations see [RFC4073], [RFC4108], [RFC5272], [RFC5652], [RFC5751], [RFC5934], [RFC5958] [RFC6031], [RFC6032], [RFC6268], [RFC6402], [RFC7191], and [RFC7292]; for algorithms used to protect packages see [RFC3370], [RFC5649], [RFC5753], [RFC5754], [RFC5959], [RFC6033], [RFC6160], [RFC6161], [RFC6162] and [RFC7192]; for random numbers see [RFC4086]; for server-generated asymmetric key Turner Expires July 26, 2017 [Page 37] Internet-Draft EST Extensions January 22, 2017 pairs see [RFC7030]. 11. IANA Considerations IANA is requested to perform three registrations: PAL Name Space, PAL XML Schema, and PAL Package Types. 11.1. PAL Name Space This section registers a new XML namespace [XMLNS], "urn:ietf:params:xml:ns:TBD" per the guidelines in [RFC3688]: URI: urn:ietf:params:xml:ns:TBD Registrant Contact: Sean Turner (turners@ieca.com) XML: BEGIN <?xml version="1.0"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <title>Package Availability List</title> </head> <body> <h1>Namespace for Package Availability List</h1> <h2>urn:ietf:params:xml:ns:TBD</h2> <p>See RFC TBD</p> </body> </html> END 11.2. PAL Schema This section registers an XML schema as per the guidelines in [RFC3688]. URI: urn:ietf:params:xml:schema:pal Registrant Contact: Sean Turner sean@sn3rd.com XML: See Section 2.1.2. 11.3. PAL Package Types This section registers the PAL Package Types. Future PAL Package Types registrations are to be subject to Expert Review, as defined in RFC 5226 [RFC5226]. Package types MUST be paired with a media type. Turner Expires July 26, 2017 [Page 38] Internet-Draft EST Extensions January 22, 2017 The initial registry values are found in Section 2.1.1. 12. Acknowledgements Thanks in no particular order go to Alexey Melnikov, Paul Hoffman, Brad McInnis, Max Pritikin, Francois Rousseau, Chris Bonatti, and Russ Housley for taking time to provide comments. 13. References 13.1. Normative References [RFC2045] Freed, N. and N. Borenstein, "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies", RFC 2045, DOI 10.17487/RFC2045, November 1996, <http://www.rfc-editor.org/info/rfc2045>. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <http://www.rfc- editor.org/info/rfc2119>. [RFC2585] Housley, R. and P. Hoffman, "Internet X.509 Public Key Infrastructure Operational Protocols: FTP and HTTP", RFC 2585, DOI 10.17487/RFC2585, May 1999, <http://www.rfc- editor.org/info/rfc2585>. [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC 2616, DOI 10.17487/RFC2616, June 1999, <http://www.rfc-editor.org/info/rfc2616>. Obsoleted by RFC7230, RFC7231, RFC7232, RFC7233, RFC7234, RFC7235. [RFC2818] Rescorla, E., "HTTP Over TLS", RFC 2818, DOI 10.17487/RFC2818, May 2000, <http://www.rfc- editor.org/info/rfc2818>. [RFC2985] Nystrom, M. and B. Kaliski, "PKCS #9: Selected Object Classes and Attribute Types Version 2.0", RFC 2985, DOI 10.17487/RFC2985, November 2000, <http://www.rfc- editor.org/info/rfc2985>. [RFC3370] Housley, R., "Cryptographic Message Syntax (CMS) Algorithms", RFC 3370, DOI 10.17487/RFC3370, August 2002, <http://www.rfc-editor.org/info/rfc3370>. [RFC3394] Schaad, J. and R. Housley, "Advanced Encryption Standard (AES) Key Wrap Algorithm", RFC 3394, DOI 10.17487/RFC3394, Turner Expires July 26, 2017 [Page 39] Internet-Draft EST Extensions January 22, 2017 September 2002, <http://www.rfc-editor.org/info/rfc3394>. [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, <http://www.rfc- editor.org/info/rfc3688>. [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, DOI 10.17487/RFC3986, January 2005, <http://www.rfc-editor.org/info/rfc3986>. [RFC4073] Housley, R., "Protecting Multiple Contents with the Cryptographic Message Syntax (CMS)", RFC 4073, DOI 10.17487/RFC4073, May 2005, <http://www.rfc- editor.org/info/rfc4073>. [RFC4108] Housley, R., "Using Cryptographic Message Syntax (CMS) to Protect Firmware Packages", RFC 4108, DOI 10.17487/RFC4108, August 2005, <http://www.rfc-editor.org/info/rfc4108>. [RFC4627] Crockford, D., "The application/json Media Type for JavaScript Object Notation (JSON)", RFC 4627, DOI 10.17487/RFC4627, July 2006, <http://www.rfc- editor.org/info/rfc4627>. Obsoleted by RFC7159. [RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP 26, RFC 5226, DOI 10.17487/RFC5226, May 2008, <http://www.rfc- editor.org/info/rfc5226>. [RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.2", RFC 5246, DOI 10.17487/RFC5246, August 2008, <http://www.rfc- editor.org/info/rfc5246>. [RFC5272] Schaad, J. and M. Myers, "Certificate Management over CMS (CMC)", RFC 5272, DOI 10.17487/RFC5272, June 2008, <http://www.rfc-editor.org/info/rfc5272>. [RFC5273] Schaad, J. and M. Myers, "Certificate Management over CMS (CMC): Transport Protocols", RFC 5273, DOI 10.17487/RFC5273, June 2008, <http://www.rfc- editor.org/info/rfc5273>. [RFC5274] Schaad, J. and M. Myers, "Certificate Management Messages over CMS (CMC): Compliance Requirements", RFC 5274, DOI 10.17487/RFC5274, June 2008, <http://www.rfc- editor.org/info/rfc5274>. Turner Expires July 26, 2017 [Page 40] Internet-Draft EST Extensions January 22, 2017 [RFC5280] Cooper, D., Santesson, S., Farrell, S., Boeyen, S., Housley, R., and W. Polk, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 5280, DOI 10.17487/RFC5280, May 2008, <http://www.rfc-editor.org/info/rfc5280>. [RFC5649] Housley, R. and M. Dworkin, "Advanced Encryption Standard (AES) Key Wrap with Padding Algorithm", RFC 5649, DOI 10.17487/RFC5649, September 2009, <http://www.rfc- editor.org/info/rfc5649>. [RFC5652] Housley, R., "Cryptographic Message Syntax (CMS)", STD 70, RFC 5652, DOI 10.17487/RFC5652, September 2009, <http://www.rfc-editor.org/info/rfc5652>. [RFC5751] Ramsdell, B. and S. Turner, "Secure/Multipurpose Internet Mail Extensions (S/MIME) Version 3.2 Message Specification", RFC 5751, DOI 10.17487/RFC5751, January 2010, <http://www.rfc-editor.org/info/rfc5751>. [RFC5753] Turner, S. and D. Brown, "Use of Elliptic Curve Cryptography (ECC) Algorithms in Cryptographic Message Syntax (CMS)", RFC 5753, DOI 10.17487/RFC5753, January 2010, <http://www.rfc-editor.org/info/rfc5753>. [RFC5754] Turner, S., "Using SHA2 Algorithms with Cryptographic Message Syntax", RFC 5754, DOI 10.17487/RFC5754, January 2010, <http://www.rfc-editor.org/info/rfc5754>. [RFC5934] Housley, R., Ashmore, S., and C. Wallace, "Trust Anchor Management Protocol (TAMP)", RFC 5934, DOI 10.17487/RFC5934, August 2010, <http://www.rfc- editor.org/info/rfc5934>. [RFC5958] Turner, S., "Asymmetric Key Packages", RFC 5958, DOI 10.17487/RFC5958, August 2010, <http://www.rfc- editor.org/info/rfc5958>. [RFC5959] Turner, S., "Algorithms for Asymmetric Key Package Content Type", RFC 5959, DOI 10.17487/RFC5959, August 2010, <http://www.rfc-editor.org/info/rfc5959>. [RFC5967] Turner, S., "The application/pkcs10 Media Type", RFC 5967, DOI 10.17487/RFC5967, August 2010, <http://www.rfc- editor.org/info/rfc5967>. [RFC6010] Housley, R., Ashmore, S., and C. Wallace, "Cryptographic Message Syntax (CMS) Content Constraints Extension", Turner Expires July 26, 2017 [Page 41] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 [RFC7186] Yi, J., Herberg, U., and T. Clausen, "Security Threats for the Neighborhood Discovery Protocol (NHDP)", RFC 7186, April 2014. URIs [1] <https://github.com/jech/babeld> [2] <https://github.com/Quagga-RE/quagga-RE> Ovsienko Expires October 20, 2014 [Page 47] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 Appendix A. Figures and Tables +-------------------------------------------------------------+ | authentication-specific statistics | +-------------------------------------------------------------+ ^ | ^ | v | | +-----------------------------------------------+ | | | system operator | | | +-----------------------------------------------+ | | ^ | ^ | ^ | ^ | ^ | | | | v | | | | | | | v | +---+ +---------+ | | | | | | +---------+ +---+ | |->| ANM | | | | | | | | LocalTS |->| | | R |<-| table | | | | | | | | LocalPC |<-| T | | x | +---------+ | v | v | v +---------+ | x | | | +----------------+ +---------+ +----------------+ | | | p | | MaxDigestsIn | | | | MaxDigestsOut | | p | | r |<-| ANM timeout | | CSAs | | |->| r | | o | | RxAuthRequired | | | | | | o | | c | +----------------+ +---------+ +----------------+ | c | | e | +-------------+ | | +-------------+ | e | | s | | Rx ESAs | | | | Tx ESAs | | s | | s |<-| (temporary) |<----+ +---->| (temporary) |->| s | | i | +-------------+ +-------------+ | i | | n | +------------------------------+----------------+ | n | | g | | instance of | output buffers |=>| g | | |=>| the original +----------------+ | | | | | protocol | source address |->| | +---+ +------------------------------+----------------+ +---+ /\ | || || v \/ +-------------------------------------------------------------+ | network stack | +-------------------------------------------------------------+ /\ || /\ || /\ || /\ || || \/ || \/ || \/ || \/ +---------+ +---------+ +---------+ +---------+ | speaker | | speaker | ... | speaker | | speaker | +---------+ +---------+ +---------+ +---------+ Flow of control data : ---> Flow of Babel datagrams/packets: ===> Figure 1: Interaction Diagram Ovsienko Expires October 20, 2014 [Page 48] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 P |<---------------------------->| (D1) | B | | |<------------------------->| | | | +--+-----+-----+...+-----+-----+--+ P: Babel packet |H |some |some | |some |some |T | H: Babel packet header | |TLV |TLV | |TLV |TLV | | B: Babel packet body | | | | | | | | T: optional trailing data block +--+-----+-----+...+-----+-----+--+ P |<----------------------------------------------------->| (D2) | B | | |<-------------------------------------------------->| | | | +--+-----+-----+...+-----+-----+------+------+...+------+--+ |H |some |some | |some |some |TS/PC |HMAC | |HMAC |T | | |TLV |TLV | |TLV |TLV |TLV |TLV 1 | |TLV n | | | | | | | | | | | | | | +--+-----+-----+...+-----+-----+------+------+...+------+--+ P |<----------------------------------------------------->| (D3) | B | | |<-------------------------------------------------->| | | | +--+------+------+...+------+-----+-----+...+-----+-----+--+ |H |TS/PC |HMAC | |HMAC |some |some | |some |some |T | | |TLV |TLV 1 | |TLV n |TLV |TLV | |TLV |TLV | | | | | | | | | | | | | | +--+------+------+...+------+-----+-----+...+-----+-----+--+ P |<------------------------------------------------------------>| (D4) | B | | |<--------------------------------------------------------->| | | | +--+-----+------+-----+------+...+-----+------+...+------+-----+--+ |H |some |HMAC |some |HMAC | |some |HMAC | |TS/PC |some |T | | |TLV |TLV 1 |TLV |TLV 2 | |TLV |TLV n | |TLV |TLV | | | | | | | | | | | | | | | +--+-----+------+-----+------+...+-----+------+...+------+-----+--+ Figure 2: Babel Datagram Structure Ovsienko Expires October 20, 2014 [Page 49] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 +-------+-------------------------+---------------+ | Value | Name | Reference | +-------+-------------------------+---------------+ | 0 | Pad1 | [BABEL] | | 1 | PadN | [BABEL] | | 2 | Acknowledgement Request | [BABEL] | | 3 | Acknowledgement | [BABEL] | | 4 | Hello | [BABEL] | | 5 | IHU | [BABEL] | | 6 | Router-Id | [BABEL] | | 7 | Next Hop | [BABEL] | | 8 | Update | [BABEL] | | 9 | Route Request | [BABEL] | | 10 | Seqno Request | [BABEL] | | 11 | TS/PC | this document | | 12 | HMAC | this document | +-------+-------------------------+---------------+ Table 1: Babel TLV Types 0 through 12 +--------------+-----------------------------+-------------------+ | Packet field | Packet octets (hexadecimal) | Meaning (decimal) | +--------------+-----------------------------+-------------------+ | Magic | 2a | 42 | | Version | 02 | version 2 | | Body length | 00:14 | 20 octets | | [TLV] Type | 04 | 4 (Hello) | | [TLV] Length | 06 | 6 octets | | Reserved | 00:00 | no meaning | | Seqno | 09:25 | 2341 | | Interval | 01:90 | 400 (4.00 s) | | [TLV] Type | 08 | 8 (Update) | | [TLV] Length | 0a | 10 octets | | AE | 00 | 0 (wildcard) | | Flags | 40 | default router-id | | Plen | 00 | 0 bits | | Omitted | 00 | 0 bits | | Interval | ff:ff | infinity | | Seqno | 68:21 | 26657 | | Metric | ff:ff | infinity | +--------------+-----------------------------+-------------------+ Table 2: A Babel Packet without Authentication TLVs Ovsienko Expires October 20, 2014 [Page 50] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 +---------------+-------------------------------+-------------------+ | Packet field | Packet octets (hexadecimal) | Meaning (decimal) | +---------------+-------------------------------+-------------------+ | Magic | 2a | 42 | | Version | 02 | version 2 | | Body length | 00:4c | 76 octets | | [TLV] Type | 04 | 4 (Hello) | | [TLV] Length | 06 | 6 octets | | Reserved | 00:00 | no meaning | | Seqno | 09:25 | 2341 | | Interval | 01:90 | 400 (4.00 s) | | [TLV] Type | 08 | 8 (Update) | | [TLV] Length | 0a | 10 octets | | AE | 00 | 0 (wildcard) | | Flags | 40 | default router-id | | Plen | 00 | 0 bits | | Omitted | 00 | 0 bits | | Interval | ff:ff | infinity | | Seqno | 68:21 | 26657 | | Metric | ff:ff | infinity | | [TLV] Type | 0b | 11 (TS/PC) | | [TLV] Length | 06 | 6 octets | | PacketCounter | 00:01 | 1 | | Timestamp | 52:1d:7e:8b | 1377664651 | | [TLV] Type | 0c | 12 (HMAC) | | [TLV] Length | 16 | 22 octets | | KeyID | 00:c8 | 200 | | Digest | fe:80:00:00:00:00:00:00:0a:11 | padding | | | 96:ff:fe:1c:10:c8:00:00:00:00 | | | [TLV] Type | 0c | 12 (HMAC) | | [TLV] Length | 16 | 22 octets | | KeyID | 00:64 | 100 | | Digest | fe:80:00:00:00:00:00:00:0a:11 | padding | | | 96:ff:fe:1c:10:c8:00:00:00:00 | | +---------------+-------------------------------+-------------------+ Table 3: A Babel Packet with Each HMAC TLV Padded Using IPv6 Address fe80::0a11:96ff:fe1c:10c8 Ovsienko Expires October 20, 2014 [Page 51]Internet-Draft EST Extensions January 22, 2017Ovsienko Expires October 20, 2014 [Page 46] RFC 6010, DOI 10.17487/RFC6010, September 2010, <http://www.rfc-editor.org/info/rfc6010>. [RFC6031] Turner, S. and R. Housley, "Cryptographic Message Syntax (CMS) Symmetric Key Package Content Type", RFC 6031, DOI 10.17487/RFC6031, December 2010, <http://www.rfc- editor.org/info/rfc6031>. [RFC6032] Turner, S. and R. Housley, "Cryptographic Message Syntax (CMS) Encrypted Key Package Content Type", RFC 6032, DOI 10.17487/RFC6032, December 2010, <http://www.rfc- editor.org/info/rfc6032>. [RFC6033] Turner, S., "Algorithms for Cryptographic Message Syntax (CMS) Encrypted Key Package Content Type", RFC 6033, DOI 10.17487/RFC6033, December 2010, <http://www.rfc- editor.org/info/rfc6033>. [RFC6160] Turner, S., "Algorithms for Cryptographic Message Syntax (CMS) Protection of Symmetric Key Package Content Types", RFC 6160, DOI 10.17487/RFC6160, April 2011, <http://www.rfc-editor.org/info/rfc6160>. [RFC6161] Turner, S., "Elliptic Curve Algorithms for Cryptographic Message Syntax (CMS) Encrypted Key Package Content Type", RFC 6161, DOI 10.17487/RFC6161, April 2011, <http://www.rfc-editor.org/info/rfc6161>. [RFC6162] Turner, S., "Elliptic Curve Algorithms for Cryptographic Message Syntax (CMS) Asymmetric Key Package Content Type", RFC 6162, DOI 10.17487/RFC6162, April 2011, <http://www.rfc-editor.org/info/rfc6162>. [RFC6268] Schaad, J. and S. Turner, "Additional New ASN.1 Modules for the Cryptographic Message Syntax (CMS) and the Public Key Infrastructure Using X.509 (PKIX)", RFC 6268, DOI 10.17487/RFC6268, July 2011, <http://www.rfc- editor.org/info/rfc6268>. [RFC6402] Schaad, J., "Certificate Management over CMS (CMC) Updates", RFC 6402, DOI 10.17487/RFC6402, November 2011, <http://www.rfc-editor.org/info/rfc6402>. [RFC7303] Thompson, H. and C. Lilley, "XML Media Types", RFC 7303, DOI 10.17487/RFC7303, July 2014, <http://www.rfc- editor.org/info/rfc7303>. [RFC7030] Pritikin, M., Ed., Yee, P., Ed., and D. Harkins, Ed., Turner Expires July 26, 2017 [Page 42] Internet-Draft EST Extensions January 22, 2017 Internet-Draft Babel HMAC Cryptographic Authentication April 2014 +---------------+-------------------------------+-------------------+ | Packet field | Packet octets (hexadecimal) | Meaning (decimal) | +---------------+-------------------------------+-------------------+ | Magic | 2a | 42 | | Version | 02 | version 2 | | Body length | 00:4c | 76 octets | | [TLV] Type | 04 | 4 (Hello) | | [TLV] Length | 06 | 6 octets | | Reserved | 00:00 | no meaning | | Seqno | 09:25 | 2341 | | Interval | 01:90 | 400 (4.00 s) | | [TLV] Type | 08 | 8 (Update) | | [TLV] Length | 0a | 10 octets | | AE | 00 | 0 (wildcard) | | Flags | 40 | default router-id | | Plen | 00 | 0 bits | | Omitted | 00 | 0 bits | | Interval | ff:ff | infinity | | Seqno | 68:21 | 26657 | | Metric | ff:ff | infinity | | [TLV] Type | 0b | 11 (TS/PC) | | [TLV] Length | 06 | 6 octets | | PacketCounter | 00:01 | 1 | | Timestamp | 52:1d:7e:8b | 1377664651 | | [TLV] Type | 0c | 12 (HMAC) | | [TLV] Length | 16 | 22 octets | | KeyID | 00:c8 | 200 | | Digest | c6:f1:06:13:30:3c:fa:f3:eb:5d | HMAC result | | | 60:3a:ed:fd:06:55:83:f7:ee:79 | | | [TLV] Type | 0c | 12 (HMAC) | | [TLV] Length | 16 | 22 octets | | KeyID | 00:64 | 100 | | Digest | df:32:16:5e:d8:63:16:e5:a6:4d | HMAC result | | | c7:73:e0:b5:22:82:ce:fe:e2:3c | | +---------------+-------------------------------+-------------------+ Table 4: A Babel Packet with Each HMAC TLV Containing an HMAC Result Appendix B. Test Vectors The test vectors below may be used to verify the correctness of some procedures performed by an implementation of this mechanism, namely: o appending of TS/PC and HMAC TLVs to the Babel packet body, o padding of the HMAC TLV(s), Ovsienko Expires October 20, 2014 [Page 52] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 o computation of the HMAC result(s), and o placement of the result(s) in the TLV(s). This verification isn't exhaustive, there are other important implementation aspects that would require testing methods of their own. The test vectors were produced as follows. 1. A Babel speaker with a network interface with IPv6 link-local address fe80::0a11:96ff:fe1c:10c8 was configured to use two CSAs for the interface: * CSA1={HashAlgo=RIPEMD-160, KeyChain={{LocalKeyID=200, AuthKeyOctets=Key26}}} * CSA2={HashAlgo=SHA-1, KeyChain={{LocalKeyId=100, AuthKeyOctets=Key70}}} The authentication keys above are: * Key26 in ASCII: ABCDEFGHIJKLMNOPQRSTUVWXYZ * Key26 in hexadecimal: 41:42:43:44:45:46:47:48:49:4a:4b:4c:4d:4e:4f:50 51:52:53:54:55:56:57:58:59:5a * Key70 in ASCII: This=key=is=exactly=70=octets=long.=ABCDEFGHIJKLMNOPQRSTUVWXYZ01234567 * Key70 in hexadecimal: 54:68:69:73:3d:6b:65:79:3d:69:73:3d:65:78:61:63 74:6c:79:3d:37:30:3d:6f:63:74:65:74:73:3d:6c:6f 6e:67:2e:3d:41:42:43:44:45:46:47:48:49:4a:4b:4c 4d:4e:4f:50:51:52:53:54:55:56:57:58:59:5a:30:31 32:33:34:35:36:37 The length of each key was picked to relate (in the terms of Section 2.4) with the properties of respective hash algorithm as follows: Ovsienko Expires October 20, 2014 [Page 53] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 * the digest length (L) of both RIPEMD-160 and SHA-1 is 20 octets, * the internal block size (B) of both RIPEMD-160 and SHA-1 is 64 octets, * the length of Key26 (26) is greater than L but less than B, and * the length of Key70 (70) is greater than B (and thus greater than L). KeyStartAccept, KeyStopAccept, KeyStartGenerate and KeyStopGenerate were set to make both authentication keys valid. 2. The instance of the original protocol of the speaker produced a Babel packet (PktO) to be sent from the interface. Table 2 provides a decoding of PktO, contents of which is below: 2a:02:00:14:04:06:00:00:09:25:01:90:08:0a:00:40 00:00:ff:ff:68:21:ff:ff 3. The authentication mechanism appended one TS/PC TLV and two HMAC TLVs to the packet body, updated the "Body length" packet header field and padded the Digest field of the HMAC TLVs using the link-local IPv6 address of the interface and necessary amount of zeroes. Table 3 provides a decoding of the resulting temporary packet (PktT), contents of which is below: 2a:02:00:4c:04:06:00:00:09:25:01:90:08:0a:00:40 00:00:ff:ff:68:21:ff:ff:0b:06:00:01:52:1d:7e:8b 0c:16:00:c8:fe:80:00:00:00:00:00:00:0a:11:96:ff fe:1c:10:c8:00:00:00:00:0c:16:00:64:fe:80:00:00 00:00:00:00:0a:11:96:ff:fe:1c:10:c8:00:00:00:00 4. The authentication mechanism produced two HMAC results, performing the computations as follows: * For H=RIPEMD-160, K=Key26, and Text=PktT the HMAC result is: c6:f1:06:13:30:3c:fa:f3:eb:5d:60:3a:ed:fd:06:55 83:f7:ee:79 * For H=SHA-1, K=Key70, and Text=PktT the HMAC result is: df:32:16:5e:d8:63:16:e5:a6:4d:c7:73:e0:b5:22:82 ce:fe:e2:3c Ovsienko Expires October 20, 2014 [Page 54] Internet-Draft Babel HMAC Cryptographic Authentication April 2014 5. The authentication mechanism placed each HMAC result into respective HMAC TLV, producing the final authenticated Babel packet (PktA), which was eventually sent from the interface. Table 4 provides a decoding of PktA, contents of which is below: 2a:02:00:4c:04:06:00:00:09:25:01:90:08:0a:00:40 00:00:ff:ff:68:21:ff:ff:0b:06:00:01:52:1d:7e:8b 0c:16:00:c8:c6:f1:06:13:30:3c:fa:f3:eb:5d:60:3a ed:fd:06:55:83:f7:ee:79:0c:16:00:64:df:32:16:5e d8:63:16:e5:a6:4d:c7:73:e0:b5:22:82:ce:fe:e2:3c Interpretation of this process is to be done in the view of Figure 1, differently for the sending and the receiving directions. For the sending direction, given a Babel speaker configured using the IPv6 address and the sequence of CSAs as described above, the implementation SHOULD (see notes in Section 5.3) produce exactly the temporary packet PktT if the original protocol instance produces exactly the packet PktO to be sent from the interface. If the temporary packet exactly matches PktT, the HMAC results computed afterwards MUST exactly match respective results above and the final authenticated packet MUST exactly match the PktA above. For the receiving direction, given a Babel speaker configured using the sequence of CSAs as described above (but a different IPv6 address), the implementation MUST (assuming the TS/PC check didn't fail) produce exactly the temporary packet PktT above if its network stack receives through the interface exactly the packet PktA above from the source IPv6 address above. The first HMAC result computed afterwards MUST match the first result above. The receiving procedure doesn't compute the second HMAC result in this case, but if the implementor decides to compute it anyway for the verification purpose, it MUST exactly match the second result above. Author's Address Denis Ovsienko Yandex 16, Leo Tolstoy St. Moscow, 119021 Russia Email: infrastation@yandex.ru Ovsienko Expires October 20, 2014 [Page 55]