openid-data-classes/at.asitplus.openid/VerifierInfo

VerifierInfo

@Serializable

data class VerifierInfo @JvmOverloads constructor(val format: String, val data: VerifierInfo.Data, val credentialIds: Set<String>? = null)(source)

OID4VP 1.0: OPTIONAL. A non-empty array of attestations about the Verifier relevant to the Credential Request. These attestations MAY include Verifier metadata, policies, trust status, or authorizations. Attestations are intended to support authorization decisions, inform Wallet policy enforcement, or enrich the End-User consent dialog.

Constructors

VerifierInfo

@JvmOverloads

constructor(format: String, data: VerifierInfo.Data, credentialIds: Set<String>? = null)

@JvmOverloads

constructor(format: String, data: String, credentialIds: Set<String>? = null)

Attestation in data given as a string, e.g. a JWT.

@JvmOverloads

constructor(format: String, data: JsonObject, credentialIds: Set<String>? = null)

Attestation in data given as a JSON object.

Types

Data

@Serializable(with = VerifierInfoDataSerializer::class)

sealed interface Data

Content of VerifierInfo.data, which OID4VP 1.0 defines as an object or a string. Interpreting it is up to a parser for the respective format.

Properties

credentialIds

@SerialName(value = "credential_ids")

val credentialIds: Set<String>?

OID4VP 1.0: OPTIONAL. A non-empty array of strings each referencing a Credential requested by the Verifier for which the attestation is relevant. Each string matches the id field in a DCQL Credential Query (see at.asitplus.openid.dcql.DCQLCredentialQuery.id). If omitted, the attestation is relevant to all requested Credentials.

data

@SerialName(value = "data")

val data: VerifierInfo.Data

OID4VP 1.0: REQUIRED. An object or string containing an attestation (e.g. a JWT). The payload structure is defined on a per format level. It is at the discretion of the Wallet whether it uses the information from VerifierInfo. Factors that influence such Wallet's decision include, but are not limited to, trust framework the Wallet supports, specific policies defined by the Issuers or ecosystem, and profiles of this specification. If the Wallet uses information from VerifierInfo, the Wallet MUST validate the signature and ensure binding.

format

@SerialName(value = "format")

val format: String

OID4VP 1.0: REQUIRED. A string that identifies the format of the attestation and how it is encoded. Ecosystems SHOULD use collision-resistant identifiers. Further processing of the attestation is determined by the type of the attestation, which is specified in a format-specific way.