Merge pull request #95 from jimmarino/feat/cleanup-vpp

feat: Cleanup and reorganize VPP section

specifications/auth.flow.puml

@@ -8,6 +8,7 @@ autonumber
 box "Client Entity"
 participant "Client" as C
 participant "Secure Token Service" as STS
+participant "DID Service" as DS
 participant "Credential Service" as CS
 end box
 
@@ -18,7 +19,10 @@ end box
 C -> STS: SI token request
 STS -> C: Token response w/ access token
 
-C-> V: Request w/ si token and access token
-V-> CS: request w/ access token
+C -> V: Request w/ Self-Issued ID token containing an access token
+DS <- V: Resolve DID
+DS -> V: DID document response
+CS <- V: request w/ access token
 CS ->V: VP response
+C <- V: Response
 @enduml

specifications/base.protocol.md

@@ -23,9 +23,9 @@ prescribes the Participant ID MUST be a DID as described in [[did-core]].
 
 ## Self-Issued ID Tokens
 
-Participants use Self-Issued ID Tokens to authenticate themselves and present self-attested claims to a Verifier.
-A Self-Issued ID Token is represented as a JSON Web Token [[rfc7519]] signed with a private key under the participant's
-control.
+Participants use a <dfn>Self-Issued ID Token</dfn> to authenticate themselves and present self-attested claims to a
+Verifier. A Self-Issued ID Token is represented as a JSON Web Token [[rfc7519]] signed with a private key under the
+participant's control.
 
 The following claims MUST be included in the Self-Issued ID Token:
 
@@ -103,3 +103,9 @@ contexts that facilitate this approach to interoperability.
 The [[[json-ld11]]] context URI for the specification is: `https://w3id.org/dspace-dcp/v[version]`. The `version`
 indicates a [Semantic Versioning](https://semver.org/) `MAJOR.MINOR` number. The current specifications use `0.8`
 version and the following context URI: `https://w3id.org/dspace-dcp/v0.8`.
+
+# The Base URL
+
+All endpoint URLs in this specification are relative. The base URL is implementation-specific and may include
+additional context information such as a sub-path that disambiguates a holder.
+

specifications/terminology.md

@@ -1,3 +1,17 @@
 # Terminology
 
-The following terms are used to describe concepts in this specification.
+The following terms are used to describe concepts in this specification.
+
+- <dfn>DID</dfn> - A decentralized identifier as defined by [[[did-core]]].
+- <dfn>Holder</dfn> - An entity that possesses a set of identity resources as defined by [[[vc-data-model]]].
+  The holder will typically be the subject of a [=Verifiable Credential=].
+- <dfn>Resource</dfn> - A resource is an entity managed by the Credential Service such as a [=Verifiable Credential=]
+  or [=Verifiable Presentation=].
+- <dfn>Subject</dfn> - The target of a set of claims contained in a [=Verifiable Credential=] as defined
+  by [[[vc-data-model]]]. In a dataspace, a subject will be a participant.
+- <dfn data-lt="Verifiable Credential | Verifiable Credentials">Verifiable Credential</dfn> A tamper-evident credential
+  whose authorship can be cryptographically verified as defined by [[[vc-data-model]]].
+- <dfn data-lt="Verifiable Presentation | Verifiable Presentations">Verifiable Presentation</dfn> A tamper-evident
+  presentation of information whose authorship can be cryptographically verified as defined by [[[vc-data-model]]].
+- <dfn>Verifier</dfn> - An entity that receives a [=Verifiable Credential=], optionally presented inside
+  a [=Verifiable Presentation=] as defined by [[[vc-data-model]]].