Skip to content

Commit 3e0ff58

Browse files
committed
Changed structure
1 parent 4a50032 commit 3e0ff58

File tree

8 files changed

+198
-178
lines changed

8 files changed

+198
-178
lines changed

docs/transactions.md

+171-172
Large diffs are not rendered by default.
File renamed without changes.
File renamed without changes.
File renamed without changes.

docs/pki.md docs/transactions/pki.md

+27-6
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,24 @@ Should be sent to trusted nodes only.
4646
- REST API:
4747
- GET `/dcl/pki/all-certificates`
4848

49+
#### GET_ALL_CERTS_BY_SUBJECT
50+
51+
**Status: Implemented**
52+
53+
Gets all certificates associated with a subject. This query works for all types certificates (PAA, PAI, RCAC, ICAC).
54+
55+
Revoked certificates are not returned.
56+
Use [GET_ALL_REVOKED_DA_CERTS](#get_all_revoked_da_certs) to get a list of all revoked DA certificates.
57+
Use [GET_ALL_REVOKED_NOC_ROOT_CERTS](#get_all_revoked_noc_root-rcacs) to get a list of all revoked Noc Root certificates.
58+
Use [GET_ALL_REVOKED_NOC_ICA_CERTS](#get_all_revoked_noc_ica-icacs) to get a list of all revoked Noc ICA certificates.
59+
60+
- Parameters:
61+
- subject: `string` - certificates's `Subject` is base64 encoded subject DER sequence bytes
62+
- CLI command:
63+
- `dcld query pki all-subject-certs --subject=<base64 string>`
64+
- REST API:
65+
- GET `/dcl/pki/all-certificates/{subject}`
66+
4967
#### GET_CHILD_CERTS
5068

5169
**Status: Implemented**
@@ -113,6 +131,7 @@ The PAA certificate is not active until sufficient number of Trustees approve it
113131
- time: `optional(int64)` - proposal time (number of nanoseconds elapsed since January 1, 1970 UTC). This field cannot be specified using a CLI command and will use the current time by default.
114132
- In State:
115133
- `pki/AllCertificates/value/<Certificate's Subject>/<Certificate's Subject Key ID>`.
134+
- `pki/AllCertificatesBySubject/value/<Subject>`.
116135
- `pki/ApprovedCertificates/value/<Certificate's Subject>/<Certificate's Subject Key ID>`.
117136
- `pki/ApprovedCertificatesBySubject/value/<Certificate's Subject>`
118137
- `pki/ApprovedCertificatesBySubjectKeyId/value/<Certificate's Subject Key ID>`.
@@ -693,6 +712,7 @@ This transaction adds a NOC root certificate (RCAC) owned by the Vendor.
693712
- schemaVersion: `optional(uint16)` - Certificate's schema version to support backward/forward compatability. Should be equal to 0 (default 0)
694713
- In State:
695714
- `pki/AllCertificates/value/<Subject>/<SubjectKeyID>`
715+
- `pki/AllCertificatesBySubject/value/<Subject>`
696716
- `pki/NocCertificates/value/<Subject>/<SubjectKeyID>`
697717
- `pki/NocRootCertificates/value/<VID>`
698718
- `pki/NocCertificatesBySubject/value/<Subject>`
@@ -779,6 +799,7 @@ already present on the ledger.
779799
- certificate-schema-version: `optional(uint16)` - Certificate's schema version to support backward/forward compatability(default 0)
780800
- In State:
781801
- `pki/AllCertificates/value/<Subject>/<SubjectKeyID>`
802+
- `pki/AllCertificatesBySubject/value/<Subject>`
782803
- `pki/NocCertificates/value/<Subject>/<SubjectKeyID>`
783804
- `pki/NocIcaCertificates/value/<VID>`
784805
- `pki/NocCertificatesBySubject/value/<Subject>`
@@ -847,7 +868,7 @@ Use [GET_REVOKED_NOC_ICA](#get_revoked_noc_ica-icac) to get a revoked ica certif
847868
- CLI command:
848869
- `dcld query pki noc-x509-cert --subject=<base64 string> --subject-key-id=<hex string>`
849870
- REST API:
850-
- GET `/dcl/pki/noc-certificates/{subject}/{subject_key_id}`
871+
- GET `/dcl/pki/all-noc-certificates/{subject}/{subject_key_id}`
851872

852873
#### GET_NOC_ROOT_BY_VID (RCACs)
853874

@@ -864,7 +885,7 @@ Use [GET_ALL_REVOKED_NOC_ROOT](#get_all_revoked_noc_root-rcacs) to get a list of
864885
- CLI Command:
865886
- `dcld query pki noc-x509-root-certs --vid=<uint16>`
866887
- REST API:
867-
- GET `/dcl/pki/noc-root-certificates/{vid}`
888+
- GET `/dcl/pki/noc-vid-root-certificates/{vid}`
868889

869890
#### GET_NOC_BY_VID_AND_SKID (RCACs/ICACs)
870891

@@ -884,7 +905,7 @@ Use [GET_ALL_REVOKED_NOC_ICA](#get_all_revoked_noc_ica-icacs) to get a list of a
884905
- CLI Command:
885906
- `dcld query pki noc-x509-certs --vid=<uint16> --subject-key-id=<hex string>`
886907
- REST API:
887-
- GET `/dcl/pki/noc-certificates/{vid}/{subject_key_id}`
908+
- GET `/dcl/pki/noc-vid-certificates/{vid}/{subject_key_id}`
888909

889910
#### GET_NOC_ICA_BY_VID (ICACs)
890911

@@ -901,7 +922,7 @@ Use [GET_ALL_REVOKED_CERT](#get_all_revoked_certs) to get a list of all revoked
901922
- CLI Command:
902923
- `dcld query pki noc-x509-ica-certs --vid=<uint16>`
903924
- REST API:
904-
- GET `/dcl/pki/noc-ica-certificates/{vid}`
925+
- GET `/dcl/pki/noc-vid-ica-certificates/{vid}`
905926

906927
#### GET_NOC_CERTS_BY_SUBJECT
907928

@@ -918,7 +939,7 @@ Use [GET_ALL_REVOKED_NOC_ICA](#get_all_revoked_noc_ica-icacs) to get a list of a
918939
- CLI command:
919940
- `dcld query pki all-noc-subject-x509-certs --subject=<base64 string>`
920941
- REST API:
921-
- GET `/dcl/pki/noc-certificates/{subject}`
942+
- GET `/dcl/pki/all-noc-certificates/{subject}`
922943

923944
#### GET_REVOKED_NOC_ROOT (RCAC)
924945

@@ -968,7 +989,7 @@ Use [GET_ALL_REVOKED_NOC_ICA](#get_all_revoked_noc_ica-icacs) to get a list of a
968989
- CLI Command:
969990
- `dcld query pki all-noc-x509-certs`
970991
- REST API:
971-
- GET `/dcl/pki/noc-certificates`
992+
- GET `/dcl/pki/all-noc-certificates`
972993

973994
#### GET_ALL_NOC_ROOT (RCACs)
974995

File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)