One document matched: draft-ietf-sidr-publication-08.xml
<?xml version="1.0"?>
<!-- TODO
Access control discussion
Access Control impacts of nesting
changed in -08, March 2016:
incremented version of protocol
added optional error code for XML errors
tag is now mandatory on publish/withdraw
removed tag from list query/reply
single success message replaces per-PDU success responses
list must standalone (not enforced by schema)
moved "general operations" text into the publish/withdraw
section, since it doesn't really apply to listing repo
allow multiple error responses. is this wise?
Rob: is schema correct re: empty elements?
Potential changes?
change schema to enforce list being only thing in query
report_error still has the tag being optional, since list no
longer has a tag; may want to say something more about this
-->
<!-- See http://xml.resource.org/ for tools to convert this text -->
<?rfc compact="yes" ?><?rfc editing="no" ?><?rfc sortrefs="yes" ?><?rfc symrefs="yes" ?><?rfc toc="yes" ?><rfc category="std" ipr="trust200902" docName="draft-ietf-sidr-publication-08" obsoletes="" updates="" submissionType="IETF" xml:lang="en">
<front>
<title abbrev="RPKI Publication Protocol">
A Publication Protocol for the Resource Public Key Infrastructure (RPKI)
</title>
<author initials="S." surname="Weiler" fullname="Samuel Weiler">
<organization>Parsons</organization>
<address>
<email>weiler@tislabs.com</email>
</address>
</author>
<author initials="A." surname="Sonalker" fullname="Anuja Sonalker">
<organization abbrev="TowerSec">TowerSec Automotive Cyber Security</organization>
<address>
<email>asonalker@tower-sec.com</email>
</address>
</author>
<author initials="R." surname="Austein" fullname="Rob Austein">
<organization>Dragon Research Labs</organization>
<address>
<email>sra@hactrn.net</email>
</address>
</author>
<date/>
<keyword>SIDR</keyword>
<abstract>
<t>
This document defines a protocol for publishing Resource
Public Key Infrastructure (RPKI) objects. Even though the
RPKI will have many participants issuing certificates and
creating other objects, it is operationally useful to
consolidate the publication of those objects. This document
provides the protocol for doing so.
</t>
</abstract>
</front>
<middle>
<section title="Introduction" toc="default">
<t>
This document assumes a working knowledge of the Resource
Public Key Infrastructure (RPKI), which is intended to support
improved routing security on the Internet.
<xref target="RFC6480" pageno="false" format="default"/>
</t>
<t>
In order to make participation in the RPKI easier, it is
helpful to have a few consolidated repositories for RPKI
objects, thus saving every participant from the cost of
maintaining a new service. Similarly, relying parties using
the RPKI objects will find it faster and more reliable to
retrieve the necessary set from a smaller number of
repositories.
</t>
<t>
These consolidated RPKI object repositories will in many cases
be outside the administrative scope of the organization
issuing a given RPKI object. In some cases, outsourcing
operation of the repository will be an explicit goal: some
resource holders who strongly wish to control their own RPKI
private keys may lack the resources to operate a 24x7
repository, or may simply not wish to do so.
</t>
<t>
The operator of an RPKI publication repository may well be an
Internet registry which issues certificates to its customers,
but it need not be; conceptually, operation of a an RPKI
publication repository is separate from operation of RPKI CA.
</t>
<t>
This document defines an RPKI publication protocol which
allows publication either within or across organizational
boundaries, and which makes fairly minimal demands on either
the CA engine or the publication service.
</t>
<section title="Terminology" toc="default">
<t>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL",
"SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described
in <xref target="RFC2119" pageno="false" format="default"/>.
</t>
<t>
"Publication engine" and "publication server" are used
interchangeably to refer to the server providing the service
described in this document.
</t>
<t>
"Business Public Key Infrastructure" ("Business PKI" or
"BPKI") refers to a PKI, separate from the RPKI, used to
authenticate clients to the publication engine. We use the
term "Business PKI" here because an Internet registry might
already have a PKI for authenticating its clients and might
wish to reuse that PKI for this protocol. There is,
however, no requirement to reuse such a PKI.
</t>
</section>
</section>
<section title="Protocol Specification" toc="default">
<t>
The publication protocol uses XML messages wrapped in signed
CMS messages, carried over HTTP transport.
</t>
<t>
The publication protocol uses a simple request/response
interaction. The client passes a request to the server, and
the server generates a corresponding response.
</t>
<t>
A message exchange commences with the client initiating an
HTTP POST with content type of "application/rpki-publication",
with the message object as the body. The server's response
will similarly be the body of the response with a content type
of "application/rpki-publication".
</t>
<t>
The content of the POST and the server's response will be a
well-formed Cryptographic Message Syntax (CMS)
<xref target="RFC5652" pageno="false" format="default"/> object with OID =
1.2.840.113549.1.7.2 as described in Section 3.1 of
<xref target="RFC6492" pageno="false" format="default"/>.
</t>
<section title="Common XML Message Format" toc="default">
<t>
The XML schema for this protocol is below in
<xref target="schema" pageno="false" format="default"/>. The basic XML message format looks
like this:
</t>
<!-- Begin inclusion: example.common-query.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="query"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<!-- Zero or more PDUs -->
</msg>
</artwork></figure><!-- End inclusion: example.common-query.xml -->
<!-- Begin inclusion: example.common-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<!-- Zero or more PDUs -->
</msg>
</artwork></figure><!-- End inclusion: example.common-reply.xml -->
<t>
Common attributes:
</t>
<t>
<list style="hanging">
<t hangText="version:">
The value of this attribute is the version of this protocol.
This document describes version 4.
</t>
<t hangText="type:">
The possible values of this attribute are "reply" and "query".
</t>
</list>
</t>
<t>
A query PDU may be one of three types: <publish/>,
<withdraw/>, or <list/>.
</t>
<t>
A reply PDU may be one of three types: <success/>,
<list/>, or <report_error/>.
</t>
<t>
The <publish/> and <withdraw/> PDUs include a
tag to facilitate bulk operation.
</t>
</section>
<section title="Publication and Withdrawal" anchor="publish-and-withdraw" toc="default">
<t>
The publication protocol uses a common message format to
request publication of any RPKI object. This format was
chosen specifically to allow this protocol to accommodate
new types of RPKI objects without needing changes to this
protocol.
</t>
<t>
Both the <publish/> and <withdraw/> PDUs have a
payload of a tag and a URI. The <publish/> query also
contains the DER object to be published, encoded in Base64.
</t>
<t>
Both the <publish/> and <withdraw/> PDUs also
have a "hash" attribute, which carries a hash of an existing
object at the specified repository URI. For
<withdraw/> PDUs, the hash is mandatory, as this
operation makes no sense if there is no existing object to
withdraw. For <publish/> PDUs, the hash MUST be
present if the publication operation is overwriting an
existing object, and MUST be omitted if this publication
operation is writing to a new URI where no prior object
exists. Presence of an object when no "hash" attribute is
specified is an error, as is absence of the "hash" attribute
or an incorrect hash value when an object is present. Any
such errors MUST be reported using the <report_error/>
PDU.
</t>
<t>
The hash algorithm is SHA-256 <xref target="SHS" pageno="false" format="default"/>, to
simplify comparison of publication protocol hashes with RPKI
manifest hashes.
</t>
<t>
The intent behind the "hash" attribute is to allow the client
and server to detect any disagreements about the effect that
a <publish/> or <withdraw/> PDU will have on
the repository.
</t>
<t>
Note that every publish and withdraw action requires a new
manifest, thus every publish or withdraw action will involve
at least two objects.
</t>
<t>
Processing of a query message is handled atomically: either
the entire query succeeds or none of it does. When a query
message contains multiple PDUs, failure of any PDU may
require the server to roll back actions triggered by earlier
PDUs.
</t>
<t>
When a query messages containing <publish/> and/or
<withdraw/> PDUs succeeds, a single <success/>
reply is returned.
</t>
<t>
When a query fails, one or more <report_error/> reply
PDUs are generated. Typically, only one
<report_error/> reply is generated, corresponding to
the first query PDU that failed. Servers are permitted to
return multiple <report_error/> PDUs.
</t>
<!-- limit this to just one? -->
</section>
<section title="Listing the repository" anchor="list" toc="default">
<t>
The <list/> operation allows the client to ask the server
for a complete listing of objects which the server believes
the client has published. This is intended primarily to
allow the client to recover upon detecting (probably via use
of the "hash" attribute, see
<xref target="publish-and-withdraw" pageno="false" format="default"/>) that they have
somehow lost synchronization.
</t>
<t>
The <list/> query consists of a single PDU. A
<list/> query must be the only PDU in a query - it may
not be combined with any <publish/> or
<withdraw/> queries.
</t>
<t>
The <list/> reply consists of zero or more PDUs,
one per object published in this repository by this client,
each PDU conveying the URI and hash of one published object.
</t>
</section>
<section title="Error handling" anchor="errors" toc="default">
<t>
Errors are handled at two levels.
</t>
<t>
Errors that make it impossible to decode a query or encode a
response are handled at the HTTP layer. 4xx and 5xx HTTP
response codes indicate that something bad happened.
</t>
<t>
In all other cases, errors result in an XML
<report_error/> PDU. Like the rest of this
protocol, <report_error/> PDUs are CMS-signed XML
messages and thus can be archived to provide an audit trail.
</t>
<t>
<report_error/> PDUs only appear in replies,
never in queries.
</t>
<t>
The "tag" attribute of the <report_error/> PDU associated
with a <publish/> or <withdraw/> PDU MUST be
set to the same value as the "tag" attribute in the PDU
which generated the error. A client can use the "tag"
attribute to determine which PDU caused processing of an
update to fail.
</t>
<t>
The error itself is conveyed in the "error_code"
attribute. The value of this attribute is a token indicating
the specific error that occurred.
</t>
<t>
The body of the <report_error/> element contains two
sub-elements:
</t>
<t>
<list style="numbers">
<t>
An optional text element <error_text/>, which if
present, contains a text string with debugging
information intended for human consumption.
</t>
<t>
An optional element <failed_pdu/>, which, if
present, contains a verbatim copy of the query PDU whose
failure triggered the <report_error/> PDU. The
quoted element must be syntactically valid.
</t>
</list>
</t>
<t>
See <xref target="multi-element" pageno="false" format="default"/> for examples of a
multi-element query and responses.
</t>
</section>
<section title="Error Codes" anchor="errorcodes" toc="default">
<t>
These are the defined error codes as well as some discussion
of each. Text similar to these descriptions may be sent in an
<error_text/> element to help explain the error encountered.
</t>
<t>
<list style="hanging">
<t hangText="xml_error:">
Encountered an XML problem. Note that some XML errors may
be severe enough to require error reporting at the HTTP
layer, instead. Implementations MAY choose to report
any or all XML errors at the HTTP layer.
</t>
<t hangText="permission_failure:">
Client does not have permission to update this URI.
</t>
<t hangText="bad_cms_signature:">
Bad CMS signature.
</t>
<t hangText="object_already_present:">
An object is already present at this URI, yet a "hash"
attribute was not specified. A "hash" attribute must be
specified when overwriting or deleting an object.
Perhaps client and server are out of sync?
</t>
<t hangText="no_object_present:">
There is no object present at this URI, yet a "hash"
attribute was specified. Perhaps client and server are
out of sync?
</t>
<t hangText="no_object_matching_hash">
The "hash" attribute supplied does not match the "hash"
attribute of the object at this URI. Perhaps client and
server are out of sync?
</t>
<t hangText="consistency_problem:">
Server detected an update that looks like it will cause
a consistency problem (e.g. an object was deleted, but
the manifest was not updated). Note that a server is not
required to make such checks. Indeed, it may be unwise for
a server to do so. This error code just provides a way for
the server to explain its (in-)action.
</t>
<t hangText="other_error:">
A meteor fell on the server.
</t>
</list>
</t>
</section>
<section title="XML Schema" anchor="schema" toc="default">
<t>
The following is a RelaxNG compact form schema describing
the Publication Protocol.
</t>
<!-- Begin inclusion: rpki-publication.xml --><figure><artwork># $Id: rpki-publication.rnc 3595 2016-03-21 21:31:37Z sra $
# RelaxNG schema for RPKI publication protocol.
default namespace =
"http://www.hactrn.net/uris/rpki/publication-spec/"
# This is version 4 of the protocol.
version = "4"
# Top level PDU is either a query or a reply.
start |= element msg {
attribute version { version },
attribute type { "query" },
query_elt*
}
start |= element msg {
attribute version { version },
attribute type { "reply" },
reply_elt*
}
# Tag attributes for bulk operations.
tag = attribute tag { xsd:token { maxLength="1024" } }
# Base64 encoded DER stuff.
base64 = xsd:base64Binary
# Publication URIs.
uri = attribute uri { xsd:anyURI { maxLength="4096" } }
# Digest of an existing object (hexadecimal).
hash = attribute hash { xsd:string { pattern = "[0-9a-fA-F]+" } }
# Error codes.
error |= "xml_error"
error |= "permission_failure"
error |= "bad_cms_signature"
error |= "object_already_present"
error |= "no_object_present"
error |= "no_object_matching_hash"
error |= "consistency_problem"
error |= "other_error"
# <publish/> query
query_elt |= element publish { tag, uri, hash?, base64 }
# <withdraw/> query
query_elt |= element withdraw { tag, uri, hash }
# <success/> reply
reply_elt |= element success { empty }
# <list/> query and reply
query_elt |= element list { empty }
reply_elt |= element list { uri, hash }
# <report_error/> reply
reply_elt |= element report_error {
tag?,
attribute error_code { error },
element error_text { xsd:string { maxLength="512000" }}?,
element failed_pdu { query_elt }?
}
</artwork></figure><!-- End inclusion: rpki-publication.xml -->
</section>
</section>
<section title="Examples" toc="default">
<t>
Following are examples of various queries and the
corresponding replies for the RPKI publication protocol.
</t>
<t>
Note the authors have taken liberties with the Base64, hash,
and URI text in these examples in the interest of making the
examples fit nicely into RFC text format.
</t>
<section title="<publish/> Query, No Existing Object" toc="default">
<!-- Begin inclusion: example.publish-new-query.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="query"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<publish
tag="foo"
uri="rsync://wombat.example/Alice/01a97a70ac477f06.cer">
SGVsbG8sIG15IG5hbWUgaXMgQWxpY2U=
</publish>
</msg>
</artwork></figure><!-- End inclusion: example.publish-new-query.xml -->
</section>
<section title="<publish/> Query, Overwriting Existing Object" toc="default">
<!-- Begin inclusion: example.publish-existing-query.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="query"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<publish
hash="01a97a70ac477f06"
tag="foo"
uri="rsync://wombat.example/Alice/01a97a70ac477f06.cer">
SGVsbG8sIG15IG5hbWUgaXMgQWxpY2U=
</publish>
</msg>
</artwork></figure><!-- End inclusion: example.publish-existing-query.xml -->
</section>
<section title="<withdraw/> Query" toc="default">
<!-- Begin inclusion: example.withdraw-query.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="query"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<withdraw
hash="01a97a70ac477f06"
tag="foo"
uri="rsync://wombat.example/Alice/01a97a70ac477f06.cer"/>
</msg>
</artwork></figure><!-- End inclusion: example.withdraw-query.xml -->
</section>
<section title="<success/> Reply" toc="default">
<!-- Begin inclusion: example.success-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<success/>
</msg>
</artwork></figure><!-- End inclusion: example.success-reply.xml -->
</section>
<section title="<report_error/> With Optional Elements" toc="default">
<!-- Begin inclusion: example.error-with-optional-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<report_error
error_code="no_object_matching_hash"
tag="foo">
<error_text>
Can't delete an object I don't have
</error_text>
<failed_pdu>
<publish
hash="01a97a70ac477f06"
tag="foo"
uri="rsync://wombat.example/Alice/01a97a70ac477f06.cer">
SGVsbG8sIG15IG5hbWUgaXMgQWxpY2U=
</publish>
</failed_pdu>
</report_error>
</msg>
</artwork></figure><!-- End inclusion: example.error-with-optional-reply.xml -->
</section>
<section title="<report_error/> Without Optional Elements" toc="default">
<!-- Begin inclusion: example.error-without-optional-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<report_error
error_code="object_already_present"
tag="foo"/>
</msg>
</artwork></figure><!-- End inclusion: example.error-without-optional-reply.xml -->
</section>
<section title="Error Handling With Multi-Element Queries" anchor="multi-element" toc="default">
<section title="Multi-Element Query" toc="default">
<!-- Begin inclusion: example.multi-query.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="query"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<publish
tag="Alice"
uri="rsync://wombat.example/Alice/01a97a70ac477f06.cer">
SGVsbG8sIG15IG5hbWUgaXMgQWxpY2U=
</publish>
<withdraw
hash="f46a4198efa3070e"
tag="Bob"
uri="rsync://wombat.example/Bob/f46a4198efa3070e.cer"/>
<publish
tag="Carol"
uri="rsync://wombat.example/Carol/32e0544eeb510ec0.cer">
SGVsbG8sIG15IG5hbWUgaXMgQ2Fyb2w=
</publish>
<withdraw
hash="421ee4ac65732d72"
tag="Dave"
uri="rsync://wombat.example/Dave/421ee4ac65732d72.cer"/>
<publish
tag="Eve"
uri="rsync://wombat.example/Eve/9dd859b01e5c2ebd.cer">
SGVsbG8sIG15IG5hbWUgaXMgRXZl
</publish>
</msg>
</artwork></figure><!-- End inclusion: example.multi-query.xml -->
</section>
<section title="Successful Multi-Element Response" toc="default">
<!-- Begin inclusion: example.success-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<success/>
</msg>
</artwork></figure><!-- End inclusion: example.success-reply.xml -->
</section>
<section title="Failure Multi-Element Response, First Error Only" toc="default">
<!-- Begin inclusion: example.multi-error-first-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<report_error
error_code="no_object_matching_hash"
tag="Dave">
<failed_pdu>
<withdraw
hash="421ee4ac65732d72"
tag="Dave"
uri="rsync://wombat.example/Dave/421ee4ac65732d72.cer"/>
</failed_pdu>
</report_error>
</msg>
</artwork></figure><!-- End inclusion: example.multi-error-first-reply.xml -->
</section>
<section title="Failure Multi-Element Response, All Errors" toc="default">
<!-- Begin inclusion: example.multi-error-all-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<report_error
error_code="no_object_matching_hash"
tag="Dave">
<failed_pdu>
<withdraw
hash="421ee4ac65732d72"
tag="Dave"
uri="rsync://wombat.example/Dave/421ee4ac65732d72.cer"/>
</failed_pdu>
</report_error>
<report_error
error_code="object_already_present"
tag="Eve">
<failed_pdu>
<publish
tag="Eve"
uri="rsync://wombat.example/Eve/9dd859b01e5c2ebd.cer">
SGVsbG8sIG15IG5hbWUgaXMgRXZl
</publish>
</failed_pdu>
</report_error>
</msg>
</artwork></figure><!-- End inclusion: example.multi-error-all-reply.xml -->
</section>
</section>
<section title="<list/> Query" toc="default">
<!-- Begin inclusion: example.list-query.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="query"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<list/>
</msg>
</artwork></figure><!-- End inclusion: example.list-query.xml -->
</section>
<section title="<list/> Reply" toc="default">
<!-- Begin inclusion: example.list-reply.xml --><!-- Automatically generated, do not edit. --><figure><artwork>
<msg
type="reply"
version="4"
xmlns="http://www.hactrn.net/uris/rpki/publication-spec/">
<list
hash="eb719b72f0648cf4"
uri="rsync://wombat.example/Fee/eb719b72f0648cf4.cer"/>
<list
hash="c7c50a68b7aa50bf"
uri="rsync://wombat.example/Fie/c7c50a68b7aa50bf.cer"/>
<list
hash="f222481ded47445d"
uri="rsync://wombat.example/Foe/f222481ded47445d.cer"/>
<list
hash="15b94e08713275bc"
uri="rsync://wombat.example/Fum/15b94e08713275bc.cer"/>
</msg>
</artwork></figure><!-- End inclusion: example.list-reply.xml -->
</section>
</section>
<section title="Operational Considerations" toc="default">
<t>
There are two basic options open to the repository operator as to how
the publication tree is laid out. The first option is simple: each
publication client is given its own directory one level below the top
of the rsync module, and there is no overlap between the publication
spaces used by different clients. For example:
</t>
<t>
rsync://example.org/rpki/Alice/ <vspace blankLines="0"/>
rsync://example.org/rpki/Bob/ <vspace blankLines="0"/>
rsync://example.org/rpki/Carol/
</t>
<t>
This has the advantage of being very easy for the publication operator
to manage, but has the drawback of making it difficult for relying
parties to fetch published objects both safely and as efficiently as
possible.
</t>
<t>
Given that the mandatory-to-implement retrieval protocol for relying
parties is rsync, a more efficient repository structure would be one
which minimized the number of rsync fetches required. One such
structure would be one in which the publication directories for
subjects were placed underneath the publication directories of their
issuers: since the normal synchronization tree walk is top-down, this
can significantly reduce the total number of rsync connections
required to synchronize. For example:
</t>
<t>
rsync://example.org/rpki/Alice/ <vspace blankLines="0"/>
rsync://example.org/rpki/Alice/Bob/ <vspace blankLines="0"/>
rsync://example.org/rpki/Alice/Bob/Carol/
</t>
<t>
Preliminary measurement suggests that, in the case of large numbers of
small publication directories, the time needed to set up and tear down
individual rsync connections becomes significant, and that a properly
optimized tree structure can reduce synchronization time by an order
of magnitude.
</t>
<t>
The more complex tree structure does require careful attention to the
"base_uri" attribute values when setting up clients. In the example
above, assuming that Alice issues to Bob who in turn issues to Carol,
Alice has ceded control of a portion of her publication space to Bob,
who has in turn ceded a portion of that to Carol, and the "base_uri"
attributes in the <client/> setup messages should reflect this.
</t>
<t>
The details of how the repository operator determines that Alice has
given Bob permission to nest Bob's publication directory under Alice's
is outside the scope of this protocol.
</t>
</section>
<section title="IANA Considerations" toc="default">
<t>
IANA is asked to register the application/rpki-publication
MIME media type as follows:
</t>
<!-- Begin inclusion: mime-type.xml --><figure><artwork>
MIME media type name: application
MIME subtype name: rpki-publication
Required parameters: None
Optional parameters: None
Encoding considerations: binary
Security considerations: Carries an RPKI Publication Protocol
Message, as defined in this document.
Interoperability considerations: None
Published specification: This document
Applications which use this media type: HTTP
Additional information:
Magic number(s): None
File extension(s):
Macintosh File Type Code(s):
Person & email address to contact for further information:
Rob Austein <sra@hactrn.net>
Intended usage: COMMON
Author/Change controller: Rob Austein <sra@hactrn.net>
</artwork></figure><!-- End inclusion: mime-type.xml -->
</section>
<section title="Security Considerations" anchor="security" toc="default">
<t>
The RPKI publication protocol and the data it publishes use
entirely separate PKIs for authentication. The published data
is authenticated within the RPKI, and this protocol has
nothing to do with that authentication, nor does it require
that the published objects be valid in the RPKI. The
publication protocol uses a separate Business PKI (BPKI) to
authenticate its messages.
</t>
<t>
Each RPKI publication protocol message is CMS-signed.
Because of that protection at the application layer, this
protocol does not require the use of HTTPS or other transport
security mechanisms.
</t>
<t>
Although the hashes used in the <publish/> and
<withdraw/> PDUs are cryptographic strength, the digest
algorithm was selected for convenience in comparing these
hashes with the hashes that appear in RPKI manifests. The
hashes used in the <publish/> and <withdraw/> PDUs
are not particularly security-sensitive, because these PDUs
are protected by the CMS signatures.
</t>
<t>
Compromise of a publication server, perhaps through
mismanagement of BPKI keys, could lead to a denial-of-service
attack on the RPKI. An attacker gaining access to BPKI keys
could use this protocol delete (withdraw) RPKI objects,
leading to routing changes or failures. Accordingly, as in
most PKIs, good key management practices are important.
</t>
</section>
</middle>
<back>
<references title="Normative References">
<!-- Begin inclusion: reference.RFC.6492.xml --><reference anchor="RFC6492">
<front>
<title>A Protocol for Provisioning Resource Certificates</title>
<author fullname="G. Huston" initials="G." surname="Huston">
<organization/>
</author>
<author fullname="R. Loomans" initials="R." surname="Loomans">
<organization/>
</author>
<author fullname="B. Ellacott" initials="B." surname="Ellacott">
<organization/>
</author>
<author fullname="R. Austein" initials="R." surname="Austein">
<organization/>
</author>
<date month="February" year="2012"/>
<keyword>RPKI</keyword>
<abstract>
<t>This document defines a framework for certificate management interactions between an Internet Number Resource issuer ("issuer") and an Internet Number Resource recipient ("subject") through the specification of a protocol for interaction between the two parties. The protocol supports the transmission of requests from the subject, and corresponding responses from the issuer encompassing the actions of certificate issuance, certificate revocation, and certificate status information reports. This protocol is intended to be limited to the application of Internet Number Resource Certificate management and is not intended to be used as part of a more general certificate management framework. [STANDARDS-TRACK]</t>
</abstract>
</front>
<seriesInfo name="RFC" value="6492"/>
<format type="TXT" octets="65896" target="http://www.rfc-editor.org/rfc/rfc6492.txt"/>
<!-- current-status PROPOSED STANDARD -->
<!-- publication-status PROPOSED STANDARD -->
</reference><!-- End inclusion: reference.RFC.6492.xml -->
<!-- Begin inclusion: reference.RFC.2119.xml --><reference anchor="RFC2119">
<front>
<title>Key words for use in RFCs to Indicate Requirement Levels</title>
<author fullname="S. Bradner" initials="S." surname="Bradner">
<organization/>
</author>
<date month="March" year="1997"/>
<keyword>Standards</keyword>
<keyword>Track</keyword>
<keyword>Documents</keyword>
<abstract>
<t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
</abstract>
</front>
<seriesInfo name="RFC" value="2119"/>
<seriesInfo name="BCP" value="14"/>
<format type="TXT" octets="4723" target="http://www.rfc-editor.org/rfc/rfc2119.txt"/>
<!-- current-status BEST CURRENT PRACTICE -->
<!-- publication-status BEST CURRENT PRACTICE -->
</reference><!-- End inclusion: reference.RFC.2119.xml -->
<!-- Begin inclusion: reference.RFC.5652.xml --><reference anchor="RFC5652">
<front>
<title>Cryptographic Message Syntax (CMS)</title>
<author fullname="R. Housley" initials="R." surname="Housley">
<organization/>
</author>
<date month="September" year="2009"/>
<keyword>digital signature</keyword>
<keyword>message content</keyword>
<abstract>
<t>This document describes the Cryptographic Message Syntax (CMS). This syntax is used to digitally sign, digest, authenticate, or encrypt arbitrary message content. [STANDARDS-TRACK]</t>
</abstract>
</front>
<seriesInfo name="RFC" value="5652"/>
<seriesInfo name="STD" value="70"/>
<format type="TXT" octets="126813" target="http://www.rfc-editor.org/rfc/rfc5652.txt"/>
<!-- obsoletes RFC3852 -->
<!-- current-status INTERNET STANDARD -->
<!-- publication-status DRAFT STANDARD -->
</reference><!-- End inclusion: reference.RFC.5652.xml -->
<reference anchor="SHS" target="http://csrc.nist.gov/publications/fips/fips180-4/fips-180-4.pdf">
<!-- anchor="FIPS.180-4" -->
<front>
<title>Secure Hash Standard</title>
<author>
<organization>National Institute of Standards and Technology</organization>
</author>
<date month="March" year="2012"/>
</front>
<seriesInfo name="FIPS" value="PUB 180-4"/>
</reference>
</references>
<references title="Informative References">
<!-- Begin inclusion: reference.RFC.6480.xml --><reference anchor="RFC6480">
<front>
<title>An Infrastructure to Support Secure Internet Routing</title>
<author fullname="M. Lepinski" initials="M." surname="Lepinski">
<organization/>
</author>
<author fullname="S. Kent" initials="S." surname="Kent">
<organization/>
</author>
<date month="February" year="2012"/>
<keyword>RPKI</keyword>
<keyword>BGP</keyword>
<keyword>ROA</keyword>
<abstract>
<t>This document describes an architecture for an infrastructure to support improved security of Internet routing. The foundation of this architecture is a Resource Public Key Infrastructure (RPKI) that represents the allocation hierarchy of IP address space and Autonomous System (AS) numbers; and a distributed repository system for storing and disseminating the data objects that comprise the RPKI, as well as other signed objects necessary for improved routing security. As an initial application of this architecture, the document describes how a legitimate holder of IP address space can explicitly and verifiably authorize one or more ASes to originate routes to that address space. Such verifiable authorizations could be used, for example, to more securely construct BGP route filters. This document is not an Internet Standards Track specification; it is published for informational purposes.</t>
</abstract>
</front>
<seriesInfo name="RFC" value="6480"/>
<format type="TXT" octets="62127" target="http://www.rfc-editor.org/rfc/rfc6480.txt"/>
<!-- current-status INFORMATIONAL -->
<!-- publication-status INFORMATIONAL -->
</reference><!-- End inclusion: reference.RFC.6480.xml -->
</references>
</back>
</rfc><!--
- Local Variables:
- mode:sgml
- End:
-->
| PAFTECH AB 2003-2026 | 2026-04-23 10:13:04 |