From 649ba09e7bc1f8e83242524b549aa26997280222 Mon Sep 17 00:00:00 2001 From: Darrell O'Donnell Date: Thu, 28 Mar 2024 06:19:37 -0700 Subject: [PATCH 1/4] bullets for reqts Signed-off-by: Darrell O'Donnell --- spec/requirements.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/spec/requirements.md b/spec/requirements.md index 5534a36..89e667b 100644 --- a/spec/requirements.md +++ b/spec/requirements.md @@ -53,8 +53,10 @@ The following queries relate to configuration of systems that will interact with TODO: Add normative ref to [ToIP Governance Architecture Specification](https://wiki.trustoverip.org/pages/viewpage.action?pageId=71241) * [GA-4] MUST publish, in the [[xref: TOIP, DID document]] associated with the **DID** identifying its **EGF**, a [[ref: service property]] specifying the [[ref: service endpoint]] for its [[ref: primary trust registry]] that meets the requirements in the _[Trust Registry Service Property](#trust-registry-service-property)_ section. -[GA-5] MUST publish in its EGF a list of any other EGFs governing [[ref: secondary trust registries]]. -[GA-6] MUST specify in the EGF any additional requirements for an [[ref: authorized trust registry]]. This data will be comprised of the following elements:: + +* [GA-5] MUST publish in its EGF a list of any other EGFs governing [[ref: secondary trust registries]]. + +* [GA-6] MUST specify in the EGF any additional requirements for an [[ref: authorized trust registry]]. This data will be comprised of the following elements:: * [GA-6-1] SHOULD provide Information Trust requirements. * [GA-6-2] SHOULD provide Technical requirements. @@ -145,12 +147,14 @@ The authoritative technical specifications for the API calls in the ToIP Trust R ### Anti-Requirements -[AR-1] SHALL NOT support query operations for the history of a [[ref: registered entity]]. +The following are considered anti-requirements in that they have been considered in the current design of the TRP: + +* [AR-1] SHALL NOT support query operations for the history of a [[ref: registered entity]]. -[AR-2] SHALL NOT include support for a DIDComm interface, only a RESTful (i.e. OpenAPI Specification) interface. When a repeatable **trust task** specification approach is created, a DIDComm/**trust task** approach should be considered as a work effort. +* [AR-2] SHALL NOT include support for a DIDComm interface, only a RESTful (i.e. OpenAPI Specification) interface. When a repeatable **trust task** specification approach is created, a DIDComm/**trust task** approach should be considered as a work effort. -[AR-3]]SHALL NOT support automated rules processing in the protocol. A rules engine can certainly use the protocol. +* [AR-3]]SHALL NOT support automated rules processing in the protocol. A rules engine can certainly use the protocol. -[AR-4] Anything other than read-only operations. The TRP is a read-only (RETRIEVE in the CRUD sense) protocol. +* [AR-4] Anything other than read-only operations. The TRP is a read-only (RETRIEVE in the CRUD sense) protocol. From 45ac275c8a2fc2446f64f29cf2caab5ae8a69b9e Mon Sep 17 00:00:00 2001 From: Darrell O'Donnell Date: Thu, 28 Mar 2024 06:41:13 -0700 Subject: [PATCH 2/4] tweaks Signed-off-by: Darrell O'Donnell --- spec/requirements.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/spec/requirements.md b/spec/requirements.md index 89e667b..fce265a 100644 --- a/spec/requirements.md +++ b/spec/requirements.md @@ -66,7 +66,7 @@ TODO: Add normative ref to [ToIP Governance Architecture Specification](https:// - [GA-7-1] MUST provide all [[ref: authorization]] values that are used by the trust registry. - [GA-7-2] MUST provide all [[xref: TOIP, assurance levels]], specified with unique names, that are service by the trust registry, and what [[ref: authorization]] values they apply to. - [GA-7-3] MUST provide a list of all [[ref: VID Types]] that are supported by the ecosystem, and serviced by the trust registry. - - [GA-7-4] SHOULD provide `resources (TODO: TERM IS VAGUE)` that are required by systems integrating into the ecosystem that the system serves. + - [GA-7-4] SHOULD provide `resources` (e.g. logo files, documents, interoperability profile information) that are required by systems integrating into the ecosystem that the system serves. - [GA-7-5] `???any metadata required by implementors (e.g. claim name that is mandatory if pointing a credential back to an EGF.) [this is a weak example]???` - [GA-7-6] `???a statement about the basis the trust registry claims to be authoritative???` - [GA-7-7] `???means by which others are able to verify the asserted authority???` @@ -124,7 +124,7 @@ The authoritative technical specifications for the API calls in the ToIP Trust R ::: ::: TODO: - Align VID or DID terminology. + Align VID and/or DID terminology. ::: [TRP-4] MUST return responses using the data model specified in the OpenAPI Specification . From 10c79d4a5c6cce23a255ad25d55fdaaee574045f Mon Sep 17 00:00:00 2001 From: Darrell O'Donnell Date: Wed, 3 Apr 2024 11:14:55 -0700 Subject: [PATCH 3/4] implementers review Signed-off-by: Darrell O'Donnell --- spec/header.md | 15 +++++++-------- spec/normative_references.md | 2 +- spec/requirements.md | 4 +--- 3 files changed, 9 insertions(+), 12 deletions(-) diff --git a/spec/header.md b/spec/header.md index 347cfe8..dd7bfa2 100644 --- a/spec/header.md +++ b/spec/header.md @@ -11,25 +11,24 @@ :--- | :-------------- [**Document Type**](https://wiki.trustoverip.org/display/HOME/ToIP+Deliverable+Types%2C+Stages%2C+and+Processes) | *Specification* **Document Status** | *Draft* -**Document Purpose** | *Working Draft* +**Document Purpose** | *Implementers Review Draft* + -::: todo -Shift `Document Purpose` to Implementer Review Draft before going to Implementer Review. -::: **Note to Implementers and Reviewers** -The intent of this Implementers Review Draft Deliverable is to drive input for the specification. Comments are appreciated and encouraged. During the Implementers Review period (TODO: list dates) feedback may be dispositioned rapidly. +The intent of this Implementers Review Draft Deliverable is to drive input for the specification. Comments are appreciated and encouraged. During the Implementers Review period (2024-04-03 to 2024-06-03) feedback may be dispositioned rapidly. Provide input via: * [GitHub Issues](https://github.com/trustoverip/tswg-trust-registry-protocol/issues) - for items that need to be tracked. These will be formally dispositioned. * [GitHub Discussions](https://github.com/trustoverip/tswg-trust-registry-protocol/discussions) - for items that are more discussion level. -::: todo -TODO: complete this preamble. @darrellodonnell -::: +This protocol is currently focused on read-only operations. + + + **Source/Resources:** diff --git a/spec/normative_references.md b/spec/normative_references.md index db96e08..5366394 100644 --- a/spec/normative_references.md +++ b/spec/normative_references.md @@ -14,7 +14,7 @@ * * -TODO: Finish up alignging with `spec-up` spec linkging + [[spec-norm]] diff --git a/spec/requirements.md b/spec/requirements.md index fce265a..c89af85 100644 --- a/spec/requirements.md +++ b/spec/requirements.md @@ -119,9 +119,7 @@ The authoritative technical specifications for the API calls in the ToIP Trust R - ii. [TRP-3-2] **Recognized Registry:** Given the entityDID the system SHOULD return the list of [[def:trust registries]] that the entity has indicated it is registered in. - [TRP-3-2-1] The system MUST NOT return more than one trust registry in the array designated as a [[def: primary registry]]. -::: TODO: - CREATE TrustRegistryType and TrustRegistryListType in OAS. -::: + ::: TODO: Align VID and/or DID terminology. From 4789dc05efb62a2c8ebe983ecdf41d2b5be2ff30 Mon Sep 17 00:00:00 2001 From: Darrell O'Donnell Date: Wed, 3 Apr 2024 12:38:02 -0700 Subject: [PATCH 4/4] Update spec/header.md Co-authored-by: Drummond Reed --- spec/header.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec/header.md b/spec/header.md index 268d0cc..b55dda5 100644 --- a/spec/header.md +++ b/spec/header.md @@ -11,7 +11,7 @@ :--- | :-------------- [**Document Type**](https://wiki.trustoverip.org/display/HOME/ToIP+Deliverable+Types%2C+Stages%2C+and+Processes) | *Specification* **Document Status** | *Draft* -**Document Purpose** | *Implementers Review Draft* +**Document Purpose** | *Implementers Draft*