Verify Link
info
Please note that this content is under development and is not ready for implementation. This status message will be updated as content development progresses.
Description
The Verify Link
is used to initiate the verification process for a verifiable credential, in the context of the Mock App system, a Digital Product Passport (DPP), a Digital Conformity Credential or Digital Traceability Events. It provides a standardised way to access, decrypt (if necessary), verify the authenticity and integrity of a credential, and render the credential on the verify page of the Mock App system.
Structure
The general structure of the verify link is as follows:
{verify_app_address}?q={payload:{uri:{uri_of_credential}, key:{decryption_key}, hash:{hash_of_credential}}}
Components
{verify_app_address}
: The base URL of the verification application.q
: Query parameter that contains the encoded payload.payload
: An object containing the necessary information for verification.uri
: The URI where the credential can be accessed.key
(optional): The decryption key, if the credential is encrypted.hash
: The hash of the credential for integrity verification.
Encoded vs Decoded Query
Decoded (Human-readable) Example:
http://localhost:3001/verify?q={payload:{uri:'http://localhost:3001/conformity-credentials/steel-mill-1-emissions.json', key:'secret', hash:'595d8d20c586c6f55f8a758f294674fa85069db5c518a0f4cbbd3fd61f46522f'}}
Encoded (URL-safe) Example:
http://localhost:3001/verify?q%3D%7Bpayload%3A%7Buri%3Ahttp%3A%2F%2Flocalhost%3A3001%2Fconformity-credentials%2Fsteel-mill-1-emissions.json%7D%7D
http://localhost:3001/verify?q%3D%7B%22payload%22%3A%7B%22uri%22%3A%22http%3A%2F%2Flocalhost%3A3001%2Fconformity-credentials%2Fsteel-mill-1-emissions.json%22%2C%22key%22%3A%22secret%22%2C%22hash%22%3A%22595d8d20c586c6f55f8a758f294674fa85069db5c518a0f4cbbd3fd61f46522f%22%7D%7D
Production Example:
https://www.example.com/verify?q=%7B%22payload%22%3A%7B%22uri%22%3A%22https%3A%2F%2Fstorage.googleapis.com%2Fverifiable-credentials%2Fconformity-credentials%2Ftop-line-steel-dcc.json%22%2C%22key%22%3A%22secret%22%2C%22hash%22%3A%22595d8d20c586c6f55f8a758f294674fa85069db5c518a0f4cbbd3fd61f46522f%22%7D%7D