module ietf-voucher-request-prm {
yang-version 1.1;
namespace
"urn:ietf:params:xml:ns:yang:ietf-voucher-request-prm";
prefix "constrained";
import ietf-restconf {
prefix rc;
description
"This import statement is only present to access
the yang-data extension defined in RFC 8040.";
reference "RFC 8040: RESTCONF Protocol";
}
import ietf-voucher-request {
prefix vcr;
description
"This module defines the format for a voucher request,
which is produced by a pledge as part of the RFC8995
onboarding process.";
reference
"RFC 8995: Bootstrapping Remote Secure Key Infrastructure";
}
organization
"IETF ANIMA Working Group";
contact
"WG Web:
WG List:
Author: Steffen Fries
Author: Eliot Lear
Author: Thomas Werner
Author: Michael Richardson
";
description
"This module defines an extension of the RFC8995 voucher
request to permit a registrar-agent to convey the adjacency
relationship from the registrar-agent to the registrar.
The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL',
'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY',
and 'OPTIONAL' in the module text are to be interpreted as
described in RFC 2119.";
revision 2021-08-19 {
description
"Initial version";
reference
"RFC XXXX: VBRSKI for Pledge in Responder Mode";
}
rc:yang-data voucher-request-prm-artifact {
// YANG data template for a voucher-request.
uses voucher-request-prm-grouping;
}
// Grouping defined for future usage
grouping voucher-request-prm-grouping {
description
"Grouping to allow reuse/extensions in future work.";
uses vcr:voucher-request-grouping {
augment voucher {
description "Base the voucher-request-prm upon the
regular one";
leaf agent-signed-data {
type binary;
description
"The agent-signed-data field contains a JOSE [RFC7515]
object provided by the Registrar-Agent to the Pledge.
This artifact is signed by the Registrar-Agent
and contains a copy of the pledge's serial-number.";
}
leaf agent-provided-proximity-registrar-cert {
type binary;
description
"An X.509 v3 certificate structure, as specified by
RFC 5280, Section 4, encoded using the ASN.1
distinguished encoding rules (DER), as specified
in ITU X.690.
The first certificate in the registrar TLS server
certificate_list sequence (the end-entity TLS
certificate; see RFC 8446) presented by the
registrar to the registrar-agent and provided to
the pledge.
This MUST be populated in a pledge's voucher-request
when an agent-proximity assertion is requested.";
reference
"ITU X.690: Information Technology - ASN.1 encoding
rules: Specification of Basic Encoding Rules (BER),
Canonical Encoding Rules (CER) and Distinguished
Encoding Rules (DER)
RFC 5280: Internet X.509 Public Key Infrastructure
Certificate and Certificate Revocation List (CRL)
Profile
RFC 8446: The Transport Layer Security (TLS)
Protocol Version 1.3";
}
leaf agent-sign-cert {
type binary;
description
"An X.509 v3 certificate structure, as specified by
RFC 5280, Section 4, encoded using the ASN.1
distinguished encoding rules (DER), as specified
in ITU X.690.
This certificate can be used by the pledge,
the registrar, and the MASA to verify the signature
of agent-signed-data. It is an optional component
for the pledge-voucher request.
This MUST be populated in a registrar's
voucher-request when an agent-proximity assertion
is requested.";
reference
"ITU X.690: Information Technology - ASN.1 encoding
rules: Specification of Basic Encoding Rules (BER),
Canonical Encoding Rules (CER) and Distinguished
Encoding Rules (DER)
RFC 5280: Internet X.509 Public Key Infrastructure
Certificate and Certificate Revocation List (CRL)
Profile";
}
}
}
}
}