<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.19 (Ruby 3.1.3) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-lamps-rfc7030-csrattrs-21" category="std" consensus="true" submissionType="IETF" updates="7030" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.20.1 -->
  <front>
    <title abbrev="CSRAttrs">Clarification and enhancement of RFC7030 CSR Attributes definition</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-lamps-rfc7030-csrattrs-21"/>
    <author initials="M." surname="Richardson" fullname="Michael Richardson" role="editor">
      <organization>Sandelman Software Works</organization>
      <address>
        <email>mcr+ietf@sandelman.ca</email>
      </address>
    </author>
    <author initials="O." surname="Friel" fullname="Owen Friel">
      <organization>Cisco</organization>
      <address>
        <email>ofriel@cisco.com</email>
      </address>
    </author>
    <author initials="D." surname="von Oheimb" fullname="Dr. David von Oheimb">
      <organization>Siemens</organization>
      <address>
        <email>dev@ddvo.net</email>
      </address>
    </author>
    <author initials="D." surname="Harkins" fullname="Dan Harkins">
      <organization>The Industrial Lounge</organization>
      <address>
        <email>dharkins@lounge.org</email>
      </address>
    </author>
    <date year="2025" month="May" day="08"/>
    <area>Internet</area>
    <workgroup>LAMPS Working Group</workgroup>
    <keyword>Internet-Draft</keyword>
    <abstract>
      <?line 94?>

<t>This document updates RFC7030, Enrollment over Secure Transport (EST), clarifying
how the Certificate Signiing Request (CSR) Attributes Response can be used by an EST server to specify
both CSR attribute Object IDs (OID) and also CSR attribute values,
in particular X.509 extension values,
that the server expects the client to include in subsequent CSR request.</t>
      <t>RFC7030 (EST) is ambiguous in its specification of the CSR Attributes Response.
This has resulted in implementation challenges and implementor confusion.
As a result, there was not universal understanding of what was specified.
This document clarifies the encoding rules.</t>
      <t>This document therefore also provides a new straightforward approach: using
a template for CSR contents that may be partially filled in by the server.
This also allows an EST server to specify a subject Distinguished Name (DN).</t>
    </abstract>
  </front>
  <middle>
    <?line 111?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>This document updates RFC7030 Enrollment over Secure Transport (EST) and clarifies
how the Certificate Signing Request (CSR) Attributes Response can be used by an EST server to specify
both CSR attribute OIDs and also CSR attribute values.
In particular, the server needs to be able to specify X.509 extension values that it expects the client to include in the subsequent CSR.</t>
      <t>Enrollment over Secure Transport <xref target="RFC7030"/> (EST) has been used in a wide variety of applications.
In particular, <xref target="RFC8994"/> and <xref target="RFC8995"/> describe a way to use it in order to build out an Autonomic Control Plane (ACP) <xref target="RFC8368"/>.</t>
      <t>When bootstrapping the ACP, there is a requirement that each node be given a very specific subjectAltName.
In <xref target="RFC8994"/>, the ACP specification, the EST server is specified to make use of the CSR Attributes ("/csrattrs") resource (specified in <xref section="2.6" sectionFormat="comma" target="RFC7030"/>) to convey to the EST client the actual subjectAltName that needs to go
into its CSR and thus ultimately into its End Entity certificate.</t>
      <t>As a result of some implementation challenges, it came to light that this particular way of using the CSR attributes was not universally agreed upon, and it was suggested that it went contrary to <xref section="2.6" sectionFormat="comma" target="RFC7030"/>.</t>
      <t><xref section="2.6" sectionFormat="comma" target="RFC7030"/> says that the CSR attributes "can provide additional
descriptive information that the EST server cannot access itself".
This is extended to describe how the EST server can provide values that it demands be used.</t>
      <t>After significant discussion, it has been determined that
<xref section="4.5" sectionFormat="of" target="RFC7030"/> specification is sufficiently difficult
to read and ambiguous to interpret that clarification is needed.</t>
      <t>Also, <xref section="4.5.2" sectionFormat="comma" target="RFC7030"/> is extended to clarify the use of the existing ASN.1 syntax <xref target="X.680"/><xref target="X.690"/>.</t>
      <t>This covers all uses and is fully backward compatible with existing use,
including addressesing the needs of <xref target="RFC8994"/> and <xref target="RFC8995"/>.</t>
    </section>
    <section anchor="terminology">
      <name>Terminology</name>
      <t>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 BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.
<?line -6?>
      </t>
    </section>
    <section anchor="csr-attributes-handling">
      <name>CSR Attributes Handling</name>
      <section anchor="extensions-to-rfc-7030-section-26">
        <name>Extensions to RFC 7030 section 2.6</name>
        <t>Replace the second paragraph with the following text:</t>
        <artwork><![CDATA[
   These attributes can provide additional tinformation that
   the EST server cannot access itself, such as the Media Access Control
   (MAC) address of an interface of the EST client. The EST server can
   also provide concrete values that it tells the client to include in
   the CSR, such as a specific X.509 Subject Alternative Name extension.
   Moreover, these attributes can indicate the type of the included
   public key or which crypto algorithms to use for the self-signature,
   such as a specific elliptic curve or a specific hash function that
   the client is expected to use when generating the CSR.
]]></artwork>
      </section>
      <section anchor="csrattrs">
        <name>Extensions to RFC 7030 section 4.5.2</name>
        <t>The ASN.1 syntax for CSR Attributes as defined in EST <xref section="4.5.2" sectionFormat="comma" target="RFC7030"/> is as follows:</t>
        <artwork><![CDATA[
   CsrAttrs ::= SEQUENCE SIZE (0..MAX) OF AttrOrOID

   AttrOrOID ::= CHOICE (oid OBJECT IDENTIFIER, attribute Attribute }

   Attribute { ATTRIBUTE:IOSet } ::= SEQUENCE {
        type   ATTRIBUTE.&id({IOSet}),
        values SET SIZE(1..MAX) OF ATTRIBUTE.&Type({IOSet}{@type}) }
]]></artwork>
        <t>This remains unchanged, such that bits-on-the-wire compatibility is maintained.</t>
        <t>Key parts that were unclear were which OID to use in the '<tt>type</tt>' field and
that the '<tt>values</tt>' field can contain an entire sequence of X.509 extensions.</t>
        <t>The OID to use for such attributes in the '<tt>type</tt>' field MUST be <tt>id-ExtensionReq</tt>,
which has the value 1.2.840.113549.1.9.14.
Note that is the same as <tt>pkcs-9-at-extensionRequest</tt> defined in PKCS#9 <xref target="RFC2985"/>.
There MUST be only one such attribute.</t>
        <t>The '<tt>values</tt>' field of this attribute MUST contain a set with exactly one element,
and this element MUST be of type <tt>Extensions</tt>, as per <xref section="4.1" sectionFormat="of" target="RFC5280"/>:</t>
        <artwork><![CDATA[
   Extensions  ::=  SEQUENCE SIZE (1..MAX) OF Extension

   Extension  ::=  SEQUENCE  {
        extnID      OBJECT IDENTIFIER,
        critical    BOOLEAN DEFAULT FALSE,
        extnValue   OCTET STRING
                    -- contains the DER encoding of an ASN.1 value
                    -- corresponding to the extension type identified
                    -- by extnID
        }
]]></artwork>
        <t>An Extension comprises the OID of the specific X.509 extension (extnID),
optionally the 'critical' bit, and the extension value (extnValue).</t>
        <t>An Extensions structure, which is a sequence of elements of type Extension,
MUST NOT include more than one element with a particular extnID.</t>
        <t>When not using the template-based approach of <xref target="csrtemplate"/>,
specifying the requirement for a public key of a specific type
and optionally its size and other parameters MUST be done as follows:
Include exactly one Attribute with the <tt>type</tt> field being the OID specifying
the type of the key, such as <tt>ecPublicKey</tt> or <tt>rsaEncryption</tt>.
The '<tt>values</tt>' field MAY be empty to indicate no further requirements on the key.
Otherwise, it MUST contain suitable parameters for the given key type,
such as a singleton set containing the OID of an EC curve such as <tt>secp384r1</tt>
or containing an integer value for the RSA key size such as 4096.
Many examples for this are given in <xref target="examples"/>.</t>
      </section>
      <section anchor="csrtemplate">
        <name>Use of CSR templates</name>
        <t>Alternatively to the unstructured inclusion of CSR attributes
specified in <xref section="4.5.2" sectionFormat="comma" target="RFC7030"/> with its limitations and ambiguities,
<xref section="B" sectionFormat="of" target="RFC8295"/> describes an approach using a CSR template.
An entire CSR object is returned with various fields filled out,
and other fields waiting to be filled in.
In that approach, a pKCS7PDU attribute includes a Full PKI Data content type <xref target="RFC5272"/>
and that in turn includes an <xref target="RFC2986"/> CSR or a Certificate Request Message Format (CRMF) formatted request
(for details see <xref target="RFC6268"/> Sections 5 or 9, respectively).</t>
        <t>One drawback to that approach, particularly for the CSR, is that some unused
fields have to be included; specifically, the '<tt>signature</tt>' field on
the CSR is faked with an empty bit string.</t>
        <t>A similar method has been defined in CMP Updates <xref target="RFC9480"/>
and the Lightweight CMP profile <xref section="4.3.3" sectionFormat="comma" target="RFC9483"/>,
using a CSR template as defined for CRMF <xref target="RFC4211"/>.
Like the approach mentioned before,
this method does not properly deal with absent Relative Distinguished Name (RDN) values, as it would encode them as invalid empty strings.
Also encoding an absent '<tt>subjectPublicKey</tt>' value as an empty <tt>BIT STRING</tt>
and an absent X.509 extension value as an empty <tt>OCTET STRING</tt>
can cause issues with strict ASN.1 parsing and decoding.</t>
        <t>These drawbacks are avoided as follows:</t>
        <t>This specification defines a new Certificate Request Information Template attribute
for <tt>CsrAttrs</tt> (as given in <xref target="csrattrs"/>) that is essentially
a partially filled in PKCS#10 CSR minus the signature wrapper:</t>
        <artwork><![CDATA[
  CertificationRequestInfoTemplate ::= SEQUENCE {
      version       INTEGER { v1(0) } (v1, ... ),
      subject       NameTemplate OPTIONAL,
      subjectPKInfo [0] SubjectPublicKeyInfoTemplate
                                {{ PKInfoAlgorithms }} OPTIONAL,
      attributes    [1] Attributes{{ CRIAttributes }}
  }
]]></artwork>
        <t><xref target="app-asn1-module"/> contains all detail.</t>
        <t>The CertificationRequestInfoTemplate closely resembles the CertificationRequestInfo
from <xref section="5" sectionFormat="comma" target="RFC5912"/>:</t>
        <artwork><![CDATA[
  CertificationRequestInfo ::= SEQUENCE {
    version       INTEGER { v1(0) } (v1,...),
    subject       Name,
    subjectPKInfo SubjectPublicKeyInfo{{ PKInfoAlgorithms }},
    attributes    [0] Attributes{{ CRIAttributes }}
  }
]]></artwork>
        <t>with the following differences.</t>
        <ul spacing="normal">
          <li>
            <t>The '<tt>subject</tt>' field has been made <tt>OPTIONAL</tt>.
It MUST be present if the server places any requirements on the RDNs of the subject name;
otherwise, it MUST be absent.</t>
          </li>
          <li>
            <t>RelativeDistinguishedNames (RDNs) in the '<tt>subject</tt>' fields are allowed to have no value,
which has been achieved by adding <tt>OPTIONAL</tt> to the '<tt>value</tt>' field of <tt>SingleAttributeTemplate</tt>.
If the client is expected to provide an RDN of a certain type such as <tt>commonName</tt>,
the respective RDN MUST be present in the '<tt>subject</tt>' field; otherwise it MUST be absent.
If the RDN value is present, this means that the client is required to use the given value
for the RDN, otherwise the client is expected to fill in the value.
(The example at the end of this section shows a server specifying the RDN)</t>
          </li>
        </ul>
        <artwork><![CDATA[
  SingleAttributeTemplate {ATTRIBUTE:AttrSet} ::= SEQUENCE {
      type      ATTRIBUTE.&id({AttrSet}),
      value     ATTRIBUTE.&Type({AttrSet}{@type}) OPTIONAL
  }

]]></artwork>
        <ul spacing="normal">
          <li>
            <t>The '<tt>subjectPKInfo</tt>' field has been made <tt>OPTIONAL</tt>.
The field MUST be absent if the server places no requirements on the key.
Otherwise, it MUST be present, and the '<tt>algorithm</tt>' field
specifies the type of the key pair the client is expected to use.</t>
          </li>
          <li>
            <t>The '<tt>subjectPublicKey</tt>' field contained in <tt>SubjectPublicKeyInfoTemplate</tt>
has been made <tt>OPTIONAL</tt> because usually it is not needed.
In case the server requires use of an RSA key and needs to specify its size, the field
MUST be present and contain a placeholder public key value of the desired RSA modulus length.
Otherwise, the <tt>subjectPublicKey</tt> MUST be absent.</t>
          </li>
        </ul>
        <artwork><![CDATA[
  SubjectPublicKeyInfoTemplate{PUBLIC-KEY:IOSet} ::= SEQUENCE {
      algorithm        AlgorithmIdentifier{PUBLIC-KEY, {IOSet}},
      subjectPublicKey BIT STRING OPTIONAL
  }
]]></artwork>
        <ul spacing="normal">
          <li>
            <t>A new OID <tt>id-aa-extensionReqTemplate</tt> and the related <tt>ExtensionTemplate</tt> structure
is defined where the '<tt>extnValue</tt>' field has been made <tt>OPTIONAL</tt>.
This is only needed to enable specifying partial extensions with values to be filled in
by the client; otherwise the <tt>id-ExtensionReq</tt> OID and the respective value of type
<tt>ExtensionReq</tt> MUST be used for specifying requirements on X.509 extensions.</t>
          </li>
        </ul>
        <t>For each extension of type <tt>Extension</tt> or <tt>ExtensionTemplate</tt> provided by the server,
the client is expected to include an extension of the type given by the <tt>extnID</tt>.
If the '<tt>critical</tt>' field is present, the client SHOULD use it in the extension as well.
If the '<tt>extnValue</tt>' is present (which is always the case when type <tt>Extension</tt> is used),
the client SHOULD use the given extension value in its CSR.
When the type <tt>ExtensionTemplate</tt> is used, the '<tt>extnValue</tt>' can be absent, and then the client SHOULD provide an extension value in an <tt>Extension</tt> with the given <tt>extnID</tt>.
For instance, if the server includes an <tt>ExtensionTemplate</tt>
with the <tt>extnID</tt> '<tt>subjectAltName</tt>' but without an <tt>extnValue</tt>,
the client SHOULD include a SAN extension with a suitable value.</t>
        <t>In case the server includes an <tt>ExtensionTemplate</tt> with the <tt>extnID</tt> '<tt>subjectAltName</tt>'
and a partially filled in <tt>extnValue</tt>, such as a '<tt>directoryName</tt>' choice containing the <tt>NULL-DN</tt>
(i.e., an empty sequence of RDNs) or the '<tt>iPAddress</tt>' choice with an empty <tt>OCTET STRING</tt>,
this means that the client SHOULD fill in the respective <tt>GeneralName</tt> value.</t>
        <artwork><![CDATA[
  ExtensionTemplate {EXTENSION:ExtensionSet} ::= SEQUENCE {
     extnID      EXTENSION.&id({ExtensionSet}),
     critical    BOOLEAN DEFAULT FALSE,
     extnValue   OCTET STRING (CONTAINING
                 EXTENSION.&ExtnType({ExtensionSet}{@extnID})) OPTIONAL
                 --  contains the DER encoding of the ASN.1 value
                 --  corresponding to the extension type identified
                 --  by extnID when present
  }
]]></artwork>
        <t>The '<tt>version</tt>' field of the <tt>CertificationRequestInfoTemplate</tt> MUST contain v1 (0).</t>
        <t>The '<tt>attributes</tt>' field MUST NOT contain multiple <tt>id-aa-extensionReqTemplate</tt> attributes
and MUST NOT contain both <tt>id-ExtensionReq</tt> and <tt>id-aa-extensionReqTemplate</tt> attributes.</t>
        <t>The '<tt>values</tt>' field of an <tt>id-aa-extensionReqTemplate</tt> attribute
MUST contain a set with exactly one element,
and this element MUST be of type <tt>ExtensionTemplate</tt>.</t>
        <!--
Each of the attributes has a single attribute value instance in the
values set.  Even though the syntax is defined as a set, there MUST
be exactly one instance of AttributeValue present.
-->

<t>Suppose the server requires that the CSR will contain:</t>
        <ul spacing="normal">
          <li>
            <t>the '<tt>subject</tt>' field with a common name to be filled in by the EE and
two organizational unit names with given values "myDept" and "myGroup",</t>
          </li>
          <li>
            <t>the '<tt>publicKey</tt>' field contains an
Elliptic Curve Cryptography (ECC) key on curve <tt>secp256r1</tt>,</t>
          </li>
          <li>
            <t>the '<tt>subjectAltName</tt>' extension
with DNS name "www.myServer.com" and an empty IP address to be filled in,</t>
          </li>
          <li>
            <t>the '<tt>keyUsage</tt>' extension marked critical
with the value digitalSignature and keyAgreement, and</t>
          </li>
          <li>
            <t>the '<tt>extKeyUsage</tt>' extension with value to be filled in by the EE.</t>
          </li>
        </ul>
        <t>Then the <tt>CertificationRequestInfo</tt> structure constructed by the server
will be as follows:</t>
        <artwork><![CDATA[
SEQUENCE {
  INTEGER 0
  SEQUENCE {
    SET {
      SEQUENCE {
        OBJECT IDENTIFIER commonName (2 5 4 3)
        }
      }
    SET {
      SEQUENCE {
        OBJECT IDENTIFIER organizationalUnitName (2 5 4 11)
        UTF8String "myDept"
        }
      }
    SET {
      SEQUENCE {
        OBJECT IDENTIFIER organizationalUnitName (2 5 4 11)
        UTF8String "myGroup"
        }
      }
    }
  [0] {
    SEQUENCE {
      OBJECT IDENTIFIER ecPublicKey (1 2 840 10045 2 1)
      OBJECT IDENTIFIER secp256r1 (1 2 840 10045 3 1 7)
      }
    }
  [1] {
    SEQUENCE {
      OBJECT IDENTIFIER id-extensionReqTemplate
                        (1 2 840 113549 1 9 TBD3)
      SET {
        SEQUENCE {
          SEQUENCE {
            OBJECT IDENTIFIER subjectAltName (2 5 29 17)
            OCTET STRING, encapsulates {
              SEQUENCE {
                [2] "www.myServer.com"
                [7] ""
                }
              }
            }
          SEQUENCE {
            OBJECT IDENTIFIER keyUsage (2 5 29 15)
            BOOLEAN TRUE
            OCTET STRING, encapsulates {
              BIT STRING 3 unused bits
                "10001"B
              }
            }
          SEQUENCE {
            OBJECT IDENTIFIER extKeyUsage (2 5 29 37)
            }
          }
        }
      }
    }
  }
]]></artwork>
      </section>
    </section>
    <section anchor="co-existence-with-existing-implementations">
      <name>Co-existence with existing implementations</name>
      <t>EST servers with legacy clients MAY continue to use the <xref target="RFC7030"/>-style unstructured list of attribute/value pairs,
and MAY also include the template style described in <xref target="csrtemplate"/> for newer clients.
Clients which understand both MUST use the template only, and
ignore all other <tt>CSRattrs</tt> elements.
Older clients will ignore the new CertificationRequestInfoTemplate element.</t>
    </section>
    <section anchor="examples">
      <name>Examples using the original RFC 7030 approach</name>
      <t>Each example has a high-level (English) explanation of what is expected.
Some mapping back to the Attribute and Extension definitions above are included.
The base64 DER encoding is then shown.
The output of "dumpasn1" <xref target="dumpasn1"/> is then provided to detail what the contents are.</t>
      <section anchor="acpNodeName">
        <name>Require an RFC8994/ACP subjectAltName with specific otherName</name>
        <t>A single subjectAltName extension is specified in a single <xref target="RFC7030"/> <tt>CsrAttrs</tt>
attribute with OID '<tt>id-ExtensionReq</tt>' indicating type <tt>Extensions</tt>.
This is what might be created by an <xref target="RFC8995"/> Registrar that is asking for <xref target="RFC8994"/> AcpNodeName with format '<tt>otherNames</tt>'.</t>
        <section anchor="base64-encoded-example">
          <name>Base64 encoded example</name>
          <t>The Base64:</t>
          <sourcecode type="base64" markers="false"><![CDATA[
MGgwZgYJKoZIhvcNAQkOMVkwVzBVBgNVHREBAf8ESzBJoEcG
CCsGAQUFBwgKoDsWOXJmYzg5OTQrZmQ3MzlmYzIzYzM0NDAx
MTIyMzM0NDU1MDAwMDAwMDArQGFjcC5leGFtcGxlLmNvbQ==
]]></sourcecode>
        </section>
        <section anchor="asn1-dump-output">
          <name>ASN.1 DUMP output</name>
          <t>There is a single subjectAltName Extension with an Attribute with Extension type.</t>
          <artwork><![CDATA[
    <30 68>
  0 104: SEQUENCE {
    <30 66>
  2 102:   SEQUENCE {
    <06 09>
  4   9:     OBJECT IDENTIFIER
       :       extensionRequest (1 2 840 113549 1 9 14)
       :       (PKCS #9 via CRMF)
    <31 59>
 15  89:     SET {
    <30 57>
 17  87:       SEQUENCE {
    <30 55>
 19  85:         SEQUENCE {
    <06 03>
 21   3:           OBJECT IDENTIFIER
       :             subjectAltName (2 5 29 17)
       :             (X.509 extension)
    <01 01>
 26   1:           BOOLEAN TRUE
    <04 4B>
 29  75:           OCTET STRING, encapsulates {
    <30 49>
 31  73:             SEQUENCE {
    <A0 47>
 33  71:               [0] {
    <06 08>
 35   8:                 OBJECT IDENTIFIER '1 3 6 1 5 5 7 8 10'
    <A0 3B>
 45  59:                 [0] {
    <16 39>
 47  57:                   IA5String
       :                   'rfc8994+fd739fc23c3440112233445500000000+@acp.ex'
       :                   'ample.com'
       :                   }
       :                 }
       :               }
       :             }
       :           }
       :         }
       :       }
       :     }
       :   }
]]></artwork>
        </section>
      </section>
      <section anchor="rfc7030-original-example">
        <name>RFC7030 original example</name>
        <t>In this example, taken from <xref section="4.5.2" sectionFormat="comma" target="RFC7030"/>, a few different attributes are included.
The original encoding of the '<tt>macAddress</tt>' part in the example is NOT CORRECT.
It was not aligned with the definition of the Extension Request attribute as specified in <xref section="5.4.2" sectionFormat="of" target="RFC2985"/>.
The revised encoding given here does not use an '<tt>id-ExtensionReq</tt>' attribute
because the MAC Address is not an X.509 certificate extension by itself
and because the server provides its OID without a value,
which is not allowed syntactically within a structure of type '<tt>Extension</tt>'.</t>
        <section anchor="base64-encoded-example-1">
          <name>Base64 encoded example</name>
          <t>The Base64:</t>
          <sourcecode type="base64" markers="false"><![CDATA[
MDIGCSqGSIb3DQEJBzASBgcqhkjOPQIBMQcGBSuBBAAiBgcr
BgEBAQEWBggqhkjOPQQDAw==
]]></sourcecode>
        </section>
        <section anchor="asn1-dump-output-1">
          <name>ASN.1 DUMP output</name>
          <t>The CsrAttrs structure contains:</t>
          <ol spacing="normal" type="1"><li>
              <t>The challengePassword attribute is included to indicate that the
CSR should include this value.</t>
            </li>
            <li>
              <t>An ecPublicKey OID is provided with the value secp384r1 to
indicate what kind of public key should be submitted.</t>
            </li>
            <li>
              <t>The  macAddress OID 1.3.6.1.1.1.1.22 is included to
indicate that the CSR is expected to include
(in a subjectDirectoryAttributes extension) a MAC address value.</t>
            </li>
            <li>
              <t>The ecdsaWithSHA384 OID is included to indicate what kind of hash
is expected to be used for the self-signature in the PKCS#10 CSR.</t>
            </li>
          </ol>
          <artwork><![CDATA[
    <30 32>
  0  50: SEQUENCE {
    <06 09>
  2   9:   OBJECT IDENTIFIER challengePassword (1 2 840 113549 1 9 7)
       :     (PKCS #9)
    <30 12>
 13  18:   SEQUENCE {
    <06 07>
 15   7:     OBJECT IDENTIFIER ecPublicKey (1 2 840 10045 2 1)
       :       (ANSI X9.62 public key type)
    <31 07>
 24   7:     SET {
    <06 05>
 26   5:       OBJECT IDENTIFIER secp384r1 (1 3 132 0 34)
       :         (SECG (Certicom) named elliptic curve)
       :       }
       :     }
    <06 07>
 33   7:   OBJECT IDENTIFIER '1 3 6 1 1 1 1 22'
    <06 08>
 42   8:   OBJECT IDENTIFIER ecdsaWithSHA384 (1 2 840 10045 4 3 3)
       :     (ANSI X9.62 ECDSA algorithm with SHA384)
       :   }
]]></artwork>
        </section>
      </section>
      <section anchor="require-a-specific-subjectaltname-extension">
        <name>Require a specific subjectAltName extension</name>
        <t>This example is the same as the previous one except that instead of the OID
for a macAddress, a subjectAltName is specified as the only Extension element.</t>
        <section anchor="base64-encoded-example-2">
          <name>Base64 encoded example</name>
          <t>The Base64:</t>
          <sourcecode type="base64" markers="false"><![CDATA[
MEUGCSqGSIb3DQEJBzASBgcqhkjOPQIBMQcGBSuBBAAjBgkq
hkiG9w0BCRQGCgmSJomT8ixkAQUGA1UEBQYIKoZIzj0EAwQ=
]]></sourcecode>
        </section>
        <section anchor="asn1-dump-output-2">
          <name>ASN.1 DUMP output</name>
          <t>The CsrAttrs structure contains:</t>
          <ol spacing="normal" type="1"><li>
              <t>The challengePassword attribute is included to indicate that the CSR should include this value.</t>
            </li>
            <li>
              <t>An ecPublicKey OID is provided with the value secp521r1 to indicate what kind of public key should be submitted.</t>
            </li>
            <li>
              <t>An extensionRequest container with a subjectAltName value containing the name potato@example.com</t>
            </li>
            <li>
              <t>The ecdsaWithSHA512 OID is included to indicate the SHA-512 hash is expected to be used for the self-signature in the PKCS#10 CSR.</t>
            </li>
          </ol>
          <artwork><![CDATA[
    <30 45>
  0  69: SEQUENCE {
    <06 09>
  2   9:   OBJECT IDENTIFIER challengePassword (1 2 840 113549 1 9 7)
       :     (PKCS #9)
    <30 12>
 13  18:   SEQUENCE {
    <06 07>
 15   7:     OBJECT IDENTIFIER ecPublicKey (1 2 840 10045 2 1)
       :       (ANSI X9.62 public key type)
    <31 07>
 24   7:     SET {
    <06 05>
 26   5:       OBJECT IDENTIFIER secp521r1 (1 3 132 0 35)
       :         (SECG (Certicom) named elliptic curve)
       :       }
       :     }
    <06 09>
 33   9:   OBJECT IDENTIFIER friendlyName (for PKCS #12) (1 2 840 113549 1 9 20)
       :     (PKCS #9 via PKCS #12)
    <06 0A>
 44  10:   OBJECT IDENTIFIER '0 9 2342 19200300 100 1 5'
    <06 03>
 56   3:   OBJECT IDENTIFIER serialNumber (2 5 4 5)
       :     (X.520 DN component)
    <06 08>
 61   8:   OBJECT IDENTIFIER ecdsaWithSHA512 (1 2 840 10045 4 3 4)
       :     (ANSI X9.62 ECDSA algorithm with SHA512)
       :   }
]]></artwork>
        </section>
      </section>
      <section anchor="require-a-public-key-of-a-specific-size">
        <name>Require a public key of a specific size</name>
        <t>(TODO remove: Example ref Harkins01)</t>
        <t>The CSR requires an RSA public key of a specific size.</t>
        <section anchor="base64-encoded-example-3">
          <name>Base64 encoded example</name>
          <t>The Base64:</t>
          <sourcecode type="base64" markers="false"><![CDATA[
MCkGCSqGSIb3DQEJBzARBgkqhkiG9w0BAQExBAICEAAGCSqG
SIb3DQEBCw==
]]></sourcecode>
        </section>
        <section anchor="asn1-dump-output-3">
          <name>ASN.1 DUMP output</name>
          <t>Provide a CSR with an RSA key that's 4096 bits and use SHA256 as the hash algorithm within the signature.</t>
          <artwork><![CDATA[
    <30 29>
  0  41: SEQUENCE {
    <06 09>
  2   9:   OBJECT IDENTIFIER challengePassword (1 2 840 113549 1 9 7)
       :     (PKCS #9)
    <30 11>
 13  17:   SEQUENCE {
    <06 09>
 15   9:     OBJECT IDENTIFIER rsaEncryption (1 2 840 113549 1 1 1)
       :       (PKCS #1)
    <31 04>
 26   4:     SET {
    <02 02>
 28   2:       INTEGER 4096
       :       }
       :     }
    <06 09>
 32   9:   OBJECT IDENTIFIER sha256WithRSAEncryption
                             (1 2 840 113549 1 1 11)
       :     (PKCS #1)
       :   }
]]></artwork>
        </section>
      </section>
      <section anchor="require-a-public-key-of-a-specific-curve">
        <name>Require a public key of a specific curve</name>
        <t>(TODO remove: Example ref Harkins02)</t>
        <t>The CSR requires an ECC public key with a specific curve.</t>
        <section anchor="base64-encoded-example-4">
          <name>Base64 encoded example</name>
          <t>The Base64:</t>
          <sourcecode type="base64" markers="false"><![CDATA[
MC4GCSqGSIb3DQEJBzASBgcqhkjOPQIBMQcGBSuBBAAiBgNV
BAUGCCqGSM49BAMD
]]></sourcecode>
        </section>
        <section anchor="asn1-dump-output-4">
          <name>ASN.1 DUMP output</name>
          <t>Provide a CSR with an ECC key from p384, include your serial number, and
use SHA384 as the hash algorithm within the signature.</t>
          <artwork><![CDATA[
    <30 2E>
  0  46: SEQUENCE {
    <06 09>
  2   9:   OBJECT IDENTIFIER challengePassword (1 2 840 113549 1 9 7)
       :     (PKCS #9)
    <30 12>
 13  18:   SEQUENCE {
    <06 07>
 15   7:     OBJECT IDENTIFIER ecPublicKey (1 2 840 10045 2 1)
       :       (ANSI X9.62 public key type)
    <31 07>
 24   7:     SET {
    <06 05>
 26   5:       OBJECT IDENTIFIER secp384r1 (1 3 132 0 34)
       :         (SECG (Certicom) named elliptic curve)
       :       }
       :     }
    <06 03>
 33   3:   OBJECT IDENTIFIER serialNumber (2 5 4 5)
       :     (X.520 DN component)
    <06 08>
 38   8:   OBJECT IDENTIFIER ecdsaWithSHA384 (1 2 840 10045 4 3 3)
       :     (ANSI X9.62 ECDSA algorithm with SHA384)
       :   }
]]></artwork>
        </section>
      </section>
      <section anchor="require-specific-extensions-and-attributes">
        <name>Require specific extensions and attributes</name>
        <t>(TODO remove: Example ref Harkins03)</t>
        <t>The CSR is required to have an EC key, to include a serial number,
a friendly name, favorite drink <xref target="favoritedrink"/> [OID 0.9.2342.19200300.100.1.5], and
use SHA512 as the hash algorithm within the signature.</t>
        <section anchor="base64-encoded-example-5">
          <name>Base64 encoded example</name>
          <t>The Base64:</t>
          <sourcecode type="base64" markers="false"><![CDATA[
MEUGCSqGSIb3DQEJBzASBgcqhkjOPQIBMQcGBSuBBAAjBgkq
hkiG9w0BCRQGCgmSJomT8ixkAQUGA1UEBQYIKoZIzj0EAwQ=
]]></sourcecode>
        </section>
        <section anchor="asn1-dump-output-5">
          <name>ASN.1 DUMP output</name>
          <t>Provide a CSR with an EC key from sha521, include your serial number,
friendly name, and favorite drink, and hash it with SHA512.</t>
          <artwork><![CDATA[
    <30 45>
  0  69: SEQUENCE {
    <06 09>
  2   9:   OBJECT IDENTIFIER challengePassword (1 2 840 113549 1 9 7)
       :     (PKCS #9)
    <30 12>
 13  18:   SEQUENCE {
    <06 07>
 15   7:     OBJECT IDENTIFIER ecPublicKey (1 2 840 10045 2 1)
       :       (ANSI X9.62 public key type)
    <31 07>
 24   7:     SET {
    <06 05>
 26   5:       OBJECT IDENTIFIER secp521r1 (1 3 132 0 35)
       :         (SECG (Certicom) named elliptic curve)
       :       }
       :     }
    <06 09>
 33   9:   OBJECT IDENTIFIER friendlyName (for PKCS #12) (1 2 840 113549 1 9 20)
       :     (PKCS #9 via PKCS #12)
    <06 0A>
 44  10:   OBJECT IDENTIFIER '0 9 2342 19200300 100 1 5'
    <06 03>
 56   3:   OBJECT IDENTIFIER serialNumber (2 5 4 5)
       :     (X.520 DN component)
    <06 08>
 61   8:   OBJECT IDENTIFIER ecdsaWithSHA512 (1 2 840 10045 4 3 4)
       :     (ANSI X9.62 ECDSA algorithm with SHA512)
       :   }
]]></artwork>
        </section>
      </section>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>The security considerations from EST <xref target="RFC7030"/> section 6 are unchanged.</t>
      <section anchor="identity-and-privacy-considerations">
        <name>Identity and Privacy Considerations</name>
        <t>An EST server may use this mechanism to instruct the EST client about the identities it should include in the CSR it sends as part of enrollment.
The client may only be aware of its IDevID Subject, which includes a manufacturer serial number.
The EST server can use this mechanism to tell the client to include a specific fully qualified domain name in the CSR in order to complete domain ownership proofs required by the CA.
Additionally, the EST server may deem the manufacturer serial number in an IDevID as personally identifiable information, and may want to specify a new random opaque identifier that the pledge should use in its CSR.
This may be desirable if the CA and EST server have different operators.</t>
      </section>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>IANA is asked to allocate three new Object Identifiers:</t>
      <ul spacing="normal">
        <li>
          <t>One (TBD1) from the SMI Security for S/MIME Module Identifier
(1.2.840.113549.1.9.16.0) registry for the ASN.1 module: id-mod-critemplate; see <xref target="app-asn1-module"/></t>
        </li>
        <li>
          <t>One (TBD2) from the SMI Security for S/MIME Attributes
(1.2.840.113549.1.9.16.2) registry for the Certification Request
Information Template (id-aa-certificationRequestInfoTemplate) attribute; see <xref target="app-asn1-module"/></t>
        </li>
        <li>
          <t>One (TBD3) SMI Security for S/MIME Attributes
(1.2.840.113549.1.9.16.2) registry for the extension request
template (id-aa-extensionReqTemplate) attribute; see Appendix A</t>
        </li>
      </ul>
    </section>
    <section anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>Corey Bonnell crafted example02 using a different tool, and this helped debug other running code.</t>
      <t>Carl Wallace provided major parts of the CertificationRequestInfoTemplate syntax declaration.</t>
      <t>Russ Housley did many reviews of the ASN.1 and suggested many fixes.</t>
      <t>Deb Cooley did the usual Area Director Review.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="RFC5911">
          <front>
            <title>New ASN.1 Modules for Cryptographic Message Syntax (CMS) and S/MIME</title>
            <author fullname="P. Hoffman" initials="P." surname="Hoffman"/>
            <author fullname="J. Schaad" initials="J." surname="Schaad"/>
            <date month="June" year="2010"/>
            <abstract>
              <t>The Cryptographic Message Syntax (CMS) format, and many associated formats, are expressed using ASN.1. The current ASN.1 modules conform to the 1988 version of ASN.1. This document updates those ASN.1 modules to conform to the 2002 version of ASN.1. There are no bits-on-the-wire changes to any of the formats; this is simply a change to the syntax. This document is not an Internet Standards Track specification; it is published for informational purposes.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5911"/>
          <seriesInfo name="DOI" value="10.17487/RFC5911"/>
        </reference>
        <reference anchor="RFC5912">
          <front>
            <title>New ASN.1 Modules for the Public Key Infrastructure Using X.509 (PKIX)</title>
            <author fullname="P. Hoffman" initials="P." surname="Hoffman"/>
            <author fullname="J. Schaad" initials="J." surname="Schaad"/>
            <date month="June" year="2010"/>
            <abstract>
              <t>The Public Key Infrastructure using X.509 (PKIX) certificate format, and many associated formats, are expressed using ASN.1. The current ASN.1 modules conform to the 1988 version of ASN.1. This document updates those ASN.1 modules to conform to the 2002 version of ASN.1. There are no bits-on-the-wire changes to any of the formats; this is simply a change to the syntax. This document is not an Internet Standards Track specification; it is published for informational purposes.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5912"/>
          <seriesInfo name="DOI" value="10.17487/RFC5912"/>
        </reference>
        <reference anchor="RFC6268">
          <front>
            <title>Additional New ASN.1 Modules for the Cryptographic Message Syntax (CMS) and the Public Key Infrastructure Using X.509 (PKIX)</title>
            <author fullname="J. Schaad" initials="J." surname="Schaad"/>
            <author fullname="S. Turner" initials="S." surname="Turner"/>
            <date month="July" year="2011"/>
            <abstract>
              <t>The Cryptographic Message Syntax (CMS) format, and many associated formats, are expressed using ASN.1. The current ASN.1 modules conform to the 1988 version of ASN.1. This document updates some auxiliary ASN.1 modules to conform to the 2008 version of ASN.1; the 1988 ASN.1 modules remain the normative version. There are no bits- on-the-wire changes to any of the formats; this is simply a change to the syntax. This document is not an Internet Standards Track specification; it is published for informational purposes.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6268"/>
          <seriesInfo name="DOI" value="10.17487/RFC6268"/>
        </reference>
        <reference anchor="RFC7030">
          <front>
            <title>Enrollment over Secure Transport</title>
            <author fullname="M. Pritikin" initials="M." role="editor" surname="Pritikin"/>
            <author fullname="P. Yee" initials="P." role="editor" surname="Yee"/>
            <author fullname="D. Harkins" initials="D." role="editor" surname="Harkins"/>
            <date month="October" year="2013"/>
            <abstract>
              <t>This document profiles certificate enrollment for clients using Certificate Management over CMS (CMC) messages over a secure transport. This profile, called Enrollment over Secure Transport (EST), describes a simple, yet functional, certificate management protocol targeting Public Key Infrastructure (PKI) clients that need to acquire client certificates and associated Certification Authority (CA) certificates. It also supports client-generated public/private key pairs as well as key pairs generated by the CA.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7030"/>
          <seriesInfo name="DOI" value="10.17487/RFC7030"/>
        </reference>
        <reference anchor="X.680" target="https://www.itu.int/rec/T-REC-X.680">
          <front>
            <title>Information technology -- Abstract Syntax Notation One (ASN.1): Specification of basic notation</title>
            <author>
              <organization>ITU-T</organization>
            </author>
            <date year="2021" month="February"/>
          </front>
          <seriesInfo name="ITU-T Recommendation" value="X.680"/>
          <seriesInfo name="ISO/IEC" value="8824-1:2021"/>
        </reference>
        <reference anchor="X.690" target="https://www.itu.int/rec/T-REC-X.690">
          <front>
            <title>Information technology -- ASN.1 encoding rules: Specification of Basic Encoding Rules (BER), Canonical Encoding Rules (CER) and Distinguished Encoding Rules (DER)</title>
            <author>
              <organization>ITU-T</organization>
            </author>
            <date year="2021" month="February"/>
          </front>
          <seriesInfo name="ITU-T Recommendation" value="X.690"/>
          <seriesInfo name="ISO/IEC" value="8825-1:2021"/>
        </reference>
        <reference anchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <date month="March" year="1997"/>
            <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="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC8174">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <date month="May" year="2017"/>
            <abstract>
              <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="8174"/>
          <seriesInfo name="DOI" value="10.17487/RFC8174"/>
        </reference>
        <reference anchor="RFC2986">
          <front>
            <title>PKCS #10: Certification Request Syntax Specification Version 1.7</title>
            <author fullname="M. Nystrom" initials="M." surname="Nystrom"/>
            <author fullname="B. Kaliski" initials="B." surname="Kaliski"/>
            <date month="November" year="2000"/>
            <abstract>
              <t>This memo represents a republication of PKCS #10 v1.7 from RSA Laboratories' Public-Key Cryptography Standards (PKCS) series, and change control is retained within the PKCS process. The body of this document, except for the security considerations section, is taken directly from the PKCS #9 v2.0 or the PKCS #10 v1.7 document. This memo provides information for the Internet community.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="2986"/>
          <seriesInfo name="DOI" value="10.17487/RFC2986"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="RFC2985">
          <front>
            <title>PKCS #9: Selected Object Classes and Attribute Types Version 2.0</title>
            <author fullname="M. Nystrom" initials="M." surname="Nystrom"/>
            <author fullname="B. Kaliski" initials="B." surname="Kaliski"/>
            <date month="November" year="2000"/>
            <abstract>
              <t>This memo represents a republication of PKCS #9 v2.0 from RSA Laboratories' Public-Key Cryptography Standards (PKCS) series, and change control is retained within the PKCS process. The body of this document, except for the security considerations section, is taken directly from that specification. This memo provides information for the Internet community.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="2985"/>
          <seriesInfo name="DOI" value="10.17487/RFC2985"/>
        </reference>
        <reference anchor="RFC4211">
          <front>
            <title>Internet X.509 Public Key Infrastructure Certificate Request Message Format (CRMF)</title>
            <author fullname="J. Schaad" initials="J." surname="Schaad"/>
            <date month="September" year="2005"/>
            <abstract>
              <t>This document describes the Certificate Request Message Format (CRMF) syntax and semantics. This syntax is used to convey a request for a certificate to a Certification Authority (CA), possibly via a Registration Authority (RA), for the purposes of X.509 certificate production. The request will typically include a public key and the associated registration information. This document does not define a certificate request protocol. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4211"/>
          <seriesInfo name="DOI" value="10.17487/RFC4211"/>
        </reference>
        <reference anchor="RFC5272">
          <front>
            <title>Certificate Management over CMS (CMC)</title>
            <author fullname="J. Schaad" initials="J." surname="Schaad"/>
            <author fullname="M. Myers" initials="M." surname="Myers"/>
            <date month="June" year="2008"/>
            <abstract>
              <t>This document defines the base syntax for CMC, a Certificate Management protocol using the Cryptographic Message Syntax (CMS). This protocol addresses two immediate needs within the Internet Public Key Infrastructure (PKI) community:</t>
              <t>1. The need for an interface to public key certification products and services based on CMS and PKCS #10 (Public Key Cryptography Standard), and</t>
              <t>2. The need for a PKI enrollment protocol for encryption only keys due to algorithm or hardware design.</t>
              <t>CMC also requires the use of the transport document and the requirements usage document along with this document for a full definition. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5272"/>
          <seriesInfo name="DOI" value="10.17487/RFC5272"/>
        </reference>
        <reference anchor="RFC5280">
          <front>
            <title>Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile</title>
            <author fullname="D. Cooper" initials="D." surname="Cooper"/>
            <author fullname="S. Santesson" initials="S." surname="Santesson"/>
            <author fullname="S. Farrell" initials="S." surname="Farrell"/>
            <author fullname="S. Boeyen" initials="S." surname="Boeyen"/>
            <author fullname="R. Housley" initials="R." surname="Housley"/>
            <author fullname="W. Polk" initials="W." surname="Polk"/>
            <date month="May" year="2008"/>
            <abstract>
              <t>This memo profiles the X.509 v3 certificate and X.509 v2 certificate revocation list (CRL) for use in the Internet. An overview of this approach and model is provided as an introduction. The X.509 v3 certificate format is described in detail, with additional information regarding the format and semantics of Internet name forms. Standard certificate extensions are described and two Internet-specific extensions are defined. A set of required certificate extensions is specified. The X.509 v2 CRL format is described in detail along with standard and Internet-specific extensions. An algorithm for X.509 certification path validation is described. An ASN.1 module and examples are provided in the appendices. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5280"/>
          <seriesInfo name="DOI" value="10.17487/RFC5280"/>
        </reference>
        <reference anchor="RFC8295">
          <front>
            <title>EST (Enrollment over Secure Transport) Extensions</title>
            <author fullname="S. Turner" initials="S." surname="Turner"/>
            <date month="January" year="2018"/>
            <abstract>
              <t>The EST (Enrollment over Secure Transport) protocol defines the Well-Known URI (Uniform Resource Identifier) -- /.well-known/est -- along with a number of other path components that clients use for PKI (Public Key Infrastructure) services, namely certificate enrollment (e.g., /simpleenroll). This document defines a number of other PKI services as additional path components -- specifically, firmware and trust anchors as well as 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.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8295"/>
          <seriesInfo name="DOI" value="10.17487/RFC8295"/>
        </reference>
        <reference anchor="RFC8368">
          <front>
            <title>Using an Autonomic Control Plane for Stable Connectivity of Network Operations, Administration, and Maintenance (OAM)</title>
            <author fullname="T. Eckert" initials="T." role="editor" surname="Eckert"/>
            <author fullname="M. Behringer" initials="M." surname="Behringer"/>
            <date month="May" year="2018"/>
            <abstract>
              <t>Operations, Administration, and Maintenance (OAM), as per BCP 161, for data networks is often subject to the problem of circular dependencies when relying on connectivity provided by the network to be managed for the OAM purposes.</t>
              <t>Provisioning while bringing up devices and networks tends to be more difficult to automate than service provisioning later on. Changes in core network functions impacting reachability cannot be automated because of ongoing connectivity requirements for the OAM equipment itself, and widely used OAM protocols are not secure enough to be carried across the network without security concerns.</t>
              <t>This document describes how to integrate OAM processes with an autonomic control plane in order to provide stable and secure connectivity for those OAM processes. This connectivity is not subject to the aforementioned circular dependencies.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8368"/>
          <seriesInfo name="DOI" value="10.17487/RFC8368"/>
        </reference>
        <reference anchor="RFC8994">
          <front>
            <title>An Autonomic Control Plane (ACP)</title>
            <author fullname="T. Eckert" initials="T." role="editor" surname="Eckert"/>
            <author fullname="M. Behringer" initials="M." role="editor" surname="Behringer"/>
            <author fullname="S. Bjarnason" initials="S." surname="Bjarnason"/>
            <date month="May" year="2021"/>
            <abstract>
              <t>Autonomic functions need a control plane to communicate, which depends on some addressing and routing. This Autonomic Control Plane should ideally be self-managing and be as independent as possible of configuration. This document defines such a plane and calls it the "Autonomic Control Plane", with the primary use as a control plane for autonomic functions. It also serves as a "virtual out-of-band channel" for Operations, Administration, and Management (OAM) communications over a network that provides automatically configured, hop-by-hop authenticated and encrypted communications via automatically configured IPv6 even when the network is not configured or is misconfigured.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8994"/>
          <seriesInfo name="DOI" value="10.17487/RFC8994"/>
        </reference>
        <reference anchor="RFC8995">
          <front>
            <title>Bootstrapping Remote Secure Key Infrastructure (BRSKI)</title>
            <author fullname="M. Pritikin" initials="M." surname="Pritikin"/>
            <author fullname="M. Richardson" initials="M." surname="Richardson"/>
            <author fullname="T. Eckert" initials="T." surname="Eckert"/>
            <author fullname="M. Behringer" initials="M." surname="Behringer"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <date month="May" year="2021"/>
            <abstract>
              <t>This document specifies automated bootstrapping of an Autonomic Control Plane. To do this, a Secure Key Infrastructure is bootstrapped. This is done using manufacturer-installed X.509 certificates, in combination with a manufacturer's authorizing service, both online and offline. We call this process the Bootstrapping Remote Secure Key Infrastructure (BRSKI) protocol. Bootstrapping a new device can occur when using a routable address and a cloud service, only link-local connectivity, or limited/disconnected networks. Support for deployment models with less stringent security requirements is included. Bootstrapping is complete when the cryptographic identity of the new key infrastructure is successfully deployed to the device. The established secure connection can be used to deploy a locally issued certificate to the device as well.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8995"/>
          <seriesInfo name="DOI" value="10.17487/RFC8995"/>
        </reference>
        <reference anchor="RFC9480">
          <front>
            <title>Certificate Management Protocol (CMP) Updates</title>
            <author fullname="H. Brockhaus" initials="H." surname="Brockhaus"/>
            <author fullname="D. von Oheimb" initials="D." surname="von Oheimb"/>
            <author fullname="J. Gray" initials="J." surname="Gray"/>
            <date month="November" year="2023"/>
            <abstract>
              <t>This document contains a set of updates to the syntax of Certificate Management Protocol (CMP) version 2 and its HTTP transfer mechanism. This document updates RFCs 4210, 5912, and 6712.</t>
              <t>The aspects of CMP updated in this document are using EnvelopedData instead of EncryptedValue, clarifying the handling of p10cr messages, improving the crypto agility, as well as adding new general message types, extended key usages to identify certificates for use with CMP, and well-known URI path segments.</t>
              <t>CMP version 3 is introduced to enable signaling support of EnvelopedData instead of EncryptedValue and signal the use of an explicit hash AlgorithmIdentifier in certConf messages, as far as needed.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9480"/>
          <seriesInfo name="DOI" value="10.17487/RFC9480"/>
        </reference>
        <reference anchor="RFC9483">
          <front>
            <title>Lightweight Certificate Management Protocol (CMP) Profile</title>
            <author fullname="H. Brockhaus" initials="H." surname="Brockhaus"/>
            <author fullname="D. von Oheimb" initials="D." surname="von Oheimb"/>
            <author fullname="S. Fries" initials="S." surname="Fries"/>
            <date month="November" year="2023"/>
            <abstract>
              <t>This document aims at simple, interoperable, and automated PKI management operations covering typical use cases of industrial and Internet of Things (IoT) scenarios. This is achieved by profiling the Certificate Management Protocol (CMP), the related Certificate Request Message Format (CRMF), and transfer based on HTTP or Constrained Application Protocol (CoAP) in a succinct but sufficiently detailed and self-contained way. To make secure certificate management for simple scenarios and constrained devices as lightweight as possible, only the most crucial types of operations and options are specified as mandatory. More specialized or complex use cases are supported with optional features.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9483"/>
          <seriesInfo name="DOI" value="10.17487/RFC9483"/>
        </reference>
        <reference anchor="dumpasn1" target="https://www.cs.auckland.ac.nz/~pgut001/dumpasn1.c">
          <front>
            <title>Dump ASN</title>
            <author initials="P." surname="Gutmann" fullname="Peter Gutmann">
              <organization/>
            </author>
            <date>n.d.</date>
          </front>
        </reference>
        <reference anchor="favoritedrink" target="https://oid-base.com/get/0.9.2342.19200300.100.1.5">
          <front>
            <title>Favorite Drink: arbitrary OID</title>
            <author>
              <organization/>
            </author>
            <date>n.d.</date>
          </front>
        </reference>
      </references>
    </references>
    <?line 839?>

<section anchor="app-asn1-module">
      <name>ASN.1 Module</name>
      <aside>
        <t>RFC EDITOR: Please replace TBD1, TBD2, and TBD3 with the value assigned by IANA
during the publication of this document.</t>
      </aside>
      <t>This appendix provides an ASN.1 module <xref target="X.680"/> for the Certification
Request Information Template attribute, and it follows the conventions
established in <xref target="RFC5911"/>, <xref target="RFC5912"/>, and <xref target="RFC6268"/>.</t>
      <sourcecode type="asn.1"><![CDATA[
CRITemplateModule
  { iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1)
    pkcs-9(9) smime(16) modules(0) id-mod-critemplate(TBD1) }

DEFINITIONS IMPLICIT TAGS ::=

BEGIN

IMPORTS -- from [RFC5912]

SupportedAttributes
 FROM PKIX1Explicit-2009
  { iso(1) identified-organization(3) dod(6) internet(1) security(5)
    mechanisms(5) pkix(7) id-mod(0) id-mod-pkix1-explicit-02(51)}

ATTRIBUTE, EXTENSION
 FROM PKIX-CommonTypes-2009
  { iso(1) identified-organization(3) dod(6) internet(1) security(5)
    mechanisms(5) pkix(7) id-mod(0) id-mod-pkixCommon-02(57) }

PUBLIC-KEY, AlgorithmIdentifier{}
 FROM AlgorithmInformation-2009
  { iso(1) identified-organization(3) dod(6) internet(1) security(5)
    mechanisms(5) pkix(7) id-mod(0)
    id-mod-algorithmInformation-02(58)}

CertExtensions
 FROM PKIX1Implicit-2009
  { iso(1) identified-organization(3) dod(6) internet(1) security(5)
    mechanisms(5) pkix(7) id-mod(0) id-mod-pkix1-implicit-02(59)}

Attributes{}, CRIAttributes, PKInfoAlgorithms
 FROM PKCS-10
  { iso(1) identified-organization(3) dod(6) internet(1)
    security(5) mechanisms(5) pkix(7)
    id-mod(0) id-mod-pkcs10-2009(69) }
;

aa-certificationRequestInfoTemplate ATTRIBUTE ::=
  { TYPE CertificationRequestInfoTemplate IDENTIFIED BY
    id-aa-certificationRequestInfoTemplate }

id-aa-certificationRequestInfoTemplate OBJECT IDENTIFIER ::=
  { iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1) pkcs9(9)
    smime(16) aa(2) id-aa-certificationRequestInfoTemplate(TBD2) }

--  like CertificationRequestInfo but OPTIONAL subject, subjectPKInfo
CertificationRequestInfoTemplate ::= SEQUENCE {
    version       INTEGER { v1(0) } (v1, ... ),
    subject       NameTemplate OPTIONAL,
    subjectPKInfo [0] SubjectPublicKeyInfoTemplate
                              {{ PKInfoAlgorithms }} OPTIONAL,
    attributes    [1] Attributes{{ CRIAttributes }}
}


--  like Name, but with OPTIONAL RDN values
NameTemplate ::= CHOICE { -- only one possibility for now --
    rdnSequence  RDNSequenceTemplate }

RDNSequenceTemplate ::= SEQUENCE OF RelativeDistinguishedNameTemplate

RelativeDistinguishedNameTemplate  ::= SET SIZE (1 .. MAX)
    OF SingleAttributeTemplate { {SupportedAttributes} }

--  like Attributes, but with OPTIONAL value
SingleAttributeTemplates{ATTRIBUTE:AttrSet} ::= SEQUENCE OF
    SingleAttributeTemplates{ {AttrSet} }

--  like SingleAttribute, but with OPTIONAL value
SingleAttributeTemplate{ATTRIBUTE:AttrSet} ::= SEQUENCE {
    type      ATTRIBUTE.&id({AttrSet}),
    value     ATTRIBUTE.&Type({AttrSet}{@type}) OPTIONAL
}

--  like SubjectPublicKeyInfo, but with OPTIONAL subjectPublicKey
SubjectPublicKeyInfoTemplate{PUBLIC-KEY:IOSet} ::= SEQUENCE {
    algorithm        AlgorithmIdentifier{PUBLIC-KEY, {IOSet}},
    subjectPublicKey BIT STRING OPTIONAL
}

id-aa-extensionReqTemplate OBJECT IDENTIFIER ::=
{ iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1) pkcs9(9)
  smime(16) aa(2) id-aa-extensionReqTemplate(TBD3) }

--  like extensionRequest, but with OPTIONAL Extension extnValues
--  original definition was in PKCS#9 RFC 2985 section 5.4.2
at-extensionReqTemplate ATTRIBUTE ::= {
    TYPE ExtensionReqTemplate IDENTIFIED BY id-aa-extensionReqTemplate }

ExtensionReqTemplate ::= ExtensionTemplates{{CertExtensions}}

--  like Extensions, but with OPTIONAL extnValue
ExtensionTemplates{EXTENSION:ExtensionSet} ::=
    SEQUENCE SIZE (1..MAX) OF ExtensionTemplate{{ExtensionSet}}

--  like Extension, but with OPTIONAL extnValue
ExtensionTemplate{EXTENSION:ExtensionSet} ::= SEQUENCE {
    extnID    EXTENSION.&id({ExtensionSet}),
    critical  BOOLEAN
  --                   (EXTENSION.&Critical({ExtensionSet}{@extnID}))
                     DEFAULT FALSE,
    extnValue OCTET STRING (CONTAINING
              EXTENSION.&ExtnType({ExtensionSet}{@extnID})) OPTIONAL
              --  contains the DER encoding of the ASN.1 value
              --  corresponding to the extension type identified
              --  by extnID when present
}

END
]]></sourcecode>
      <!--
Local IspellDict: american
LocalWords:  abbrev CSRAttrs docname ietf rfc csrattrs ipr wg pkcs
LocalWords:  submissionType kw std toc sortrefs symrefs org mcr
LocalWords:  seriesinfo bcp crypto CsrAttrs AttrOrOID IOSet asn
LocalWords:  csrtemplate pKCS CertificationRequestInfoTemplate
LocalWords:  NameTemplate subjectPKInfo PKInfoAlgorithms br acp
LocalWords:  SubjectPublicKeyInfoTemplate AttrSet ExtensionSet
LocalWords:  SingleAttributeTemplate extensionReqTemplate secp
LocalWords:  ExtensionTemplate ExtnType myDept myGroup CSRattrs
LocalWords:  publicKey dumpasn otherName acpNodeName otherNames
LocalWords:  AcpNodeName sourcecode csrattr ecdsaWithSHA sha
LocalWords:  harkins critemplate csrinfo Changelog markdown
LocalWords:  CRITemplateModule ExtensionReq
-->

</section>
  </back>
  <!-- ##markdown-source:
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
pyS/0z0d3SjMR8gyxAGP95HeBUubpKkZ5KBJg7oJ/HuxMe6RSNcokMajsOjN
WMN4SGa0Wg1JxYi26TPRRxWxjhA93CnC3UO058lmUuY2ZmTFEc55XLW4dyWN
FHp0Y2m2IOQLprBdhmwBLfbI9Q1uO/Iuq0yoXScy9vX0vMSaq6iq9ju4u6/c
gN5l1QBiO3JQnMt5UBd1qzIij5rcACYg8CMd7pEBWdy54K4zUWbBMUWVr2TC
lpVjjzqiiTcxwliuBERAk23ENOVjSvjfi0AK2wxhyrYqiCmpjnhaMHWBZ7nY
eAHn4lP5cJ8wMUr5N4o/yv3UNKdjHrtjFeOX4ClPKt3YNrijuGqQPB+l35RZ
pmUlYqexiNYi2YyfU5djaxu64CI3olbpSsQhaAs1ztQ26gDtrNQ3cScwlspd
UmRo4e4iUlRKgcx3kcENbuVzDBVZmJJ+VMCSVmceh5gnYsRROE0JTIL/RByI
Q5MOBsMH8wqyeW7pKP6xgcRNwSs55Bk8Pl7fnr4ZdGvf93/mgf8tTKLoQZoj
StsNZCgvMfqqMhHUfypaQxIIpg3nPK9IVumQPYoRDIxtO04uAK3IQJFsgioG
UKcDu7qNihVYgfZe1hSe5tSuQnovYkaenkABbU5RSBh+RLEbQ1IJu9YI9EvH
nu8L5n11SyS4cf75oiBgN8L7hBg9d6VKNDlhRG6cf0YSCOVG0R6DhrYoMko2
KcBJ59lG2qfZDKfzQFrJIghV6eUz+bguLBcaMgyK/lJuRCl/uHYS/Y15FFRr
7N2xjOiqVc0rQzWu2PrX2Vz5uC+QwtoPQ6Njk150n6yig77hmmfP+FzS0A7l
BqYCEjfeXg4JBjBaAxe9SJGLSpucFPRVOClDvRinWgK9SCbkIkMpgKgEO4ap
UwINXDVnpsxXDr5eG6Qh8CcyPEBULegvM4RUMg1tE8vutCoR+V8wIbABaHSR
gWdMtgzLisTYsHNpzEvE2FVIVpgvZZrjA1Czl0DNIwelnrA5AWMzfXfsAbe6
WZw8iIm78zhw/WIEeHx5++ZNrXc5tipB3a9XdfDB3JXgNriw73bHwXWHp0To
bvPxqXzgQsVzygxLgWjTFjTE1ficdu1DmoPCslRcG9hkj/2fRv3LIcjiE3Vz
q9Iyd9PUc9y0yz0s7buXbqtt21Njle7V5agzuCzdXzMggNEjbjbm4Hj8hkP8
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
dGlLK4xnKq6Xf3YjCJVTKFQx7P8BwB9YrPOGAAA=

-->

</rfc>
