Verifier
caution
This page has been moved to the eSSIF-Lab Framework on Github.
Short Description
A Verifier is is an (architectural) function (a functional component in the eSSIF-Lab functional architecture) that supports the Transaction Data Collector as it tries to acquire (verifiable) credentials from (an agent of) some other party, for the purpose of negotiating a business transaction.
It does so by:
- creating Presentation Requests (or Presentation Definition as it is called in the draft DIF specfication for Presentation Exchange) that ask for such credentials,
- sending them to an agent of that other party that provides holder functionality,
- receiving a response from that agent to the presentation request (i.e. a 'Presentation'),
- verifying that presentation, i.e. checking the signature and other proofs of the veracity of both the construction of the presentation and its contents
- returning the data that the Transaction Data Collector requested, optionally with a report about which verification checks succeeded and/or which failed.
Editor's note
TNO (or others) to provide additional content of this file.
Purpose
The purpose of the Verifier function is.
Criteria
A Verifier is a component in the eSSIF-Lab functional architecture whose function is to ... (tbd).
Functionality
The purpose of the Verifier component is to support the Transaction Data Collector by providing it with a single, simple API that it can use to request and obtain data that it needs to produce a clean transaction form, as well as the results of checking verification proofs (this is also why it is called the 'verifier' component).
Typically, the Transaction Data Collector would ask the Verifier to provide a credential that it can use to fill in a (coherent set of) field(s) in the transaction form. It is realistic to think that credentials from different issuers - trusted by the Verifier's Principal - can be used for this purpose. However, it is also realistic that such credentials will not use the same credential definition - they might well use different schemes to provide such data. Therefore, the Transaction Data Collector should specify a list of pairs (credential-type, issuer) instances of which could all be used to provide the data it needs - which it can obtain from the Transaction Data Collector policy.
Then, the Verifier needs to know the address and protocol that it can use to reach a Holder component owned by the party that its Principal is trying to negotiate the transaction with. The Transaction Data Collector specifies this as part of the request - and it can do so because it has received the original request, and does all communication channel handling.
Verifiers are not expected to handle every kind of credential (e.g. VC's, ABC's, etc.) that exists, but rather a specific subset. For (at least one of) the credential types, the Verifier can construct a so-called presentation request, i.e. a message that is specific for the credential type and/or associated protocol, which it can then send to the Holder's address.
This request message should contain at least
- the transaction-id, so that when it is copied into the associated response message, the latter can be associated to the transaction it belongs to. Also, it should contain the
- the (credential type, issuer) pairs that may satisfy the request, and to each of these additional data, e.g. the URI of the endpoint where the issuer issues such credentials, the maximum age of the credential, etc.
- meta-data that may be useful for the holder (or its Principal), e.g. texts stating the purpose(s) for which the data will be used (GDPR Art. 5.1.b), or requesting consent (GDPR Art. 7.2) “in an intelligible and easily accessible form, using clear and plain language”.
- a signature of the Verifiers Principal, for the purpose of showing compliance with the GDPR (e.g. Art 28.3.h), and enabling the Holder's Principal to obtain proof that the Verifiers Principal has violated the GDPR's minimization principle asked for data for a particular purpose, which can be used in an argument in disputes about data minimization (GDPR Art. 5.1.c).
The request message must be designed in such a way that it is extendable as new features will be called for in the future.
In order to make the Verifier component work, a Verifier Policy/Preferences object is created by, or on behalf of the Principal, which specifies at least: [to be elaborated]
A response to this request (called a Presentation) will be obtained from a Holder component of the Peer party. This response will contain a reference to the request, allowing the Verifier to combine them. The Verifier will then check that the data in the response is a credential that it has asked for (correct type/issuer), verify the proofs that are provided (predominantly the digital signature), and do some additional checks (e.g. whether or not the credential has expired, is revoked, and such).
Then, the verifier will send a message to the Transaction Data Collector, containing the transaction-id, the data it has received, and the results of the various checks.