Skip to main content

Presentation Configuration

Fields of a presentation configuration, as accepted by POST /api/verifier/config and in config/<tenant>/presentation/<id>.json. PATCH /api/verifier/config/{id} accepts the same fields, all optional. For the task-oriented guide see Configure Verification.

Fields​

The table is generated at build time from the Zod schema the backend validates with. The schema is strict: unknown fields are rejected. dcql_query.credentials[] has one shape per format (mso_mdoc and dc+sd-jwt).

FieldRequiredType / allowed valuesDescription
idyesstringPresentation configuration identifier.
descriptionnostring or nullOptional presentation configuration description.
lifeTimenointeger (minimum 1)Presentation request lifetime in seconds.
skewSecondsnointeger (minimum 0)Clock skew tolerance in seconds.
statusCheckModenostring: strict | best_effort | disabledRevocation/status check mode.
dcql_queryyesobjectDCQL query defining requested credentials and claims.
dcql_query.credentialsyesarray of one of 2 shapesCredential queries requested by the verifier.
dcql_query.credentials[].idyesstringCredential query identifier.
dcql_query.credentials[].multiplenobooleanAllow multiple matching credentials.
dcql_query.credentials[].claim_setsnoarray of array of stringOptional claim set constraints.
dcql_query.credentials[].trusted_authoritiesnoarray of one of 2 shapesOptional trusted authority constraints.
dcql_query.credentials[].trusted_authorities[].typeyesstring: etsi_tlOnly when type is etsi_tl. Trusted authority type discriminator for ETSI trust lists.
dcql_query.credentials[].trusted_authorities[].valuesyesarray of one of 2 shapesOnly when type is etsi_tl. Trust list references for ETSI TL verification.
dcql_query.credentials[].trusted_authorities[].values[].formatyesstring: trusted-listOnly when format is trusted-list. Format of the list: an ETSI TS 119 612 Trusted List or list of trusted lists as XML.
dcql_query.credentials[].trusted_authorities[].values[].urlyesstringOnly when format is trusted-list. URL of the Trusted List, or of a list of trusted lists (LOTL) whose national lists are followed.
dcql_query.credentials[].trusted_authorities[].values[].signingCertificatesyesarray of stringOnly when format is trusted-list. Base64 DER certificates one of which must have signed the list: for a list of trusted lists, the signing certificates its operator publishes; for a national list, its scheme operator certificates.
dcql_query.credentials[].trusted_authorities[].values[].schemeTerritoriesnoarray of stringOnly when format is trusted-list. For a list of trusted lists: the SchemeTerritory values of the national lists to follow, such as DE. All when absent.
dcql_query.credentials[].trusted_authorities[].values[].formatnostring: loteOnly when format is lote. Format of the list: a List of Trusted Entities (ETSI TS 119 602) as JWT. Default.
dcql_query.credentials[].trusted_authorities[].values[].trustListIdnostringOnly when format is lote. Optional trust list id reference.
dcql_query.credentials[].trusted_authorities[].values[].urlnostringOnly when format is lote. Optional trust list URL reference.
dcql_query.credentials[].trusted_authorities[].values[].verifierKeynoobjectOnly when format is lote. Optional verifier key material.
dcql_query.credentials[].trusted_authorities[].values[].verifierX509DernostringOnly when format is lote. Optional verifier certificate in DER/base64 form.
dcql_query.credentials[].trusted_authorities[].typeyesstring: openid_federationOnly when type is openid_federation. Trusted authority type discriminator for OpenID Federation.
dcql_query.credentials[].trusted_authorities[].valuesyesarray of stringOnly when type is openid_federation. OpenID Federation authority identifiers.
dcql_query.credentials[].formatyesstring: mso_mdocOnly when format is mso_mdoc. Credential format discriminator.
dcql_query.credentials[].metayesobjectOnly when format is mso_mdoc.
dcql_query.credentials[].meta.doctype_valueyesstringOnly when format is mso_mdoc. Expected mDoc doctype value.
dcql_query.credentials[].claimsnoarray of objectOnly when format is mso_mdoc. Optional mDoc claim-level constraints.
dcql_query.credentials[].claims[].idnostringOnly when format is mso_mdoc. Optional claim query id.
dcql_query.credentials[].claims[].pathyesarray of string | numberOnly when format is mso_mdoc. Path to the claim value in presented credentials.
dcql_query.credentials[].claims[].valuesnoarray of one of 3 shapesOnly when format is mso_mdoc. Optional allowed values for the claim. A disclosed value must equal one of them in type and value.
dcql_query.credentials[].claims[].intent_to_retainnobooleanOnly when format is mso_mdoc. Whether relying party intends to retain the claim.
dcql_query.credentials[].formatyesstring: dc+sd-jwtOnly when format is dc+sd-jwt. Credential format discriminator.
dcql_query.credentials[].metayesobjectOnly when format is dc+sd-jwt.
dcql_query.credentials[].meta.vct_valuesyesarray of stringOnly when format is dc+sd-jwt. Accepted VCT values.
dcql_query.credentials[].claimsnoarray of objectOnly when format is dc+sd-jwt. Optional claim-level constraints.
dcql_query.credentials[].claims[].idnostringOnly when format is dc+sd-jwt. Optional claim query id.
dcql_query.credentials[].claims[].pathyesarray of string | numberOnly when format is dc+sd-jwt. Path to the claim value in presented credentials.
dcql_query.credentials[].claims[].valuesnoarray of one of 3 shapesOnly when format is dc+sd-jwt. Optional allowed values for the claim. A disclosed value must equal one of them in type and value.
dcql_query.credential_setsnoarray of objectOptional higher-level credential set requirements.
dcql_query.credential_sets[].optionsyesarray of array of stringAlternative credential query id combinations.
dcql_query.credential_sets[].requirednobooleanWhether this credential set is mandatory.
transaction_datanoarray of object or nullOptional transaction data descriptors.
transaction_data[].typeyesstringTransaction data type identifier.
transaction_data[].credential_idsyesarray of stringCredential query ids this transaction data applies to.
transaction_data[].payloadnoanyTransaction details. Required for TS12 SCA transaction data.
registration_certnoobject or nullRegistration certificate from a registrar, with the purpose and privacy policy it is requested with.
registration_cert.jwtnostringRegistration certificate JWT issued by a registrar. Attached to every request object as is; it must be valid and authorize every credential the DCQL query requests.
registration_cert.purposenoarray of objectWhy the data is requested (GDPR purpose), one text per language. Used when a certificate is requested from a registrar.
registration_cert.purpose[].langyesstringLanguage tag of the text, such as en or pt-BR. The EUDI Hub takes two-letter codes only.
registration_cert.purpose[].contentyesstringThe purpose in that language.
registration_cert.privacy_policynostringURL of the privacy policy that applies to this request. Used when a certificate is requested from a registrar.
webhookEndpointIdnostring or nullOptional webhook endpoint id for presentation callbacks.
attachednoarray of object or nullOptional attachments included with presentation requests.
attached[].formatyesstringAttachment format identifier.
attached[].datayesanyAttachment payload.
attached[].credential_idsnoarray of stringOptional credential query ids bound to this attachment.
redirectUrinostring or nullOptional redirect URI after presentation completion.
accessKeyChainIdnostring or nullAccess key chain that signs the request, determines the client_id and signs readerAuth; without it, an access key chain of the tenant is used.
allowedOriginsnoarray of string or nullOrigins (http(s)://host[:port]) of the web pages allowed to request this presentation over the Digital Credentials API. When set, dc-api and iso-18013-7 offers are refused for any other expected_origin, and an offer without expected_origin uses the only listed origin. Unset: any expected_origin is accepted. Not used for uri requests.
readerAuthnoboolean or nullWhether reader authentication is required for mDoc requests.

Defaults and behavior​

FieldDefault and behavior
idUsed as requestId in presentation requests.
descriptionInternal only; not shown to the wallet user.
lifeTime300. Seconds until a request created from this configuration expires (expiresAt of the session).
skewSeconds60. Clock skew tolerance for credential time checks; a request can override it.
statusCheckModestrict (default): status lists are checked and verification fails if a status list cannot be fetched or validated, or if a credential's status (SD-JWT VC status claim, mDOC MSO status) names only another status mechanism. Credentials without status information are accepted, except a PID whose validity period is longer than 24 hours, which fails with verification_error (ARF Annex 2, VCR_01, VCR_01b and VCR_14). A credential is a PID when its certificate chain matches a certificate listed with a PID/Issuance service in the trust lists (a CA it was issued under, or its own end-entity certificate), also if that certificate is listed with another service as well. Its validity period runs from nbf (else iat) to exp of the SD-JWT VC, where a selectively disclosable iat counts only if the wallet discloses it, or from validFrom to validUntil of the mDOC's MSO; a PID without a start or an end counts as longer than 24 hours. EAAs, Pub-EAAs and QEAAs without status information are left to the relying party's policy and accepted. best_effort: verification continues without the status result when the status list is unavailable, and accepts such a PID with a warning. Both reject a status list that is not ZLIB-compressed or decompresses to more than 16 MiB (SD-JWT VC) or 1 MiB (mDOC). Both fail with verification_error, without fetching a list, on a malformed status reference: an SD-JWT VC status claim that is not a non-empty object, a status_list that is not an object, a uri that is not an absolute URI, or an idx that is not a non-negative integer, and for an mDOC an MSO status that names no mechanism or a status list or identifier list uri that is not an absolute URI. disabled: no status check. Applies to SD-JWT VC and mDOC, including ISO 18013-7.
dcql_querySee DCQL. <TENANT_URL> anywhere in the query is replaced with <PUBLIC_URL>/issuers/<tenant>.
transaction_dataSent with every request unless the request sets its own transaction_data. An ISO 18013-7 request answers 400 unless it sends "transaction_data": []. See Transaction Data.
registration_certjwt (the certificate from a registrar, attached to every request), purpose and privacy_policy (kept for requesting a new one). See Registration Certificates.
webhookEndpointIdID of a webhook endpoint that receives results. A request can override it with an inline webhook.
attachedStored with the configuration; currently not sent to the wallet.
redirectUriSame-device redirect target. {sessionId} is replaced with the session ID. A request can override it, except for ISO 18013-7. See Receive Results.
accessKeyChainIdAccess key chain that signs the request, determines the client_id and signs readerAuth. Without it, EUDIPLO uses the tenant's default access key chain: access of its key chain defaults, else one picked by rule, which prefers a registrar or other CA-issued certificate.
allowedOriginsUnset or empty: any expected_origin is accepted. When set, dc-api and iso-18013-7 requests must name one of these origins, or none if exactly one is listed. Not used for uri requests. See Allowed origins.
readerAuthfalse. ISO 18013-7 only: sign the DeviceRequest with the access key chain. Requires the db KMS provider for that key.

Validation rules​

Rules that the table cannot show:

  • dcql_query.credentials needs at least one entry; credential query IDs contain only letters, digits, _ and -, and are unique.
  • meta is required: vct_values (at least one) for dc+sd-jwt, doctype_value for mso_mdoc.
  • Every credential query needs trusted_authorities with an etsi_tl trust list or an openid_federation trust anchor, unless SKIP_TRUST_AUTHORITY=true. See DCQL.
  • Every ID in claim_sets must reference the id of a claim in the same credential query; claim IDs are unique.
  • Each allowedOrigins entry is an origin in serialized form: https or http scheme, lower-case host, a port only if it is not the default (443, 80), no path, query, credentials or trailing slash. At most 100 entries.
  • transaction_data entries whose type starts with urn:eudi:sca: must be a supported TS12 type with a valid payload.
  • transaction_data entries must name in credential_ids only dc+sd-jwt queries of the DCQL query (Which credentials an entry may reference).

Server-managed fields​

Responses also contain createdAt and updatedAt. They are read-only and not part of the schema, so the API rejects them in a request body.