Internet-Draft | PKIX Evidence for Remote Attestation of | October 2025 |
Ounsworth, et al. | Expires 13 April 2026 | [Page] |
This document specifies a vendor-agnostic format for evidence produced and verified within a PKIX context. The evidence produced this way includes claims collected about a cryptographic module and elements found within it such as cryptographic keys.¶
One scenario envisaged is that the state information about the cryptographic module can be securely presented to a remote operator or auditor in a vendor-agnostic verifiable format. A more complex scenario would be to submit this evidence to a Certification Authority to aid in determining whether the storage properties of this key meet the requirements of a given certificate profile.¶
This specification also offers a format for requesting a cryptographic module to produce evidence tailored for expected use.¶
This note is to be removed before publishing as an RFC.¶
The latest revision of this draft can be found at https://ietf-rats-wg.github.io/key-attestation/draft-ietf-rats-pkix-key-attestation.html. Status information for this document may be found at https://datatracker.ietf.org/doc/draft-ietf-rats-pkix-key-attestation/.¶
Discussion of this document takes place on the RATS Working Group mailing list (mailto:rats@ietf.org), which is archived at https://datatracker.ietf.org/wg/rats/about/. Subscribe at https://www.ietf.org/mailman/listinfo/rats/.¶
Source for this draft and an issue tracker can be found at https://github.com/ietf-rats-wg/key-attestation.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 13 April 2026.¶
Copyright (c) 2025 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
This specification defines a format to transmit Evidence from an Attester to a Verifier within a PKIX environment. This environment refers to the components generally used to support PKI applications such as Certification Authorities and their clients, or more generally that rely upon X.509 certificates. As outlined in Section 3, this specification uses a necessary mixture of RATS and PKI terminology in order to map concepts between the two domains.¶
Within this specification, the concepts found in the Remote Attestation Procedures (RATS [RFC9334]) are mapped to the PKIX environment. There are many other specifications that are based on the RATS architecture which offer formats to carry evidence. This specification deals with peculiar aspects of the PKIX environment which make the existing evidence formats inappropriate:¶
ASN.1 is the preferred encoding format in this environment. X.509 certificates ([RFC5280]) are used widely within this environment and the majority of tools are designed to support ASN.1. There are many specialized devices (Hardware Security Modules) that are inflexible in adopting other formats because of internal constraints or validation difficulties. This specification defines the format in ASN.1 to ease the adoption within the community.¶
The claims reported within the generated Evidence is generally a small subset of all possible claims about the Target Environment. The claims relate to elements such as "platform" and "keys" which are more numerous than what a Verifier requires for a specific function. This specification provides the means to moderate the information disseminated as part of the generated Evidence.¶
This specification also aims at providing an extensible framework to encode within Evidence claims other than the one proposed in this document. This allows implementations to introduce new claims and their associated semantics to the Evidence produced.¶
This section covers use cases that motivated the development of this specification.¶
There are situations where it is necessary to verify the current running state of an HSM as part of operational or auditing procedures. For example, there are devices that are certified to work in an environment only if certain versions of the firmware are loaded or only if user keys are protected with specific policies.¶
The Evidence format offered by this specification allows a platform to report its firmware level along with other collected claims necessary in critical deployments.¶
Consider that an HSM is being added to a logical HSM cluster. Part of the onboarding process could involve the newly-added HSM providing proof of its running state, for example that it is a genuine device from the same manufacturer as the existing clustered HSMs, firmware patch level, FIPS mode, etc. It could also be required to provide attestation of any system-level keys required for secure establishment of cluster communication. In this scenario, the Verifier and Relying Party will be the other HSMs in the cluster deciding whether or not to admit the new HSM.¶
A related scenario is when performing a key export-import across HSMs. If the key is being imported with certain properties, for example an environment running in FIPS mode at FIPS Level 3, and the key is set to certain protection properties such as Non-Exportable and Dual-Control, then the HSM might wish to verify that the key was previously stored under the same properties. This specification provides an Evidence format with sufficient details to support this type of implementation across HSM vendors.¶
These scenarios motivate the design requirements to have an ASN.1 based Evidence format and a data model that more closely matches typical HSM architecture since, as shown in both scenarios, an HSM is acting as Verifier and Relying Party.¶
Prior to a Certification Authority (CA) issuing a certificate on behalf of a subject, a number of procedures are required to verify that the subject of the certificate is associated with the key that is certified. In some cases, such as issuing a code signing certificate [CNSA2.0] [CSBR], a CA must ensure that the subject key is located in a Hardware Security Module (HSM).¶
The Evidence format offered by this specification is designed to carry the information necessary for a CA to assess the location of the subject key along a number of commonly-required attributes. More specifically, a CA could determine which HSM was used to generate the subject key, whether this device adheres to certain jurisdiction policies (such as FIPS mode) and the constraints applied to the key (such as whether is it extractable).¶
For relatively simple HSM devices, storage properties such as "extractable" may always be false for all keys since the devices are not capable of key export and so the attestation could be essentially a hard-coded template asserting these immutable attributes. However, more complex HSM devices require a more complex evidence format that encompasses the mutability of these attributes.¶
Also, a client requesting a key attestation might wish to scope-down the content of the produced Evidence as the HSM contains much more information than that which is relevant to the transaction. The inability to scope-down the generated Evidence could, in some scenarios, constitute a privacy violation.¶
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 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
This specification uses a necessary mixture of RATS and PKI terminology in order to map concepts between the two domains.¶
The reader is assumed to be familiar with the vocabulary and concepts defined in the RATS architecture ([RFC9334]) such as Attester, Relying Party, Verifier.¶
The reader is assumed to be familiar with common vocabulary and concepts defined in [RFC5280] such as certificate, signature, attribute, verifier.¶
In order to avoid confusion, this document generally capitalizes RATS terms such as Attester, Relying Party, and Claim. Therefore, for example, a "Verifier" should be assumed to be an entity that checks the validity of Evidence as per [RFC9334], whereas a "verifier" could be a more general reference to a PKI entity that checks the validity of an X.509 certificate or other digital signature as per [RFC5280].¶
The following terms are used in this document:¶
Cryptographic key controlled solely by the Attester and used only for the purpose of producing Evidence. In other words, it is used to digitally sign the claims collected by the Attester.¶
A logical module within the HSM that is responsible for generating Evidence compatible with the format outlined in this specification. It collects claims from the platform and uses the Attestation Key to digitally sign the collection.¶
The term Attester respects the definition offered in [RFC9334]. In this specification, it is also interchangeable with "platform" or "HSM".¶
The term Evidence respects the definition offered in [RFC9334]. In this specification, it refers to claims, encoded according to the format defined within this document, and signed using the Attestation Key.¶
A physical computing device that safeguards and manages secrets, such as cryptographic keys, and performs cryptographic operations based on those secrets. This specification takes a broad definition of what counts as an HSM to include smartcards, USB tokens, TPMs, cryptographic co-processors (PCI cards) and "enterprise-grade" or "cloud-service grade" HSMs (possibly rack mounted). In this specification, it is interchangeable with "platform" or "Attester".¶
Process of producing Evidence containing claims pertaining to user keys found within an HSM. In general, the claims include enough information about a user key and its hosting platform to allow a Relying Party to make judicious decisions about the key, such as whether to issue a certificate for the key.¶
Remote ATtestation procedureS. In this document, refers to the RATS Architecture as introduced in [RFC9334]. RATS and RATS Architecture are used interchangeably.¶
The module or device that embodies the Attester. In this specification, it is interchangeable with "Attester" or "HSM".¶
Evidence containing claims pertaining to attributes associated with the platform itself. In general, the claims include enough information about the platform to allow a Relying Party to make judicious decisions about the platform, such as those carried out during audit reviews.¶
Role that facilitates communication between the Attester and the Verifier. The Presenter initiates the operation of generating evidence at the Attester and passes the generated evidence to the Verifier. In the case of HSMs, the Presenter is responsible of selecting the claims that are part of the generated evidence.¶
As defined in [RFC6024] and [RFC9019], a Trust Anchor "represents an authoritative entity via a public key and associated data. The public key is used to verify digital signatures, and the associated data is used to constrain the types of information for which the trust anchor is authoritative." The Trust Anchor may be a certificate, a raw public key, or other structure, as appropriate.¶
A tamper-resistant processor generally located on a computer's motherboard used to enhance attestation functions for the hosting platform. TPMs are very specialized Hardware Security Modules and generally use other protocols (than the one presented in this specification) to transmit evidence.¶
A user key consists of a key hosted by an HSM (the platform) and intended to be used by a client of the HSM. Other terms used for a user key are "application key", "client key" or "operational key". The access and operations on a user key is controlled by the HSM.¶
[RFC9334] states that Evidence is made up of claims and that a claim is "a piece of asserted information, often in the form of a name/value pair". The RATS Architecture also mentions the concept of "measurements" that "can describe a variety of attributes of system components, such as hardware, firmware, BIOS, software, etc., and how they are hardened."¶
Some HSMs have a large amount of memory and can therefore contain a substantial amount of elements that can be observed independently by the Attestation Service. Each of those elements, in turn, can contain a number of measurable attributes.¶
A certain level of complexity arises as multiple elements of the same class can be observed while generating Evidence. In that case, the "name" of the claim must also include the "address" of the element.¶
To that end, in this specification, the claims are organized as tuples of "entity", "attribute" and "value":¶
the entity represents the encapsulation of an element as a set of attributes;¶
the attribute represents one property of the entity, which can be repeated to other entities of the same class; and,¶
the value is the actual measurement performed by the Attestation Service.¶
Therefore, each entity is a collection of claims, where the "name/value" pair represents one attribute and its measured value for an entity.¶
The grouping of claims into entities facilitates the comprehension of a large addressable space into elements recognizable by the user. More importantly, it curtails the produced Evidence to portions of the Target Environment that relate to the needs of the Verifier. See Section 10.4.¶
The data format in this specification represents PKIX evidence and requires third-party endorsement in order to establish trust. Part of this endorsement is a trust anchor that chains to the HSM's attestation key (AK) which signs the evidence. In practice the trust anchor will usually be a manufacturing CA belonging to the device vendor which proves that the device is genuine and not counterfeit. The trust anchor can also belong to the device operator as would be the case when the AK certificate is replaced as part of onboarding the device into a new operational network.¶
The AK certificate that signs the evidence MUST have the Extended Key Usage
id-kp-attest
, as defined in [I-D.jpfiset-lamps-attestationkey-eku], set.¶
Note that the data format specified in Section 5 allows for zero, one, or multiple 'SignatureBlock's, so a single evidence statement could be un-protected, or could be endorsed by multiple AK chains leading to different trust anchors. See Section 6 for a discussion of handling multiple SignatureBlocks.¶
The PKIX Evidence format is composed of two main sections:¶
A claim description section which describes the information transmitted as Evidence.¶
A signature section where one or more digital signatures are offered to prove the origin of the claims and maintain their integrity.¶
The details of the signature section is left to the data model. The remainder of this section deals with the way the information is organized to form the claims.¶
The claims are organized into a set of entities to help with the organization and comprehension of the information. Entities are elements observed in the Target Environment by the Attester. Each entity, in turn, is associated with a set of attributes.¶
Therefore, the Claim description section is a set of entities and each entity is composed of a set of attributes.¶
An entity is a logical construct that refers to a portion of the Target Environment's state. It is addressable via an identifier such as a UUID or a handle (as expressed in [PKCS11]). In general, an entity refers to a component recognized by users of the HSM, such as a key or the platform itself.¶
An entity is composed of a type, the entity type, and a set of attributes. The entity type describes the class of the entity while its attributes define its state.¶
An entity MUST be reported at most once in a claim description. The claim description can have multiple entities of the same type (for example reporting multiple keys), but each entity MUST relate to different portions of the Target Environment.¶
It is possible for two entities to be quite similar such as in a situation where a key is imported twice in a HSM. In this case, the two related entities could have similar attributes. However, they are treated as different entities as they are addressed differently.¶
The number of entities reported in a claim description, and their respective type, is left to the implementer. For a simple device where there is only one key, the list of reported entities could be fixed. For larger and more complex devices, the list of reported entities should be tailored to the demands of the Presenter.¶
In particular, note that the nonce attribute contained with the Transaction entity is optional, and therefore it is possible that an extremely simple device that holds one static key could have its key attestation object generated at manufacture time and injected statically into the device and act as a kind of certificate, instead of being generated on-demand. This model would essentially off-board the Target Environment to be part of the manufacturing infrastructure.¶
An entity is defined by its type. This specification defines three entity types:¶
Platform : This entity holds attributes relating to the state of the platform, or device, where the Attester is located. Entities of this type hold attributes that are global in nature within the Target Environment.¶
Key : The entities of this type represent a cryptographic key protected within the Target Environment and hold attributes relating to that key.¶
Transaction : This entity is logical in nature since it is associated with attributes that are not found in the Target Environment. The attributes found in this entity relate to the current request for Evidence such as a nonce to support freshness.¶
Although this document defines a short list of entity types, this list is extensible to allow implementers to report on entities found in their implementation and not covered by this specification. By using an Object Identifier (OID) for specifying entity types and attribute types, this format is inherently extensible; implementers of this specification MAY define new custom or proprietary entity types and place them alongside the standardized entities, or define new attribute types and place them inside standardized entities.¶
Verifiers SHOULD ignore and skip over unrecognized entity or attribute types and continue processing normally. In other words, if a given Evidence would have been acceptable without the unrecognized entities or attributes, then it SHOULD still be acceptable with them.¶
Each attribute found in an entity is composed of the attribute type and value. Each attribute describes a portion of the state of the associated entity. For example, a platform entity could have an attribute which indicates the firmware version currently running. Another example is a key entity with an attribute that reports whether the key is extractable or not.¶
A value provided by an attribute is to be interpreted within the context of its entity and in relation to the attribute type.¶
It is RECOMMENDED that an attribute type be defined for a specific entity type, to reduce confusion when it comes to interpretation of the value. In other words, an attribute type SHOULD NOT be used by multiple entity types. For example, if a concept of "revision" is applicable to a platform and a key, the attribute for one entity type (platform revision) should have a different identifier than the one for the other entity type (key revision).¶
The nature of the value (boolean, integer, string, bytes) is dependent on the attribute type.¶
This specification defines a limited set of attribute types. However, the list is extensible through the IANA registration process or private OID allocation, enabling implementers to report additional attributes not covered by this specification.¶
The number of attributes reported within an entity, and their respective type, is left to the implementer. For a simple device, the reported list of attributes for an entity might be fixed. However, for larger and more complex devices, the list of reported attributes should be tailored to the demands of the Presenter.¶
Some attributes MAY be repeated within an entity while others MUST NOT. For example, for a platform entity, there can only be one "firmware version" attribute. Therefore, the associated attribute MUST NOT be repeated as it may lead to confusion. However, an attribute relating to a "ak-spki" MAY be repeated, each attribute describing a different attesting key. Therefore, the definition of an attribute specifies whether or not multiple copies of that attribute are allowed.¶
If a Verifier encounters, within a single entity, multiple copies of an attribute specified as "Multiple Allowed: No", it MUST reject the evidence as malformed.¶
If a Verifier encounters, within the context of an entity, a repeated attribute for a type where multiple attributes are allowed, it MUST treat each one as an independent attribute and MUST NOT consider later ones to overwrite the previous one.¶
This section describes the data model associated with PKIX Evidence. For ease of deployment within the target ecosystem, ASN.1 definitions and DER encoding are used. A complete ASN.1 module is provided in Section 8.¶
The top-level structures, as ASN.1 snippets, are:¶
PkixEvidence ::= SEQUENCE { tbs TbsPkixEvidence, signatures SEQUENCE SIZE (0..MAX) OF SignatureBlock, intermediateCertificates [0] SEQUENCE OF Certificate OPTIONAL -- As defined in RFC 5280 } TbsPkixEvidence ::= SEQUENCE { version INTEGER, reportedEntities SEQUENCE SIZE (1..MAX) OF ReportedEntity } SignatureBlock ::= SEQUENCE { sid SignerIdentifier, signatureAlgorithm AlgorithmIdentifier, signatureValue OCTET STRING } SignerIdentifier ::= SEQUENCE { keyId [0] EXPLICIT OCTET STRING OPTIONAL, subjectKeyIdentifier [1] EXPLICIT SubjectPublicKeyInfo OPTIONAL, -- As defined in RFC 5280 certificate [2] EXPLICIT Certificate OPTIONAL -- As defined in RFC 5280 }¶
A PkixEvidence
message is composed of a protected section known as the To-Be-Signed (TBS) section where the evidence
reported by the HSM is assembled. The integrity of the TBS section is ensured with one or multiple cryptographic signatures
over the content of this section. There is a provision to carry X.509 certificates supporting each signature.
The SEQUENCE OF SignatureBlock
allows for both multi-algorithm protection and for counter-signatures
of the evidence.
In an effort to keep the evidence format simple, distinguishing between these two cases is left up to Verifier policy,
potentially by making use of the certificates that accompany each signature.¶
This design also does not prevent an attacker from removing, adding or re-ordering signatures without leaving evidence. This is discussed as part of the security considerations in Section 10.3.¶
The TBS section is composed of a version number, to ensure future extensibility, and a sequence of reported entities.
For compliance with this specification, TbsPkixEvidence.version
MUST be 1
.
This envelope format is not extensible; future specifications which make compatibility-breaking changes MUST increment the version number.¶
A SignatureBlock
is included for each signature submitted against the TBS section. The SignatureBlock
includes
the signature algorithm (signatureAlgorithm) and the signature itself (signatureValue). It also includes
information to identify the authority that provided the signature which is the structure SignerIdentifier
(sid).
The signer identifier includes a combination of X.509 certificate, SubjectPublicKeyInfo (SPKI) and/or
key identifier (keyId). It is expected that a X.509 certificate will be generally used, as it provides the public key needed
to verify the signature and clearly identifies the subject that provided the signature. The SPKI and keyId are allowed
to support environments where X.509 certificates are not used.¶
The optional certificates provided in PkixEvidence.intermediateCertificates
enable the insertion
of X.509 certificates to support trusting the signatures found in signature blocks. This information is intended to provide
the certificates required by the Verifier to verify the endorsement on the certificates included
with the signatures. intermediateCertificates
MAY include any or all intermediate CA certificates needed to build paths (excluding trust anchors). Order is not significant.¶
As described in Section 4, the TbsPkixEvidence
is a set of entities. Each entity
is associated with a type that defines its class. The entity types are represented by object identifiers
(OIDs). The following ASN.1 definition defines the structures associated with entities:¶
ReportedEntity ::= SEQUENCE { entityType OBJECT IDENTIFIER, reportedAttributes SEQUENCE SIZE (1..MAX) OF ReportedAttribute } id-pkix-evidence OBJECT IDENTIFIER ::= { 1 2 3 999 } id-pkix-evidence-entity-type OBJECT IDENTIFIER ::= { id-pkix-evidence 0 } id-pkix-evidence-entity-transaction OBJECT IDENTIFIER ::= { id-pkix-evidence-entity-type 0 } id-pkix-evidence-entity-platform OBJECT IDENTIFIER ::= { id-pkix-evidence-entity-type 1 } id-pkix-evidence-entity-key OBJECT IDENTIFIER ::= { id-pkix-evidence-entity-type 2 }¶
In turn, entities are composed of attributes. Each attribute is composed of a type and a value. The attribute types are represented by object identifiers (OIDs). The following ASN.1 definition defines the structures associated with attributes:¶
ReportedAttribute ::= SEQUENCE { attributeType OBJECT IDENTIFIER, value AttributeValue OPTIONAL } AttributeValue ::= CHOICE { bytes [0] IMPLICIT OCTET STRING, utf8String [1] IMPLICIT UTF8String, bool [2] IMPLICIT BOOLEAN, time [3] IMPLICIT GeneralizedTime, int [4] IMPLICIT INTEGER, oid [5] IMPLICIT OBJECT IDENTIFIER }¶
The attributes SHOULD be associated with a single entity type. Therefore, it is encouraged to define attribute types grouped with their respective entity type.¶
The type of an attribute value is dictated by the attribute type. When an attribute type is defined, the definition must include the type of the value, its semantic and interpretation.¶
The remainder of this section describes the entity types and their associated attributes.¶
A platform entity reports information about the device where the Evidence is generated and is
composed of a set of attributes that are global to the Target Environment.
It is associated with the type identifier id-pkix-evidence-entity-platform
.¶
A platform entity, if provided, MUST be included only once within the reported entities. If a
Verifier encounters multiple entities of type id-pkix-evidence-entity-platform
, it MUST
reject the Evidence as malformed.¶
The following table lists the attributes for a platform entity (platform attributes) defined within this specification. In cases where the attribute is borrowed from another specification, the "Reference" column refers to the specification where the semantics for the attribute value can be found. Attributes defined in this specification have further details below.¶
Attribute | AttributeValue | Reference | Multiple? | OID |
---|---|---|---|---|
vendor | utf8String | RFCthis | No | id-pkix-evidence-attribute-platform-vendor |
oemid | bytes | [RFC9711] | No | id-pkix-evidence-attribute-platform-oemid |
hwmodel | bytes | [RFC9711] | No | id-pkix-evidence-attribute-platform-hwmodel |
hwversion | utf8String | [RFC9711] | No | id-pkix-evidence-attribute-platform-hwversion |
hwserial | utf8String | RFCthis | No | id-pkix-evidence-attribute-platform-hwserial |
swname | utf8String | [RFC9711] | No | id-pkix-evidence-attribute-platform-swname |
swversion | utf8String | [RFC9711] | No | id-pkix-evidence-attribute-platform-swversion |
dbgstat | int | [RFC9711] | No | id-pkix-evidence-attribute-platform-debugstat |
uptime | int | [RFC9711] | No | id-pkix-evidence-attribute-platform-uptime |
bootcount | int | [RFC9711] | No | id-pkix-evidence-attribute-platform-bootcount |
fipsboot | bool | [FIPS140-3] | No | id-pkix-evidence-attribute-platform-fipsboot |
fipsver | utf8String | [FIPS140-3] | No | id-pkix-evidence-attribute-platform-fipsver |
fipslevel | int | [FIPS140-3] | No | id-pkix-evidence-attribute-platform-fipslevel |
fipsmodule | utf8String | [FIPS140-3] | No | id-pkix-evidence-attribute-platform-fipsmodule |
Each attribute defined in the table above is described in the following sub-sections.¶
A human-readable string that reports the name of the device's manufacturer. If the device is submitted to FIPS validation, this string should correspond to the vendor field of the submission.¶
These attributes are defined in [RFC9711] and reused in this specification for interoperability. Small descriptions are offered for each to ease the reading of this specification. In case of confusion between the description offered here and the one in [RFC9711], the definition offered in the latter shall prevail.¶
The attribute "oemid" uniquely identifies the Original Equipment Manufacturer (OEM) of the HSM. This is a sequence of bytes and is not meant to be a human readable string.¶
The attribute "hwmodel" differentiates models, products, and variants manufactured by a particular OEM. A model must be unique within a given "oemid". This is a sequence of bytes and is not meant to be a human readable string.¶
The attribute "hwversion" is a text string reporting the version of the hardware. This attribute must be interpreted along with the attribute "hwmodel".¶
The attribute "swname" is a text string reporting the name of the firmware running on the platform.¶
The attribute "swversion" differentiates between the various revisions of a firmware offered for the platform. This is a string that is expected to be human readable.¶
The attribute "dbgstat" refers to the state of the debug facilities offered by the HSM. This is an integer value describing the current state as described in [RFC9711].¶
The attribute "uptime" reports the number of seconds that have elapsed since the HSM was last booted.¶
The attribute "bootcount" reports the number of times the HSM was booted.¶
A human-readable string that reports the serial number of the hardware module. This serial number often matches the number engraved on the case or on an applied sticker.¶
FIPS 140-3 CMVP validation places stringent requirements on the mode of operation of the device and the cryptography offered by the module, including only enabling FIPS-approved algorithms, certain requirements on entropy sources, and extensive start-up self-tests. FIPS 140-3 offers compliance levels 1 through 4 with increasingly strict requirements. Many HSMs include a configuration setting that allows the device to be taken out of FIPS mode and thus enable additional functionality or performance, and some offer configuration settings to change between compliance levels.¶
The boolean attribute fipsboot
indicates whether the device is currently operating in FIPS mode. When the attribute value is "true", the HSM is running in compliance with the
FIPS 140 restrictions. Among other restrictions, it means that only FIPS-approved algorithms are available. If the value of this attribute is "false", then the HSM is not
restricted to the behavior limited by compliance.¶
The textual attribute fipsver
indicates the version of the FIPS CMVP specification with which the device's operational mode is compliant. At the time of writing, the strings "FIPS 140-2" or "FIPS 140-3" SHOULD be used.¶
The integer attribute fipslevel
indicates the compliance level to which the device is currently operating and MUST only be 1, 2, 3, or 4. The fipslevel
attribute has no meaning if fipsboot
is absent or false
.¶
The attribute fipsmodule
is a textual field used to represent the name of the module that was submitted to CMVP for validation. The information derived by combining this attribute with the vendor name shall
be sufficient to find the associated records in the CMVP database.¶
The FIPS status information in PKIX Evidence indicates only the mode of operation of the device and is not authoritative of its validation status. This information is available on the NIST CMVP website or by contacting the device vendor. As an example, some devices may have the option to enable FIPS mode in configuration even if the vendor has not submitted this model for validation. As another example, a device may be running in a mode consistent with FIPS Level 3 but the device was only validated and certified to Level 2. A Relying Party wishing to know the validation status of the device MUST couple the device state information contained in the Evidence with a valid FIPS CMVP certificate for the device.¶
A key entity is associated with the type id-pkix-evidence-entity-key
. Each instance of a
key entity represents a different addressable key found in the Target Environment. There can
be multiple key entities found in a claim description, but each reported key entity MUST
describe a different key. Two key entities may represent the same underlying cryptographic key
(keys with the exact same value) but they must be different portions of the Target Environment's
state.¶
A key entity is composed of a set of attributes relating to the cryptographic key. At minimum, a key entity MUST report the attribute "identifier" to uniquely identify this cryptographic key from any others found in the same Target Environment.¶
A Verifier that encounters a claim description with multiple key entities referring to the same addressable key MUST reject the Evidence.¶
The following table lists the attributes for a key entity defined within this specification. The "Reference" column refers to the specification where the semantics for the attribute value can be found.¶
Attribute | AttributeValue | Reference | Multiple? | OID |
---|---|---|---|---|
identifier | utf8String | RFCthis | Yes | id-pkix-evidence-attribute-key-identifier |
spki | bytes | RFCthis | No | id-pkix-evidence-attribute-key-spki |
extractable | bool | [PKCS11] | No | id-pkix-evidence-attribute-key-extractable |
sensitive | bool | [PKCS11] | No | id-pkix-evidence-attribute-key-sensitive |
never-extractable | bool | [PKCS11] | No | id-pkix-evidence-attribute-key-never-extractable |
local | bool | [PKCS11] | No | id-pkix-evidence-attribute-key-local |
expiry | time | RFCthis | No | id-pkix-evidence-attribute-key-expiry |
purpose | bytes | RFCthis | No | id-pkix-evidence-attribute-key-purpose |
An attestation key might be visible to a client of the device and be reported along with other cryptographic keys. Therefore, it is acceptable to include a key entity providing claims about an attestation key like any other cryptographic key. An implementation MAY reject the generation of PKIX Evidence if it relates to an attestation key.¶
A human-readable string that uniquely identifies the cryptographic key. This value often contains a UUID but could also have a numeric value expressed as text or any other textual description.¶
This attribute MAY be repeated as some environments have more than one way to refer to a cryptographic key.¶
The value of this attribute contains the DER-encoded field SubjectPublicKeyInfo (see [RFC5280]) associated with the cryptographic key.¶
These attributes are defined in [PKCS11] and reused in this specification for interoperability. Small descriptions are offered for each to ease the reading of this specification. In case of confusion between the description offered here and the one in [PKCS11], the definition offered in the latter shall prevail.¶
The attribute "extractable" indicates that the key can be exported from the HSM. Corresponds directly to the attribute CKA_EXTRACTABLE found in PKCS#11.¶
The attribute "sensitive" indicates that the key cannot leave the HSM in plaintext. Corresponds directly to the attribute CKA_SENSITIVE found in PKCS#11.¶
The attribute "never-extractable" indicates if the key was never extractable from the HSM throughout the life of the key. Corresponds directly to the attribute CKA_NEVER_EXTRACTABLE found in PKCS#11.¶
The attribute "local" indicates whether the key was generated locally or imported. Corresponds directly to the attribute CKA_LOCAL found in PKCS#11.¶
Reports a time after which the key is not to be used. The device MAY enforce this policy based on its internal clock.¶
Note that security considerations should be taken relating to HSMs and their internal clocks. See Section 10.7.¶
Reports the key capabilities associated with the subject key. Since multiple capabilities can be associated with a single key, the value of this attribute is a list of capabilities, each reported as an object identifier (OID).¶
The value of this attribute is the DER encoding of the following structure:¶
<CODE STARTS> PkixEvidenceKeyCapabilities ::= SEQUENCE OF OBJECT IDENTIFIER <CODE ENDS>¶
The following table describes the key capabilities defined in this specification. The key capabilities offered are based on key attributes provided by PKCS#11. Each capability is assigned an object identifier (OID).¶
Capability | PKCS#11 | OID |
---|---|---|
encrypt | CKA_ENCRYPT | id-pkix-evidence-key-capability-encrypt |
decrypt | CKA_DECRYPT | id-pkix-evidence-key-capability-decrypt |
wrap | CKA_WRAP | id-pkix-evidence-key-capability-wrap |
unwrap | CKA_UNWRAP | id-pkix-evidence-key-capability-unwrap |
sign | CKA_SIGN | id-pkix-evidence-key-capability-sign |
sign-recover | CKA_SIGN_RECOVER | id-pkix-evidence-key-capability-sign-recover |
verify | CKA_VERIFY | id-pkix-evidence-key-capability-verify |
verify-recover | CKA_VERIFY_RECOVER | id-pkix-evidence-key-capability-verify-recover |
derive | CKA_DERIVE | id-pkix-evidence-key-capability-derive |
The use of an object identifier to report a capability allows third parties to extend this list to support implementations that have other key capabilities.¶
A transaction entity is associated with the type id-pkix-evidence-entity-transaction
. This is
a logical entity and does not relate to an element found in the Target Environment. Instead, it
groups together attributes that relate to the request of generating the Evidence.¶
For example, it is possible to include a "nonce" as part of the request to produce Evidence. This nonce is repeated as part of the Evidence to prove the freshness of the claims. This "nonce" is not related to any element in the Target Environment and the transaction entity is used to gather those values into attributes.¶
A transaction entity, if provided, MUST be included only once within the reported entities. If a
Verifier encounters multiple entities of type id-pkix-evidence-entity-transaction
, it MUST
reject the Evidence.¶
The following table lists the attributes for a transaction entity defined within this specification. The "Reference" column refers to the specification where the semantics for the attribute value can be found.¶
Attribute | AttributeValue | Reference | Multiple? | OID |
---|---|---|---|---|
nonce | bytes | [RFC9711] | No | id-pkix-evidence-attribute-transaction-nonce |
timestamp | time | [RFC9711] | No | id-pkix-evidence-attribute-transaction-timestamp |
ak-spki | bytes | RFCthis | Yes | id-pkix-evidence-attribute-transaction-ak-spki |
The attribute "nonce" is used to provide "freshness" quality as to the claims provided in the PkixEvidence message. A Presenter requesting a PkixEvidence message MAY provide a nonce value as part of the request. This nonce value, if provided, SHOULD be repeated in the generated Evidence as an attribute within the transaction entity. Unlike EAT, only a single transaction.nonce
is permitted to simplify verifier logic and reduce ambiguity.¶
This is similar to the attribute "eat_nonce" as defined in [RFC9711]. According to that specification, this attribute may be specified multiple times with different values. However, within the scope of this specification, the "nonce" value can be specified only once within a transaction.¶
The time at which the PKIX Evidence was generated, according to the internal system clock of the Attester. This is similar to the "iat" claim in [RFC9711].¶
Note that security considerations should be taken relating to the evaluation of timestamps generated by HSMs. See Section 10.7.¶
This field contains the encoded Subject Public Key Information (SPKI) for the attestation key used to sign the evidence. The definition and encoding for SPKIs are defined in X.509 certificates ([RFC5280]).¶
This transaction attribute is used to bind the content of the evidence with the key(s) used to sign that evidence. The importance of this binding is discussed in Section 10.3.¶
It is expected that HSM vendors will register additional Entity and Attribute types by assigning OIDs from their own proprietary OID arcs to hold data describing additional proprietary key properties.¶
When new entity and attribute types are used, documentation similar to the one produced in this specification SHOULD be distributed to explain the meaning of the types and the frequency that values can be provided.¶
See Section 7.3, Section 7.4 and Section 10.1 for handling of unrecognized custom types.¶
A PkixEvidence is to be DER encoded [X.690].¶
If a textual representation is required, then the DER encoding MAY be subsequently encoded into Standard Base64 as defined in [RFC4648].¶
PEM-like representations are also allowed where a MIME-compliant Base64 transformation of the DER encoding is used, provided that the header label is "EVIDENCE". For example:¶
-----BEGIN EVIDENCE----- (...) -----END EVIDENCE-----¶
The SignatureBlock.signatureValue
signs over the DER-encoded to-be-signed evidence data
PkixEvidence.tbs
and MUST be validated with the subject public key of the leaf
X.509 certificate contained in the SignerIdentifier.certificate
. Verifiers MAY also use
PkixEvidence.intermediateCertificates
to build a certification path to a trust anchor.¶
Note that a PkixEvidence MAY contain zero or more SignatureBlocks. A PkixEvidence with zero SignatureBlocks is unsigned and unprotected; Verifiers MUST treat it as untrusted and MUST NOT rely on its claims.¶
More than one SignatureBlock MAY be used to convey a number of different semantics. For example, the HSM's Attesting Service might hold multiple Attestation Keys on different cryptographic algorithms in order to provide algorithm redundancy in the case that one algorithm becomes cryptographically broken. In this case a Verifier would be expected to validate all SignatureBlocks. Alternatively, the HSM's Attesting Service may hold multiple Attestation Keys (or multiple X.509 certificates for the same key) from multiple operational environments to which it belongs. In this case a Verifier would be expected to only validate the SignatureBlock corresponding to its own environment. Alternatively, multiple SignatureBlocks could be used to convey counter-signatures from external parties, in which case the Verifier will need to be equipped with environment-specific verification logic. Multiple of these cases, and potentially others, could be supported by a single PkixEvidence object.¶
Note that each SignatureBlock is a fully detached signature over the tbs content with no binding between the signed content and the SignatureBlocks, or between SignatureBlocks, meaning that a third-party can add a counter-signature of the evidence after the fact, or an attacker can remove a SignatureBlock without leaving any artifact. See Section 10.3 for further discussion.¶
If any transaction.ak-spki
attributes are present, the Verifier SHOULD verify that each SignerIdentifier
’s SubjectPublicKeyInfo (or the SPKI of its certificate
) matches at least one ak-spki
value.¶
This section is informative in nature and implementers of this specification do not need to adhere to it. The aim of this section is to provide a standard interface between a Presenter and an HSM producing PKIX evidence. The authors hope that this standard interface will yield interoperable tools between offerings from different vendors.¶
The interface presented in this section might be too complex for manufacturers of HSMs with limited capabilities such as smartcards or personal ID tokens. For devices with limited capabilities, a fixed PKIX evidence endorsed by the vendor might be installed during manufacturing. Other approaches for constrained HSMs might be to report entities and attributes that are fixed or offer limited variations.¶
On the other hand, an enterprise-grade HSM with the capability to hold a large number of private keys is expected to be capable of generating PKIX evidence catered to the specific constraints imposed by a Verifier and without exposing extraneous information. The aim of the request interface is to provide the means to select and report specific information in the PKIX evidence.¶
This section introduces the role of "Presenter" as shown in Figure 1. The Presenter is the role that initiates the generation of PKIX evidence. Since HSMs are generally servers (client/server relationship) or peripherals (controller/peripheral relationship), a Presenter is required to launch the process of creating the PKIX evidence and capturing it to forward it to the Verifier.¶
An Attestation Request (request) is assembled by the Presenter and submitted to the HSM. The HSM parses the request and produces PKIX evidence which is returned to the Presenter for distribution.¶
In the previous figure, the HSM is represented as being composed of an attestation service and a Target Environment. This representation is offered as a simplified view and implementations are not required to adhere to this separation of concerns.¶
The aim of the figure is to depict the position of the Presenter as an intermediate role between the Attester (in this case the HSM) and the Verifier. The role of "Presenter" is privileged as it controls the Evidence being generated by the Attester. However, the role is not "trusted" as the Verifier does not have to take into account the participation of the Presenter as part of the function of appraising the Evidence.¶
The attestation request, shown in the figure, consists of a structure TbsPkixEvidence
containing one ReportedEntity
for each entity expected to
be included in the evidence produced by the HSM.¶
Each instance of ReportedEntity
included in the request is referred to as a request entity. A request entity contains a number of instances
of ReportedAttribute
known as request attributes. The collection of request entities and request attributes represent the information desired
by the Presenter.¶
In most cases the value of a request attribute should be left unspecified by the Presenter. In the process of generating
the evidence, the values of the desired attributes are observed by the Attestation Service within the HSM and reported accordingly. For the purpose
of creating a request, the Presenter does not specify the value of the requested attributes and leaves them empty. This is possible because the definition of
the structure ReportedAttribute
specifies the element value
as optional.¶
On the other hand, there are circumstances where the value of a request attribute should be provided by the Presenter. For example, when a particular cryptographic key is to be included in the evidence, the request must include a key entity with one of the "identifier" attributes set to the value corresponding to the desired key.¶
Some instances of ReportedEntity
, such as those representing the platform or the transaction, do not need identifiers as the associated elements are
implicit in nature. Custom entity types might need selection during an attestation request and related documentation should specify how this is
achieved.¶
The instance of TbsPkixEvidence
is unsigned and does not provide any means to maintain integrity when communicated from the Presenter to the HSM.
These details are left to the implementer. However, it is worth pointing out that the structure offered by PkixEvidence
could be reused by an
implementer to provide those capabilities, as described in Section 10.5.¶
This section deals with the request attributes specified in this document where a value should be provided by a Presenter. In other words, this
section defines all request attributes that should set in the structure ReportedAttribute
. Request attributes not covered in this sub-section
should not have a specified value (left empty).¶
Since this section is non-normative, implementers may deviate from those recommendations.¶
A Presenter may choose to select which cryptographic keys are reported as part of the PKIX evidence. For each selected cryptographic key,
the Presenter includes a request entity of type id-pkix-evidence-entity-key
. Among the request attributes for this entity, the
Presenter includes one attribute with the type id-pkix-evidence-attribute-key-identifier
. The value of this attribute should be
set to the utf8String that represents the identifier for the specific key.¶
An HSM receiving an attestation request which selects a key via this approach SHOULD fail the transaction if it cannot find the cryptographic key associated with the specified identifier.¶
A Presenter may choose to include a nonce as part of the attestation request. When producing the PKIX evidence, the HSM repeats the nonce that was provided as part of the request.¶
When providing a nonce, a Presenter includes, in the attestation request, an entity of type id-pkix-evidence-entity-transaction
with an attribute of type id-pkix-evidence-attribute-transaction-nonce
. This attribute is set with the value of the
nonce as "bytes".¶
An implementer might desire to select multiple cryptographic keys based on a shared attribute. A possible approach
is to include a single request entity of type id-pkix-evidence-entity-key
including an attribute with a set value. This attribute
would not be related to the key identifier as this is unique to each key. A HSM supporting this scheme could select all the cryptographic
keys matching the specified attribute and report them in the PKIX evidence.¶
This is a departure from the base request interface, as multiple key entities are reported from a single request entity.¶
More elaborate selection schemes can be envisaged where multiple request attributes specifying values would be tested against cryptographic keys. Whether these attributes are combined in a logical "and" or in a logical "or" would need to be specified by the implementer.¶
The extensibility offered by the proposed request interface allows an implementer to add custom attributes to the transaction entity in order to influence the way that the evidence generation is performed.¶
In such an approach, a new custom attribute for request entities of type "transaction" is defined. Then, an attribute of that type is included in the attestation request (as part of the transaction entity) while specifying a value. This value is considered by the HSM while generating the PKIX evidence.¶
There is a provision for the Attester to report the Attestation Key(s) used during the generation of the evidence. To this end, the transaction attribute "ak-spki" is used.¶
A Presenter invokes this provision by submitting an attestation request with a transaction attribute of type "ak-spki" with a non-specified value (left empty).¶
In this case, the Attester adds a transaction attribute of type "ak-spki" for each Attestation Key used to sign the evidence. The value of this attribute is an octet string (bytes) which is the encoding of the Subject Public Key Information (SPKI) associated with the Attestation Key. Details on SPKIs and their encoding can be found in X.509 certificates ([RFC5280]).¶
This reporting effectively binds the signature blocks to the content (see Section 10.3).¶
This sub-section deals with the rules that should be considered when an Attester (the HSM) processes a request to generate Evidence. This section is non-normative and implementers MAY choose to not follow these recommendations.¶
These recommendations apply to any attestation request schemes and are not restricted solely to the request interface proposed here.¶
An Attester SHOULD fail an attestation request if it contains an unrecognized entity type. This is to ensure that all the semantics expected by the Presenter are fully understood by the Attester.¶
An Attester MUST fail an attestation request if it contains a request attribute of an unrecognized type with a specified a value (not empty). This represents a situation where the Presenter is selecting specific information that is not understood by the Attester.¶
An Attester SHOULD ignore unrecognized attribute types in an attestation request. In this situation, the Attester SHOULD NOT include the attribute as part of the response. This guidance is to increase the likelihood of interoperability between tools of various vendors.¶
An Attester MUST NOT include entities and attributes in the generated evidence if these entities and attributes were not specified as part of the request. This is to give the Presenter the control on what information is disclosed by the Attester.¶
An Attester MUST fail an attestation request if the Presenter does not have the appropriate access rights to the entities included in the request.¶
This sub-section deals with the rules that should be considered when a Presenter receives PKIX evidence from the Attester (the HSM) prior to distribution. This section is non-normative and implementers MAY choose to not follow these recommendations.¶
These recommendations apply to any PKIX evidence and are not restricted solely to evidence generated from the proposed request interface.¶
A Presenter MUST review the evidence produced by an Attester for fitness prior to distribution.¶
A Presenter MUST NOT disclose evidence if it contains information it cannot parse. This restriction applies to entity types and attributes type. This is to ensure that the information provided by the Attester can be evaluated by the Presenter.¶
A Presenter MUST NOT disclose evidence if it contains entities others than the ones that were requested of the Attester. This is to ensure that only the selected entities are exposed to the Verifier.¶
A Presenter MUST NOT disclose evidence if it contains an entity with an attribute that was not requested of the Attester. This is to ensure that only the selected information is disclosed to the Verifier.¶
Further privacy concerns are discussed in Section 10.4.¶
<CODE STARTS> =============== NOTE: '\' line wrapping per RFC 8792 ================ PKIX-Evidence-2025 { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-mod-pkix-evidence-2025(TBDMOD) } DEFINITIONS IMPLICIT TAGS ::= BEGIN PkixEvidence ::= SEQUENCE { tbs TbsPkixEvidence, signatures SEQUENCE SIZE (0..MAX) OF \ SignatureBlock, intermediateCertificates [0] SEQUENCE OF Certificate OPTIONAL -- As defined in RFC 5280 } TbsPkixEvidence ::= SEQUENCE { version INTEGER, reportedEntities SEQUENCE SIZE (1..MAX) OF ReportedEntity } ReportedEntity ::= SEQUENCE { entityType OBJECT IDENTIFIER, reportedAttributes SEQUENCE SIZE (1..MAX) OF ReportedAttribute } ReportedAttribute ::= SEQUENCE { attributeType OBJECT IDENTIFIER, value AttributeValue OPTIONAL } AttributeValue ::= CHOICE { bytes [0] OCTET STRING, utf8String [1] UTF8String, bool [2] BOOLEAN, time [3] GeneralizedTime, int [4] INTEGER, oid [5] OBJECT IDENTIFIER, null [6] NULL } SignatureBlock ::= SEQUENCE { sid SignerIdentifier, signatureAlgorithm AlgorithmIdentifier, signatureValue OCTET STRING } SignerIdentifier ::= SEQUENCE { keyId [0] EXPLICIT OCTET STRING OPTIONAL, subjectKeyIdentifier [1] EXPLICIT SubjectPublicKeyInfo OPTIONAL, -- As defined in RFC 5280 certificate [2] EXPLICIT Certificate OPTIONAL -- As defined in RFC 5280 } PkixEvidenceKeyCapabilities ::= SEQUENCE OF OBJECT IDENTIFIER id-pkix-evidence OBJECT IDENTIFIER ::= { 1 2 3 999 } id-pkix-evidence-entity-type OBJECT IDENTIFIER ::= { id-pkix-\ evidence 0 } id-pkix-evidence-entity-transaction OBJECT IDENTIFIER ::= { id-pkix-\ evidence-entity-type 0 } id-pkix-evidence-entity-platform OBJECT IDENTIFIER ::= { id-pkix-\ evidence-entity-type 1 } id-pkix-evidence-entity-key OBJECT IDENTIFIER ::= { id-pkix-\ evidence-entity-type 2 } id-pkix-evidence-attribute-type OBJECT IDENTIFIER ::= { id-pkix-\ evidence 1 } id-pkix-evidence-attribute-transaction OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-type 0 } id-pkix-evidence-attribute-transaction-nonce OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-transaction 0 } id-pkix-evidence-attribute-transaction-timestamp OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-transaction 1 } id-pkix-evidence-attribute-transaction-ak-spki OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-transaction 2 } id-pkix-evidence-attribute-platform OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-type 1 } id-pkix-evidence-attribute-platform-vendor OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 0 } id-pkix-evidence-attribute-platform-oemid OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 1 } id-pkix-evidence-attribute-platform-hwmodel OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 2 } id-pkix-evidence-attribute-platform-hwversion OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 3 } id-pkix-evidence-attribute-platform-hwserial OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 4 } id-pkix-evidence-attribute-platform-swname OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 5 } id-pkix-evidence-attribute-platform-swversion OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 6 } id-pkix-evidence-attribute-platform-debugstat OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 7 } id-pkix-evidence-attribute-platform-uptime OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 8 } id-pkix-evidence-attribute-platform-bootcount OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 9 } id-pkix-evidence-attribute-platform-usermods OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 10 } id-pkix-evidence-attribute-platform-fipsboot OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 11 } id-pkix-evidence-attribute-platform-fipsver OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 12 } id-pkix-evidence-attribute-platform-fipslevel OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 13 } id-pkix-evidence-attribute-platform-fipsmodule OBJECT IDENTIFIER ::\ = { id-pkix-evidence-attribute-platform 14 } id-pkix-evidence-attribute-key OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-type 2 } id-pkix-evidence-attribute-key-identifier OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 0 } id-pkix-evidence-attribute-key-spki OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 1 } id-pkix-evidence-attribute-key-extractable OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 2 } id-pkix-evidence-attribute-key-sensitive OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 3 } id-pkix-evidence-attribute-key-never-extractable OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 4 } id-pkix-evidence-attribute-key-local OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 5 } id-pkix-evidence-attribute-key-expiry OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 6 } id-pkix-evidence-attribute-key-purpose OBJECT IDENTIFIER :\ := { id-pkix-evidence-attribute-key 7 } id-pkix-evidence-key-capability OBJECT IDENTIFIER :\ := { id-pkix-evidence 2 } id-pkix-evidence-key-capability-encrypt OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 0 } id-pkix-evidence-key-capability-decrypt OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 1 } id-pkix-evidence-key-capability-wrap OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 2 } id-pkix-evidence-key-capability-unwrap OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 3 } id-pkix-evidence-key-capability-sign OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 4 } id-pkix-evidence-key-capability-sign-recover OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 5 } id-pkix-evidence-key-capability-verify OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 6 } id-pkix-evidence-key-capability-verify-recover OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 7 } id-pkix-evidence-key-capability-derive OBJECT IDENTIFIER :\ := { id-pkix-evidence-key-capability 8 } END <CODE ENDS>¶
Please replace "RFCthis" with the RFC number assigned to this document.¶
The following OIDs are defined in this document and will require IANA registration under the assigned arc:¶
id-pkix-evidence
¶
id-pkix-evidence-entity-type
¶
id-pkix-evidence-entity-transaction
¶
id-pkix-evidence-entity-platform
¶
id-pkix-evidence-entity-key
¶
Attribute OIDs referenced in the Platform, Key, and Transaction tables (e.g., id-pkix-evidence-attribute-platform-*
, id-pkix-evidence-attribute-key-*
, id-pkix-evidence-attribute-transaction-*
).¶
The generation of PKIX evidence by an HSM is to provide sufficient information to a Verifier and a Relying Party to appraise the Target Environment (the HSM) and make decisions based on this appraisal.¶
The Appraisal Policy associated with the Verifier influences the generation of the Attestation Results. Those results, in turn, are consumed by the Relying Party to make decisions about the HSM, which might be based on a set of rules and policies. Therefore, the interpretation of PKIX evidence may greatly influence the outcome of some decisions.¶
A Verifier MAY reject a PKIX evidence if it lacks required attributes per the Verifier's appraisal policy. For example, if a Relying Party mandates a FIPS-certified device, it SHOULD reject evidence lacking sufficient information to verify the device's FIPS certification status.¶
If a Verifier encounters an attribute with an unrecognized attribute type, it MAY ignore it and treat it as extraneous information. By ignoring an attribute, the Verifier may accept PKIX evidence that would be deemed malformed to a Verifier with different policies. However, this approach fosters a higher likelihood of achieving interoperability.¶
The nature of attestation requires the Attestation Service to be implemented in an extremely privileged position within the HSM so that it can collect measurements of both the hardware environment and the user keys being attested. For many HSM architectures, this will place the Attestation Service inside the "security kernel" and potentially subject to FIPS 140-3 or Common Criteria validation and change control. For both security and compliance reasons there is incentive for the generation and parsing logic to be simple and easy to implement correctly. Additionally, when the data formats contained in this specification are parsed within an HSM boundary -- that would be parsing a request entity, or parsing an attestation produced by a different HSM -- implementers SHOULD opt for simple logic that rejects any data that does not match the expected format, instead of attempting to be flexible.¶
In particular, the Attestation Service SHOULD generate the PKIX evidence from scratch and avoid copying any content from the request. The Attestation Service MUST generate PKIX evidence only from attributes and values that are observed by the service.¶
The construction of the evidence structure (PkixEvidence
) includes a collection of signature
blocks that are not explicitly bound to the content. This approach was influenced by the following
motivations:¶
Multiple simultaneous signature blocks are desired to support hybrid environments where multiple keys using different cryptographic algorithms are required to support appraisal policies.¶
Provide the ability to add counter-signatures without having to define an envelop scheme.¶
The concept of counter-signatures is important for environments where a number of heterogeneous devices are deployed. In those environments, it is possible for a trusted actor, intermediary between the Attester and the Verifier, to validate the original signature(s) and apply its own afterwards.¶
The ability to add signature blocks to the evidence after the original generation by the Attester leads to the unfortunate situation where signature blocks can also be removed without leaving any trace. Therefore, the signature blocks can be deemed as "detachable" or "stapled".¶
Manipulation of the evidence after it was generated can lead to undesired outcomes at the Verifier.¶
Therefore, Verifiers MUST be designed to accept evidence based on their appraisal policies, regardless of the presence or absence of certain signature(s). Consequently, Verifiers MUST NOT make any inferences based on a missing signature, as the signature could have been removed in transit.¶
This specification provides the transaction attribute "ak-spki" to effectively bind the content with the signature blocks that were generated by the Attester. When this attribute is provided, it reports the SPKI of one of the attestation keys used by the Attester to produce the evidence. This attribute is repeated for each of the attestation keys used by the Attester.¶
Some HSMs have the capacity of supporting cryptographic keys controlled by separate entities referred to as "tenants", and when the HSM is used in that mode it is referred to as a multi-tenant configuration.¶
For example, an enterprise-grade HSM in a large multi-tenant cloud service could host TLS keys fronting multiple un-related web domains. Providing evidence for attesting attributes of any one of the keys would involve a Presenter that could potentially access any of the hosted keys. In such a case, privacy violations could occur if the Presenter was to disclose information that does not relate to the subject key.¶
Implementers SHOULD be careful to avoid over-disclosure of information, for example by authenticating the Presenter as described in Section 10.5 and only returning results for keys and environments for which it is authorized. In absence of an existing mechanism for authenticating and authorizing administrative connections to the HSM, the attestation request MAY be authenticated by embedding the TbsPkixEvidence of the request inside a PkixEvidence signed with a certificate belonging to the Presenter.¶
Furthermore, enterprise and cloud-services grade HSMs SHOULD support the full set of attestation request functionality described in Section 7 so that Presenters can fine-tune the content of a PKIX evidence such that it is appropriate for the intended Verifier.¶
The Presenter represents a privileged role within the architecture of this specification as it gets to learn about the existence of user keys and their protection properties, as well as details of the platform. The Presenter is in the position of deciding how much information to disclose to the Verifier, and to request a suitably redacted evidence from the HSM.¶
For personal cryptographic tokens it might be appropriate for the attestation request interface to be un-authenticated. However, for enterprise and cloud-services grade HSMs the Presenter SHOULD be authenticated using the HSM's native authentication mechanism. The details are HSM-specific and are thus left up to the implementer. However, it is RECOMMENDED to implement an authorization framework similar to the following.¶
A Presenter SHOULD be allowed to request evidence for any user keys which it is allowed to use. For example, a TLS application that is correctly authenticated to the HSM in order to use its TLS keys SHOULD be able to request evidence of those same keys without needing to perform any additional authentication or requiring any additional roles or permissions. HSMs that wish to allow a Presenter to request evidence of keys which is not allowed to use, for example for the purposes of displaying HSM status information on an administrative console or UI, SHOULD have a "Attestation Requester" role or permission and SHOULD enforce the HSM's native access controls such that the Presenter can only retrieve evidence for keys for which it has read access.¶
In the absence of an existing mechanism for authenticating and authorizing administrative connections to the HSM, the attestation request MAY be authenticated by embedding the TbsPkixEvidence
of the request inside a PkixEvidence
signed with a certificate belonging to the Presenter.¶
With asymmetric keys within a Public Key Infrastructure (PKI) it is common to require a key holder to prove that they are in control of the private key by using it. This is called "proof-of-possession (PoP)". This specification intentionally does not provide a mechanism for PoP of user keys and relies on the Presenter, Verifier, and Relying Party trusting the Attester to correctly report the cryptographic keys that it is holding.¶
It would be trivial to add a PoP Key Attribute that uses the attested user key to sign over, for example, the Transaction Entity. However, this approach leads to undesired consequences, as explained below.¶
First, a user key intended for TLS, as an example, SHOULD only be used with the TLS protocol. Introducing a signature oracle whereby the TLS application key is used to sign PKIX evidence could lead to cross-protocol attacks. In this example, an attacker could submit a "nonce" value which is in fact not random but is crafted in such a way as to appear as a valid message in some other protocol context or exploit some other weakness in the signature algorithm.¶
Second, the Presenter who has connected to the HSM to request PKIX evidence may have permissions to view the requested application keys but not permission to use them, as in the case where the Presenter is an administrative UI displaying HSM status information to an systems administrator or auditor.¶
Requiring the Attestation Service to use the attested application keys could, in some architectures, require the Attestation Service to resolve complex access control logic and handle complex error conditions for each requested key, which violates the "simple to implement" design principle outlined in Section 10.2. More discussion of authenticating the Presenter can be found in Section 10.5.¶
It is common for HSMs to have an inaccurate system clock. Most clocks have a natural drift and must be corrected periodically. HSMs, like any other devices, are subject to these issues.¶
There are many situations where HSMs can not naturally correct their internal system clocks. For example, consider a HSM hosting a trust anchor and usually kept offline and booted up infrequently in a network without a reliable time management service. Another example is a smart card which boots up only when held against an NFC reader.¶
When a timestamp generated from a HSM is evaluated, the expected behavior of the system clock SHOULD be considered.¶
More specifically, the timestamp SHOULD NOT be relied on for establishing the freshness of the evidence generated by a HSM. Instead, Verifiers SHOULD rely on other provisions such as the "nonce" attribute of the "transaction" entity, introduced this specification.¶
Furthermore, the internal system clock of HSMs SHOULD NOT be relied on to enforce expiration policies.¶
A reference implementation of this specification can be found at https://github.com/ietf-rats-wg/key-attestation¶
It produces the following sample evidence:¶
=============== NOTE: '\' line wrapping per RFC 8792 ================ PkixAttestation: tbs=TbsPkixAttestation: version=2 reportedEntities=SequenceOf: ReportedEntity: entityType=1.2.3.999.0.0 reportedAttributes=SequenceOf: ReportedAttribute: attributeType=1.2.3.999.1.0.0 value=AttributeValue: bytes=0102030405 ReportedEntity: entityType=1.2.3.999.0.1 reportedAttributes=SequenceOf: ReportedAttribute: attributeType=1.2.3.999.1.1.1 value=AttributeValue: utf8String=HSM-123 ReportedAttribute: attributeType=1.2.3.999.1.1.2 value=AttributeValue: bool=True ReportedAttribute: attributeType=1.2.3.999.1.1.3 value=AttributeValue: utf8String=Model ABC ReportedAttribute: attributeType=1.2.3.999.1.1.4 value=AttributeValue: utf8String=3.1.9 ReportedEntity: entityType=1.2.3.999.0.2 reportedAttributes=SequenceOf: ReportedAttribute: attributeType=1.2.3.999.1.2.0 value=AttributeValue: utf8String=26d765d8-1afd-4dfb-a290-cf867ddecfa1 ReportedAttribute: attributeType=1.2.3.999.1.2.3 value=AttributeValue: bool=False ReportedAttribute: attributeType=1.2.3.999.1.2.1 value=AttributeValue: bytes=\ 0x3059301306072a8648ce3d020106082a8648ce3d03010703420004422548f88fb7\ 82ffb5eca3744452c72a1e558fbd6f73be5e48e93232cc45c5b16c4cd10c4cb8d5b8\ a17139e94882c8992572993425f41419ab7e90a42a494272 ReportedEntity: entityType=1.2.3.999.0.2 reportedAttributes=SequenceOf: ReportedAttribute: attributeType=1.2.3.999.1.2.0 value=AttributeValue: utf8String=49a96ace-e39a-4fd2-bec1-13165a99621c ReportedAttribute: attributeType=1.2.3.999.1.2.3 value=AttributeValue: bool=True ReportedAttribute: attributeType=1.2.3.999.1.2.1 value=AttributeValue: bytes=\ 0x3059301306072a8648ce3d020106082a8648ce3d03010703420004422548f88fb7\ 82ffb5eca3744452c72a1e558fbd6f73be5e48e93232cc45c5b16c4cd10c4cb8d5b8\ a17139e94882c8992572993425f41419ab7e90a42a494272 ReportedEntity: entityType=1.2.3.888.0 reportedAttributes=SequenceOf: ReportedAttribute: attributeType=1.2.3.888.1 value=AttributeValue: utf8String=partition 1 signatures=SequenceOf: SignatureBlock: certChain=SequenceOf: Certificate: tbsCertificate=TBSCertificate: version=v3 serialNumber=510501933685942792810365453374472870755160518925 signature=AlgorithmIdentifier: algorithm=1.2.840.113549.1.1.11 parameters=0x0500 issuer=Name: rdnSequence=RDNSequence: RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.10 value=0x0c0449455446 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.11 value=0x0c0452415453 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.3 value=0x0c06414b20525341 validity=Validity: notBefore=Time: utcTime=250117171303Z notAfter=Time: generalTime=20520604171303Z subject=Name: rdnSequence=RDNSequence: RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.10 value=0x0c0449455446 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.11 value=0x0c0452415453 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.3 value=0x0c06414b20525341 subjectPublicKeyInfo=SubjectPublicKeyInfo: algorithm=AlgorithmIdentifier: algorithm=1.2.840.113549.1.1.1 parameters=0x0500 subjectPublicKey=\ 31795268810366627125468059984427145931784542919710733587190808152893\ 60654221420809632888307722560713639336279560999760196831203900125133\ 94283491012035327260476464503011428823183377093983165744076471996900\ 00689245113739552615279534528145776090813314822312012607567736073057\ 93682071373309092884909267211093730030075556179780800043813483945804\ 36738524537229696496092020939452353934949121386913422195643653009653\ 87743701570507112064401758218314760153081271981340812350365663466513\ 62085332653425242470699284103365281746135463231612931259782554282056\ 96678423183426464574470371256093994768443364562065834165394264792211\ 64971369788464727307915820767918489601 extensions=Extensions: Extension: extnID=2.5.29.14 critical=False extnValue=0x04148919595e0ef169f5cbbd47e134fce298cc693091 Extension: extnID=2.5.29.35 critical=False extnValue=0x301680148919595e0ef169f5cbbd47e134fce298cc693091 Extension: extnID=2.5.29.19 critical=True extnValue=0x30030101ff signatureAlgorithm=AlgorithmIdentifier: algorithm=1.2.840.113549.1.1.11 parameters=0x0500 signature=\ 12977775424631768289542539102653382982431795551146145281750189553757\ 94098257281326442898298599774059587807702785399451577511675203096385\ 84696515487658087752698572711677485127950179162848670513028844653157\ 51010913658016640170608413935780119349866986170148033301955753116984\ 04127127390775654478023156464686042499902099074552338362298011520044\ 62601031731035006478387581976102385523490530645254202408261935533953\ 78873725256584269666918504793674497748455574822238022085054752185687\ 44080765533772482185333268815846037955490610541772066517564837183282\ 59395770398747304427903377260041058781683759981231103319933488336293\ 25492 signatureAlgorithm=AlgorithmIdentifier: algorithm=1.2.840.113549.1.1.10 parameters=RSASSA_PSS_params: hashAlgorithm=AlgorithmIdentifier: algorithm=2.16.840.1.101.3.4.2.1 maskGenAlgorithm=AlgorithmIdentifier: algorithm=1.2.840.113549.1.1.8 saltLength=20 trailerField=1 signatureValue=\ 0xab7fd2b0f854daa4e867fd16955cd3b9910e93b70c7403cfa8077f04193909d14e\ c6bed859b67476c84cc2c28842b9a087d5c39e11ca95f6961d272d97297cb6ed3c06\ 2717696b032f4bf1f0f41ac20ae9706a8a4c17845ae2512950774173737010d6692c\ b726d1ab3a022092efcf27f0dd875b62e4df546814186f9e744cc34cf0778c877c57\ 1d006be094aa683a5f66d6816d22dba104334163020c62d81903c41d353eaba94212\ 47fc354fd3288a01921d93014100960324c3122feebfffc1007c83e98136e1b1fca1\ 15835b9e67fa9056f290208fb99e1c8144839a5e13ccb1217dceeecc253fc7785bc8\ 308382e052ffb867b40a0cd593176ed6ddc7b0 SignatureBlock: certChain=SequenceOf: Certificate: tbsCertificate=TBSCertificate: version=v3 serialNumber=43752118382009037811618748949928339462896457144 signature=AlgorithmIdentifier: algorithm=1.2.840.10045.4.3.2 issuer=Name: rdnSequence=RDNSequence: RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.10 value=0x0c0449455446 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.11 value=0x0c0452415453 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.3 value=0x0c07414b2050323536 validity=Validity: notBefore=Time: utcTime=250117171428Z notAfter=Time: generalTime=20520604171428Z subject=Name: rdnSequence=RDNSequence: RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.10 value=0x0c0449455446 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.11 value=0x0c0452415453 RelativeDistinguishedName: AttributeTypeAndValue: type=2.5.4.3 value=0x0c07414b2050323536 subjectPublicKeyInfo=SubjectPublicKeyInfo: algorithm=AlgorithmIdentifier: algorithm=1.2.840.10045.2.1 parameters=0x06082a8648ce3d030107 subjectPublicKey=\ 57095560233504924588952816185508037812996307929249104847846164660564\ 88839712339087758567046283628572504126189755002031148112756265577433\ 3675293173915140722 extensions=Extensions: Extension: extnID=2.5.29.14 critical=False extnValue=0x04145b70a79817f79ff637d2f7e3dc446c2109d7bbd4 Extension: extnID=2.5.29.35 critical=False extnValue=0x301680145b70a79817f79ff637d2f7e3dc446c2109d7bbd4 Extension: extnID=2.5.29.19 critical=True extnValue=0x30030101ff signatureAlgorithm=AlgorithmIdentifier: algorithm=1.2.840.10045.4.3.2 signature=\ 18216751979714603574557504315480141511553297913673112867639918069266\ 48218048839904015520407896430131032024244860880583649829667093244967\ 82518079519267269438816178719668437 signatureAlgorithm=AlgorithmIdentifier: algorithm=1.2.840.10045.2.1 parameters=0x06082a8648ce3d030107 signatureValue=\ 0x3046022100e416af2483667e73345ee297e563cf1639e41ab9bdcd01f98872fddb\ 101e779d022100d06c6e1054292640eea1873230a399af0936760cbfc8023a8a2874\ f9c5fc5ba8 DER Base64: MIIIszCCAgsCAQIwggIEMCEGBioDh2cAADAXMBUGByoDh2cBAAAECjAxMDIwMzA0MDUw\ VAYGKgOHZwABMEowEgYHKgOHZwEBAQwHSFNNLTEyMzAMBgcqA4dnAQECAQH/\ MBQGByoDh2cBAQMMCU1vZGVsIEFCQzAQBgcqA4dnAQEEDAUzLjEuOTCBsgYGKgOHZwAC\ MIGnMC8GByoDh2cBAgAMJDI2ZDc2NWQ4LTFhZmQtNGRmYi1hMjkwLWNmODY3ZGRlY2Zh\ MTAMBgcqA4dnAQIDAQEAMGYGByoDh2cBAgEEWzBZMBMGByqGSM49AgEGCCqGSM49AwEH\ A0IABEIlSPiPt4L/teyjdERSxyoeVY+9b3O+\ XkjpMjLMRcWxbEzRDEy41bihcTnpSILImSVymTQl9BQZq36QpCpJQnIwgbIGBioDh2cA\ AjCBpzAvBgcqA4dnAQIADCQ0OWE5NmFjZS1lMzlhLTRmZDItYmVjMS0xMzE2NWE5OTYy\ MWMwDAYHKgOHZwECAwEB/\ zBmBgcqA4dnAQIBBFswWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARCJUj4j7eC/\ 7Xso3REUscqHlWPvW9zvl5I6TIyzEXFsWxM0QxMuNW4oXE56UiCyJklcpk0JfQUGat+\ kKQqSUJyMB8GBSoDhngAMBYwFAYFKgOGeAEMC3BhcnRpdGlvbiAxMIIGoDCCBHowggNF\ MIIDQTCCAimgAwIBAgIUWWuyy9RGarWD+\ k6k4ZswYmQ7cQ0wDQYJKoZIhvcNAQELBQAwLzENMAsGA1UECgwESUVURjENMAsGA1UEC\ wwEUkFUUzEPMA0GA1UEAwwGQUsgUlNBMCAXDTI1MDExNzE3MTMwM1oYDzIwNTIwNjA0M\ TcxMzAzWjAvMQ0wCwYDVQQKDARJRVRGMQ0wCwYDVQQLDARSQVRTMQ8wDQYDVQQDDAZBS\ yBSU0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCw+\ egZQ6eumJKq3hfKfED4dE/tL4FI5sjqont9ABVI+\ 1GSqyi1bFBgsRjM0THllIdMbKmJtWwnKW8J+5OgNN8y6Xxv8JmM/\ Y5vQt2lis0fqXmG8UTz0VTWdlAXXmhUs6lSADvAaIe4RVrCsZ97L3ZQTryY7JRVcbB4k\ hUN3Gp0yg+801SXzoFTTa+UGIRLE66jH51aa5VXu99hnv1OiH8tQrjdi8mH6uG/\ icq4XuIeNWMF32wHqIOOPvQcWV3M5D2vxJEj702Ku6k9OQXkAo17qRSEonWW4HtLbtmS\ 8He1JNPc/n3dVUm+\ fM6NoDXPoLP7j55G9zKyqGtGAWXAj1MTAgMBAAGjUzBRMB0GA1UdDgQWBBSJGVleDvFp\ 9cu9R+E0/OKYzGkwkTAfBgNVHSMEGDAWgBSJGVleDvFp9cu9R+E0/\ OKYzGkwkTAPBgNVHRMBAf8EBTADAQH/\ MA0GCSqGSIb3DQEBCwUAA4IBAQBmzcTIPYhVNtMdrOb9ee9qYADlTuQl1y1mdrDPcC+\ zmwZuwKLJu89hvxmFdDrVNc6QsNKnH0fWtMZxU5UQTrqW2Wf0jLY3bjfJkCmTQahOK8X\ D3oQqfXVKCe+MGFUSh71BUXc4FIQzMJ6phG+5qiCqsD9BL/gFXf4ao+BI4SQhVWi6FR+\ JOBMxd91DYDyYr6NfddAbzaW7iDoVEWR1pvQAZbycWfv1KIY6ne2yQ0dSedOqIE9Odjq\ i2QkW4kD7qXRLYKcMPqe1SPao2xoS2Kz8SIdoLInLu7Cb3QC7n/\ oEbiK4JIVD29giMpudJ8gbBLLjwDrCls0yA+ng8n/\ wkki0MCsGCSqGSIb3DQEBCjAeoA0wCwYJYIZIAWUDBAIBoQ0wCwYJKoZIhvcNAQEIBII\ BAKt/0rD4VNqk6Gf9FpVc07mRDpO3DHQDz6gHfwQZOQnRTsa+\ 2Fm2dHbITMLCiEK5oIfVw54RypX2lh0nLZcpfLbtPAYnF2lrAy9L8fD0GsIK6XBqikwX\ hFriUSlQd0Fzc3AQ1mkstybRqzoCIJLvzyfw3YdbYuTfVGgUGG+\ edEzDTPB3jId8Vx0Aa+CUqmg6X2bWgW0i26EEM0FjAgxi2BkDxB01PqupQhJH/\ DVP0yiKAZIdkwFBAJYDJMMSL+6//\ 8EAfIPpgTbhsfyhFYNbnmf6kFbykCCPuZ4cgUSDml4TzLEhfc7uzCU/x3hbyDCDguBS/\ 7hntAoM1ZMXbtbdx7AwggIeMIIBuzCCAbcwggFdoAMCAQICFAep6a/8hKR/\ Xf8D7fMOi6OQH5W4MAoGCCqGSM49BAMCMDAxDTALBgNVBAoMBElFVEYxDTALBgNVBAsM\ BFJBVFMxEDAOBgNVBAMMB0FLIFAyNTYwIBcNMjUwMTE3MTcxNDI4WhgPMjA1MjA2MDQx\ NzE0MjhaMDAxDTALBgNVBAoMBElFVEYxDTALBgNVBAsMBFJBVFMxEDAOBgNVBAMMB0FL\ IFAyNTYwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARCJUj4j7eC/\ 7Xso3REUscqHlWPvW9zvl5I6TIyzEXFsWxM0QxMuNW4oXE56UiCyJklcpk0JfQUGat+\ kKQqSUJyo1MwUTAdBgNVHQ4EFgQUW3CnmBf3n/\ Y30vfj3ERsIQnXu9QwHwYDVR0jBBgwFoAUW3CnmBf3n/\ Y30vfj3ERsIQnXu9QwDwYDVR0TAQH/BAUwAwEB/\ zAKBggqhkjOPQQDAgNIADBFAiEAkH8Erj/\ TLNoEfJIvokEEDVmhH5f7UQHdrrCyQWEhJegCICRsy/1Vqjo3qg/WrHospwcB2PaHYy+\ FnH79mznqO7jVMBMGByqGSM49AgEGCCqGSM49AwEHBEgwRgIhAOQWrySDZn5zNF7il+\ VjzxY55Bq5vc0B+Yhy/dsQHnedAiEA0GxuEFQpJkDuoYcyMKOZrwk2dgy/yAI6iih0+\ cX8W6g=¶
This specification is the work of a design team created by the chairs of the RATS working group. This specification has been developed based on discussions in that design team and also with great amounts of input taken from discussions on the RATS mailing list.¶
We would like to thank Jeff Andersen for the review comments.¶