You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Update 04-integration-model.md
Modifications proposed by DavSanOl
* Update blueprint/04-integration-model.md
Co-authored-by: DavSanOl <144360010+DavSanOl@users.noreply.github.com>
* Update blueprint/04-integration-model.md
Co-authored-by: DavSanOl <144360010+DavSanOl@users.noreply.github.com>
* Update blueprint/04-integration-model.md
Co-authored-by: DavSanOl <144360010+DavSanOl@users.noreply.github.com>
* Update blueprint/04-integration-model.md
Co-authored-by: DavSanOl <144360010+DavSanOl@users.noreply.github.com>
* Update blueprint/04-integration-model.md
Co-authored-by: DavSanOl <144360010+DavSanOl@users.noreply.github.com>
* Update 04-integration-model.md
@SRakshieva@DavSanOl - The mermaid sequence diagram wasn't working. And I moved the todos in this doc to a first section. Haven't made change to the texts.
---------
Co-authored-by: Sarah Amandusson <80251383+Saramandus@users.noreply.github.com>
Co-authored-by: DavSanOl <144360010+DavSanOl@users.noreply.github.com>
Co-authored-by: Sander Dijkhuis <mail@sanderdijkhuis.nl>
- High-Level Flows - Revocation and status checking
8
+
- PID issuing
9
+
- The Technical Languages We Use: List of integration points that will be formalized in Conformance Specifications.
10
+
- Signature and Seal Integration: To be authored by Group 6 (QTSP). Explains the technical flows for wallet-centric and QTSP-centric (remote) signing/sealing, allowing individuals to sign on behalf of a company with full legal effect
11
+
- Secure communication channel: To be authored by the QTSP group in consultation with the Architecture and Wallets groups. Explains the technical flows for usage of the qualified electronic registered delivery service (QERDS).
2
12
3
-
## Our Shared Design Principles
4
-
Modularity, standardization, versioning.
5
-
6
-
## High-Level Flows
7
-
- Credential issuance
8
-
- Presentation & verification
9
-
- Revocation and status checking
10
-
11
-
### General PID issuing process
12
-
Todo: EUDI: ARF
13
-
EBW: the issuing we do
14
-
This chapter describes the general **WE BUILD PID/EBWOID issuing process** in a sequence diagram.
15
-
Todo: Mention ETSI standardization: ETSI TS 119 472-3 for (Q)EAA and PID issuance. ETSI TS 119 476-3 will standardize WUA and WIA.
16
13
17
14
## The Technical Languages We Use
18
15
List of integration points that will be formalized in Conformance Specifications.
19
16
20
17
## Interaction Pattern: Attestation Issuance
21
18
To be authored by Group 6 (QTSP) and Group 7 (Wallets). Focuses on how use cases get data into the wallet (e.g., PID or QEAA) using protocols like OpenID4VCI (but no need to mention that part, stuff like that should be mainly in CS).
22
19
23
-
The [WE BUILD Conformance Specification for Credential Issuance](https://github.com/webuild-consortium/wp4-architecture/blob/main/conformance-specs/cs-01-credential-issuance.md) describes high assurance credential issuance. The aim is to ensure that Wallet Units and Credential Issuers within the WE BUILD ecosystem interoperate consistently for the issuance of verifiable digital credentials with high security and privacy.
20
+
The [WE BUILD Consortium Conformance Specification (CS)](https://github.com/webuild-consortium/wp4-architecture/blob/blueprint/updates-jan/conformance-specs/cs-01-credential-issuance.md) for high-assurance credential issuance defines the requirements that will be applied within the WE BUILD project to ensure that Wallet Units and Credential Issuers across the WE BUILD ecosystem interoperate reliably and consistently when issuing verifiable digital credentials, with strong security guarantees and privacy protections.
21
+
22
+
The WE BUILD ecosystem mainly supports two credential issuance models, which differ in which actor inititates the process: wallet-initiated issuance and issuer-initiated-issuance In both cases, if the credential cannot be issued immediately, a deferred issuance mechanism is applied. In such case, the wallet will automatically make periodic retries until the credential is successfully issued or until it receives an unrecoverable error.
23
+
24
+
### Wallet-initiated issuance
25
+
26
+
This issuance flow is initiated by the wallet user:
27
+
28
+
1. The user opens their wallet and selects the credential type to be issued (for example, a PID or a QEAA).
29
+
2. The wallet connects with the corresponding issuer and requests the credential.
30
+
3. The wallet user authenticates with the issuer, following the procedure specified by the issuer itself.
31
+
4. The issuer requests the user's consent from the user to issue the credential and send it to their wallet.
32
+
5. The issuer generates the credential and delivers it to the wallet.
33
+
6. The wallet verifies the authenticity of the credential and stores it. From this point, the wallet user becomes responsible for managing the issued credential.
34
+
35
+
```mermaid
36
+
sequenceDiagram
37
+
participant User
38
+
participant Wallet
39
+
participant Issuer
40
+
41
+
User->>Wallet:Selects the credential type
42
+
Wallet-->>Issuer: Requests the credential
43
+
Issuer->>User: Requests authentication
44
+
User->>Issuer: Authentication
45
+
Issuer->>User: Requests consent
46
+
User->>Issuer: Gives consent
47
+
Issuer-->>Issuer: Generates the credential
48
+
Issuer-->>Wallet: Sends the credential
49
+
Wallet-->>Wallet: Validates the credential
50
+
Wallet-->>Wallet: Stores the credential
51
+
User->>Wallet: Accesses the credential
52
+
```
53
+
54
+
### Issuer-initiated issuance
55
+
56
+
This issuance flow is initiated by the issuer:
57
+
58
+
1. The user interacts with the issuer (for example, during a digital onboarding process).
59
+
2. The issuer prepares one or more credentials.
60
+
3. The issuer offers these credentials to the wallet user. This can be done in several ways, both same-device and cross-device:
61
+
- By displaying a QR code that the user shall scan with their wallet.
62
+
- By sending a link to the wallet.
63
+
4. The wallet displays the offer and requess confirmation from the user.
64
+
5. The wallet user authenticates with the issuer, following the procedure specified by the issuer itself.
65
+
6. The issuer requests the user's consent from the user to issue the credential and send it to their wallet.
66
+
7. The issuer generates the credential and delivers it to the wallet.
67
+
8. The wallet verifies the authenticity of the credential and stores it. From this point, the wallet user becomes responsible for managing the issued credential.
68
+
69
+
```mermaid
70
+
sequenceDiagram
71
+
participant User
72
+
participant Wallet
73
+
participant Issuer
74
+
75
+
User->>Issuer: Interacts digitally
76
+
Issuer-->>Issuer: Prepares the credential
77
+
Issuer->>User: Offers the credential diplaying a QR code
To be authored by Architecture and Wallets. This is the "Receiving" flow for Relying Parties, detailing how they request and receive verified attributes under the user's sole control using OpenID4VP.
27
95
28
96
The [WE BUILD Conformance Specification for Credential Presentation](https://github.com/webuild-consortium/wp4-architecture/blob/main/conformance-specs/cs-02-credential-presentation.md) describes how Wallet Units (WU) and Verifiers interoperate within the WE BUILD ecosystem. It covers presentation (request and response flows), interfaces between wallets and verifiers as well as security, privacy and interoperability requirements and same‑device and cross‑device invocation patterns
29
97
30
-
## Signature and Seal Integration
31
-
32
98
## Secure communication channel
33
99
In WE BUILD, the secure communication channel will be implemented through Qualified Electronic Registered Delivery Services (QERDS) operated by QTSPs. The core idea will be that whenever a message will need legal-grade delivery assurance (who sent what, to whom, and when it was received), it will be routed through QERDS so that delivery will be registered and can later be proven to a relying party. The QERDS providers also ensure mutual authentication, end-to-end integrity and confidentiality, and interoperability across access points. This “registered delivery” pattern will be positioned as an enabler for interactions between and across public sector bodies and economic operators.
34
100
@@ -49,4 +115,4 @@ WE BUILD will follow the QERDS architecture decomposition and the 4-corner deliv
49
115
6) Consignment and handover of the message and its metadata will be performed to the recipient’s wallet or connected backend system.
50
116
7) Evidence will be made accessible to sender and recipient wallets (submission/dispatch and receipt/consignment or non-delivery). Evidence will be protected by qualified sealing and, where required, qualified timestamping. Where applicable, the evidence can be pushed to the sender’s and the recipient’s backend systems as well.
0 commit comments