diff --git a/docs/static/openapi.yml b/docs/static/openapi.yml index 54014917b..7da3e0926 100644 --- a/docs/static/openapi.yml +++ b/docs/static/openapi.yml @@ -10705,6 +10705,8 @@ paths: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string pagination: type: object properties: @@ -10863,6 +10865,8 @@ paths: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string default: description: An unexpected error response. schema: @@ -10935,6 +10939,8 @@ paths: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string default: description: An unexpected error response. schema: @@ -21841,6 +21847,8 @@ definitions: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string zigbeealliance.distributedcomplianceledger.pki.PkiRevocationDistributionPointsByIssuerSubjectKeyID: type: object properties: @@ -21881,6 +21889,8 @@ definitions: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string zigbeealliance.distributedcomplianceledger.pki.ProposedCertificate: type: object properties: @@ -22284,6 +22294,8 @@ definitions: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string pagination: type: object properties: @@ -23029,6 +23041,8 @@ definitions: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string zigbeealliance.distributedcomplianceledger.pki.QueryGetPkiRevocationDistributionPointsByIssuerSubjectKeyIDResponse: type: object properties: @@ -23072,6 +23086,8 @@ definitions: schemaVersion: type: integer format: int64 + crlSignerDelegator: + type: string zigbeealliance.distributedcomplianceledger.pki.QueryGetProposedCertificateResponse: type: object properties: diff --git a/docs/transactions.md b/docs/transactions.md index d918935d7..37838a026 100644 --- a/docs/transactions.md +++ b/docs/transactions.md @@ -1007,7 +1007,7 @@ Publishes a PKI Revocation distribution endpoint (such as RFC5280 Certificate Re If `crlSignerCertificate` is a PAA (root certificate), then it must be present on DCL. -If `crlSignerCertificate` is a PAI (intermediate certificate), then it must be chained back to a valid PAA (root certificate) present on DCL. +If `crlSignerCertificate` is a PAI (intermediate certificate) or delegated by PAA, then it must be chained back to a valid PAA (root certificate) present on DCL. In this case `crlSignerCertificate` is not required to be present on DCL, and will not be added to DCL as a result of this transaction. If PAI needs to be added to DCL, it should be done via [ADD_PAI](#add_pai) transaction. @@ -1024,7 +1024,8 @@ and DACs (leaf certificates) added to DCL if they are revoked in the CRL identif - pid: `optional(uint16)` - Product ID (positive non-zero). Must be empty if `IsPAA` is true. Must be equal to a `pid` field in `CRLSignerCertificate`. - isPAA: `bool` - True if the revocation information distribution point relates to a PAA - label: `string` - A label to disambiguate multiple revocation information partitions of a particular issuer. - - crlSignerCertificate: `string` - The issuer certificate whose revocation information is provided in the distribution point entry, encoded in X.509v3 PEM format. The corresponding CLI parameter can contain either a PEM string or a path to a file containing the data. + - crlSignerCertificate: `string` - The issuer certificate whose revocation information is provided in the distribution point entry, encoded in X.509v3 PEM format. The corresponding CLI parameter can contain either a PEM string or a path to a file containing the data. Please note that if crlSignerCertificate is a delegated certificate by a PAI, the delegator certificate must be provided using the `crlSignerDelegator` field. + - crlSignerDelegator: `optional(string)` - If crlSignerCertificate is a delegated certificate by a PAI, then crlSignerDelegator must contain the delegator PAI certificate which must be chained back to an approved certificate in the ledger, encoded in X.509v3 PEM format. Otherwise this field can be omitted. The corresponding CLI parameter can contain either a PEM string or a path to a file containing the data. - issuerSubjectKeyID: `string` - Uniquely identifies the PAA or PAI for which this revocation distribution point is provided. Must consist of even number of uppercase hexadecimal characters ([0-9A-F]), with no whitespace and no non-hexadecimal characters., e.g: `5A880E6C3653D07FB08971A3F473790930E62BDB`. - dataUrl: `string` - The URL where to obtain the information in the format indicated by the RevocationType field. Must start with either `http` or `https`. Must be unique for all pairs of VendorID and IssuerSubjectKeyID. - dataFileSize: `optional(uint64)` - Total size in bytes of the file found at the DataUrl. Must be omitted if RevocationType is 1. @@ -1037,7 +1038,7 @@ and DACs (leaf certificates) added to DCL if they are revoked in the CRL identif - `pki/RevocationDistributionPoint/value///