Skip to main content
Version: v0.21.0

Configuration

Set CONFIG_PATH to an absolute configuration file path. Without it, the file loader searches for config.yaml or another supported config file format in the process's current directory and its parents. The application validates the loaded configuration at startup.

Environment variables override file settings. Use the uppercase TSG__ prefix, double underscores between path segments and snake case for camel-case keys. For example, TSG__SERVER__PUBLIC_ADDRESS overrides server.publicAddress.

Databases​

By default, the development database is sqlite. We use postgres databases for production type instances of the wallets.

Authentication​

Browser access uses an explicitly registered SSO client and the configured receiving audience. Use the SSO Bridge with Tenant Management for managed organization access; an OAuth login alone does not establish the required organization, grant and lifecycle state. See the managed deployment guide.

DID Method​

Two DID methods are currently supported: did:web and did:tdw. A comparison between the two is given below. The decision of which configuration to select should be made based on the specific use case of the wallet.

did:webdid:tdwdid:key
TSG Configuration value:did:web:did:tdw:- (DID Key is only supported for DID resolution but not for creation)
Specification link:W3C internal documentBCGov specification draftW3C internal document
Supported version:Unofficial draftDraft v1Unofficial draft v0.7
Underlying technology:Web-based DID method that serves the DID Document as a JSON under a certain endpoint (.well-known path) of a web domain that is accessible by the public.Web-based DID method that utilizes a public JSON Lines file hosted under a web domain to store each change (create, update, delete) that occurs on a DID Document. The DID Document is then resolved by fetching and processing the JSON Lines file.Multibase Multicodec public key, with generated DID document
Identifier format:did:web:{{public web domain}}
e.g. did:web:example.com
did:tdw:{{public web domain}}:{{generated self-certifying identifier}}
e.g. did:tdw:example.com:b7ep277b2mvxdpcrbja3iergubfy
did:key:{{ Public key }}
Advantages:Straightforward implementation with no additional processing other than hosting DID Document on web server.Additional security and validation mechanisms contained in the JSON Lines file that increases trustworthiness of DID Document.No server implementation required, so very suitable for mobile wallets
Disadvantages:Easily compromisable without notice by resolving parties when malicious access is gained to the web server.DID Document is not directly available as extra processing to verify signatures and validate entry hashes retrieved from the JSON Lines file needs to be performed to resolve the DID Document.DID document only contains the verification method, so additional properties like service are not supported

Managed organizations​

A Wallet process serves managed participants. Each has its own keys, DID, credentials and issuer configuration. Tenant Management creates or explicitly imports the organization and keeps its authorization snapshots fresh. The process starts with no tenants. Organization creation, membership changes and invitations are managed through Tenant Management.

Global key and issue-configuration settings define the provisioning defaults for new managed Wallet tenants. They do not claim existing keys, bind old rows to a new organization or create a tenant at startup. See the deployment and import guide.

Addressing​

Public DID and credential endpoints use https://wallet.example/tenants/<local-slug>/..., with DID did:web:wallet.example:tenants:<local-slug>. Management requests select the local tenant through X-Tenant-Slug or X-Tenant-Id; OAuth tenant_id carries the canonical organization UUID. The selector grants no access.

Existing Wallet data​

Old seeded configuration no longer starts. Back up its databases, keys and secrets, then explicitly import the existing local tenant ID, URL slug, DID and resource ownership through Tenant Management. Retain the published URLs and keys. Creating a replacement tenant or matching a slug does not migrate the existing identity. Follow the import procedure before reopening managed access.

Issue Configurations​

Issue configurations define the structure, validation rules, and visual presentation of credential types that the wallet can issue and manage. Each configuration combines semantic interoperability through JSON-LD contexts with schema validation and visual styling.

JSON-LD Context and Schema Relationship​

Issue configurations leverage both JSON-LD contexts and JSON Schema for comprehensive credential definition:

  • JSON-LD Context (document or documentUrl): Defines semantic meaning of credential properties for interoperability across systems
  • JSON Schema (schema): Defines structure, validation rules, and user interface information for credential properties

Schema-Driven User Interface​

The JSON Schema directly influences how credentials are presented to users:

  • Property Order: Schema property order determines display order in user interfaces
  • Human-Readable Titles: The title property provides user-friendly labels instead of technical property names
  • Example Values: The example property shows users expected data format
  • Validation Rules: Properties like enum, pattern, and required ensure data quality and guide user input when issuing credentials

Visual Styling​

Issue configurations support visual customization through:

  • Background Color (backgroundColor): Hex color code for credential background
  • Background Image (backgroundImage): URL or base64-encoded image for credential branding. PNG-based images are recommended for transparency support and support across applications.
  • Text Color (textColor): Hex color code for credential text
  • Display Metadata (name, description): Human-readable credential information

Possible configuration parameters​

initSelfIssuedCredentials contains per-tenant credential templates. Each new Wallet signs them with its own key and sets the issuer and subject ID to its own DID. Template IDs are tenant-local fragments. These templates do not import a shared credential or grant admission to a real dataspace.

tenancy.initializations selects operator-owned key configuration for an exact canonical tenant UUID, such as the separate development X.509 keys in the Gaia-X sample. Unlisted tenants use generated initKeys. Initialization and its receipt commit together; reconciliation and restarts preserve later key changes.

KeyRequiredTypeDescriptionDefault
WalletTenancyConfig
tenancyWalletTenancyConfigundefined
WalletTenantInitialization
tenancy.initializationsWalletTenantInitialization[]Operator-owned initialization for exact canonical tenants, including tenant-specific X.509 keys[]
tenancy.initializations[].tenantIdYesStringCanonical tenant UUID assigned by Tenant Management
InitKeyConfig
tenancy.initializations[].keysYesInitKeyConfig[]Keys for this exact canonical tenant, never copied into other tenants
tenancy.initializations[].keys[].typeYes"EdDSA" | "ES384" | "X509"Type of key
tenancy.initializations[].keys[].idYesStringID of the key
tenancy.initializations[].keys[].defaultBooleanDefault keyfalse
tenancy.initializations[].keys[].existingKeyStringExisting PKCS#8 encoded key
tenancy.initializations[].keys[].existingCertificateStringExisting PEM encoded certificate
tenancy.mode"managed"Tenant state is provisioned by Tenant Management"managed"
tenancy.controlPlaneUrlsStringOperator-registered Control Plane API bases used for Wallet connector DID services[]
tenancy.serviceInstanceIdStringOperator-registered receiving service instance""
tenancy.managementUrlStringTenant Management UI URL
tenancy.provisioningIdentitiesObjectExact manager issuer/subject, audience and allowed provisioning operations[]
tenancy.platformPrincipalsObjectExact human principals permitted to change shared process settings; organization roles grant no platform authority[]
DatabaseConfig
dbYesDatabaseConfigDatabase configuration
db.retryAttemptsNumberConnection attempts during application startup, three seconds apart10
db.typeYes"sqlite" | "postgres"Type of database
db.databaseYesStringName of the database
db.synchronizeBooleanSynchronize database schemafalse
db{type=sqlite}YesSQLiteConfigDatabase configuration
db{type=sqlite}.retryAttemptsNumberConnection attempts during application startup, three seconds apart10
db{type=sqlite}.type"sqlite" | "postgres"Type of database"sqlite"
db{type=sqlite}.databaseYesStringName of the database
db{type=sqlite}.synchronizeBooleanSynchronize database schemafalse
db{type=postgres}YesPostgresConfigDatabase configuration
db{type=postgres}.hostYesStringHost of the database
db{type=postgres}.portYesNumberPort of the database
db{type=postgres}.usernameYesStringUsername of the database
db{type=postgres}.passwordYesStringPassword of the database
db{type=postgres}.sslObjectSSL configuration of the databasefalse
db{type=postgres}.retryAttemptsNumberConnection attempts during application startup, three seconds apart10
db{type=postgres}.type"sqlite" | "postgres"Type of database"postgres"
db{type=postgres}.databaseYesStringName of the database
db{type=postgres}.synchronizeBooleanSynchronize database schemafalse
ServerConfig
serverServerConfigServer configuration
server.listenStringIP address the server listens on"0.0.0.0"
server.portNumberPort the server listens on3000
server.publicDomainStringPublic domain of the server"localhost"
server.publicAddressStringPublic address of the server"http://localhost:3000"
server.subPathStringSub path of the server
AuthConfig
authYesAuthConfigManagement authentication configuration
auth.signalingIdStringReceiving plane identity for signaling tokens. Defaults to clientId.
auth.expectedIssuerStringExpected API token issuer; defaults to the discovered OpenID issuer
auth.expectedAudienceStringExpected API token audience; defaults to clientId.
auth.enabledBooleanEnable authenticationtrue
auth.openIdConfigurationURLStringOpenID configuration URL
auth.callbackURLURLCallback URL the auth service will redirect users
auth.redirectURLURLRedirect URL to UI after login/logout
auth.clientIdStringClient ID
auth.clientSecretStringClient secret (required for client_secret_post authentication)
auth.tokenEndpointAuthMethod"client_secret_post" | "private_key_jwt"Token endpoint authentication method: client_secret_post (default) or private_key_jwt"client_secret_post"
auth.privateKeyJwkObjectPrivate key in JWK format for private_key_jwt authentication. Alternative to privateKeyJwkFile.
auth.privateKeyJwkFileStringPath to file containing private key JWK for private_key_jwt authentication. Alternative to privateKeyJwk.
auth.permissionPathStringJSON path to extract permissions from the token"$.permissions[*]"
NodemailerConfiguration
emailNodemailerConfigurationEmail configuration
email.enabledBooleanEnable email sendingfalse
email.smtpFromStringEmail address to send emails from
email.smtpPortNumberSMTP port465
email.smtpSecureBooleanSMTP secure connectiontrue
email.smtpServerStringSMTP server
email.smtpUserStringSMTP user
email.smtpPasswordStringSMTP password
email.titleStringTitle
InitKeyConfig
initKeysInitKeyConfig[]Initial key configurations[]
initKeys[].typeYes"EdDSA" | "ES384" | "X509"Type of key
initKeys[].idYesStringID of the key
initKeys[].defaultBooleanDefault keyfalse
initKeys[].existingKeyStringExisting PKCS#8 encoded key
initKeys[].existingCertificateStringExisting PEM encoded certificate
AddScope
initScopesAddScope[]Initial scope configurations[]
initScopes[].aliasYesStringAlias of the scope
initScopes[].discriminatorYesStringDiscriminator of the scope, variables must be enclosed in
initScopes[].descriptionYesStringDescription of the scope
PresentationDefinition
initScopes[].presentationDefinitionYesPresentationDefinitionPresentation definition associated with the scope, should include variables from the discriminator
initScopes[].presentationDefinition.idYesStringundefined
InputDescriptor
initScopes[].presentationDefinition.input_descriptorsYesInputDescriptor[]undefined
initScopes[].presentationDefinition.input_descriptors[].idYesStringundefined
initScopes[].presentationDefinition.input_descriptors[].nameStringundefined
initScopes[].presentationDefinition.input_descriptors[].purposeStringundefined
Format
initScopes[].presentationDefinition.input_descriptors[].formatFormatundefined
JwtVpClaimFormat
initScopes[].presentationDefinition.input_descriptors[].format.jwt_vpJwtVpClaimFormatundefined
initScopes[].presentationDefinition.input_descriptors[].format.jwt_vp.algYesStringundefined
Constraint
initScopes[].presentationDefinition.input_descriptors[].constraintsYesConstraintundefined
Field
initScopes[].presentationDefinition.input_descriptors[].constraints.fieldsField[]undefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].pathYesStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].idStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].purposeStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].nameStringundefined
Filter
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filterFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.typeYesStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.constObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.enumArrayundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.exclusiveMinimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.exclusiveMaximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.formatStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.minLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.maxLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.minimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.maximumObjectundefined
NestedFilter
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.notNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.typeStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.constObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.enumArrayundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.exclusiveMinimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.exclusiveMaximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.formatStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.minLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.maxLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.minimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.maximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.notNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.patternStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.containsNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.requiredStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.propertiesObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.allOfNestedFilter[]undefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.not.itemsObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.patternStringundefined
NestedFilter
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.containsNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.typeStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.constObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.enumArrayundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.exclusiveMinimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.exclusiveMaximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.formatStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.minLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.maxLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.minimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.maximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.notNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.patternStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.containsNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.requiredStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.propertiesObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.allOfNestedFilter[]undefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.contains.itemsObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.requiredStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.propertiesObjectundefined
NestedFilter
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOfNestedFilter[]undefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].typeStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].constObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].enumArrayundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].exclusiveMinimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].exclusiveMaximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].formatStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].minLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].maxLengthNumberundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].minimumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].maximumObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].notNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].patternStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].containsNestedFilterundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].requiredStringundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].propertiesObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].allOfNestedFilter[]undefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.allOf[].itemsObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].filter.itemsObjectundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.fields[].optionalBooleanundefined
initScopes[].presentationDefinition.input_descriptors[].constraints.limit_disclosureundefined
initScopes[].presentationDefinition.nameStringundefined
initScopes[].presentationDefinition.purposeStringundefined
Format
initScopes[].presentationDefinition.formatFormatundefined
JwtVpClaimFormat
initScopes[].presentationDefinition.format.jwt_vpJwtVpClaimFormatundefined
initScopes[].presentationDefinition.format.jwt_vp.algYesStringundefined
initScopes[].requirementSetIdStringundefined
initScopes[].revisionNumberundefined
initScopes[].digestStringundefined
initScopes[].immutableBooleanundefined
InitCredentialConfig
initCredentialsInitCredentialConfig[]Initial credential configurations[]
initCredentials[].contextArrayJSON-LD contexts for the credential[]
initCredentials[].typeStringTypes of the verifiable credential[]
initCredentials[].idYesStringID of the credential
initCredentials[].proofTypeType of proof used for the credential"ldp"
initCredentials[].keyIdStringID of key signing the credential
initCredentials[].validityDurationMsNumberValidity duration of self-issued credentials in milliseconds. Defaults to 3 months.7776000000
initCredentials[].revocableBooleanRevocable credentialtrue
initCredentials[].credentialSubjectYesObjectCredential subject; every subject must include a claim besides id. Existing id-only credentials must be re-issued.
initCredentials[].evidenceObjectEvidence attached to the verifiable credential
SelfIssuedCredentialTemplate
initSelfIssuedCredentialsSelfIssuedCredentialTemplate[]Credential templates signed separately by each new tenant for its own DID. Existing credentials are retained[]
initSelfIssuedCredentials[].idYesStringTenant-local credential fragment; issuer and subject are the tenant's own DID
initSelfIssuedCredentials[].contextArrayJSON-LD contexts for the credential[]
initSelfIssuedCredentials[].typeStringTypes of the verifiable credential[]
initSelfIssuedCredentials[].proofTypeType of proof used for the credential"ldp"
initSelfIssuedCredentials[].keyIdStringID of key signing the credential
initSelfIssuedCredentials[].validityDurationMsNumberValidity duration of self-issued credentials in milliseconds. Defaults to 3 months.7776000000
initSelfIssuedCredentials[].revocableBooleanRevocable credentialtrue
initSelfIssuedCredentials[].credentialSubjectYesObjectCredential subject; every subject must include a claim besides id. Existing id-only credentials must be re-issued.
initSelfIssuedCredentials[].evidenceObjectEvidence attached to the verifiable credential
TrustAnchorConfig
trustAnchorsTrustAnchorConfig[]Trust anchor configurations[]
trustAnchors[].idYesStringDID of the trust anchor
trustAnchors[].credentialTypesStringCredential types trusted of the trust anchor[]
IssueConfigurationConfig
issueConfigurationsIssueConfigurationConfig[]Issue configuration settings[]
issueConfigurations[].idYesStringID of the configuration
issueConfigurations[].credentialTypeYesStringCredential type associated with the configuration
issueConfigurations[].proofTypeProof type for the credential"jwt"
issueConfigurations[].evidenceObjectEvidence attached to credentials issued with this configuration
issueConfigurations[].documentUrlURLURL of the JSON-LD context
issueConfigurations[].documentObjectJSON-LD context body
issueConfigurations[].schemaObjectJSON-Schema of the issue configuration
issueConfigurations[].nameStringDisplay name of the issue configuration
issueConfigurations[].descriptionStringDescription of the issue configuration
issueConfigurations[].backgroundColorStringBackground color for the credential display
issueConfigurations[].backgroundImageStringBackground image for the credential display, must be a URL
issueConfigurations[].textColorStringText color for the credential display
PresentationDefinition
issueConfigurations[].issuancePolicyPresentationDefinitionPresentation definition that the holder must satisfy before this credential is issued
issueConfigurations[].issuancePolicy.idYesStringundefined
InputDescriptor
issueConfigurations[].issuancePolicy.input_descriptorsYesInputDescriptor[]undefined
issueConfigurations[].issuancePolicy.input_descriptors[].idYesStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].nameStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].purposeStringundefined
Format
issueConfigurations[].issuancePolicy.input_descriptors[].formatFormatundefined
JwtVpClaimFormat
issueConfigurations[].issuancePolicy.input_descriptors[].format.jwt_vpJwtVpClaimFormatundefined
issueConfigurations[].issuancePolicy.input_descriptors[].format.jwt_vp.algYesStringundefined
Constraint
issueConfigurations[].issuancePolicy.input_descriptors[].constraintsYesConstraintundefined
Field
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fieldsField[]undefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].pathYesStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].idStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].purposeStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].nameStringundefined
Filter
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filterFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.typeYesStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.constObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.enumArrayundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.exclusiveMinimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.exclusiveMaximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.formatStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.minLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.maxLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.minimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.maximumObjectundefined
NestedFilter
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.notNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.typeStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.constObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.enumArrayundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.exclusiveMinimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.exclusiveMaximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.formatStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.minLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.maxLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.minimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.maximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.notNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.patternStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.containsNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.requiredStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.propertiesObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.allOfNestedFilter[]undefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.not.itemsObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.patternStringundefined
NestedFilter
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.containsNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.typeStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.constObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.enumArrayundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.exclusiveMinimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.exclusiveMaximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.formatStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.minLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.maxLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.minimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.maximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.notNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.patternStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.containsNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.requiredStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.propertiesObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.allOfNestedFilter[]undefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.contains.itemsObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.requiredStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.propertiesObjectundefined
NestedFilter
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOfNestedFilter[]undefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].typeStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].constObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].enumArrayundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].exclusiveMinimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].exclusiveMaximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].formatStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].minLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].maxLengthNumberundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].minimumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].maximumObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].notNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].patternStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].containsNestedFilterundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].requiredStringundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].propertiesObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].allOfNestedFilter[]undefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.allOf[].itemsObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].filter.itemsObjectundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.fields[].optionalBooleanundefined
issueConfigurations[].issuancePolicy.input_descriptors[].constraints.limit_disclosureundefined
issueConfigurations[].issuancePolicy.nameStringundefined
issueConfigurations[].issuancePolicy.purposeStringundefined
Format
issueConfigurations[].issuancePolicy.formatFormatundefined
JwtVpClaimFormat
issueConfigurations[].issuancePolicy.format.jwt_vpJwtVpClaimFormatundefined
issueConfigurations[].issuancePolicy.format.jwt_vp.algYesStringundefined
issueConfigurations[].canReIssueBooleanWhether credentials of this type may be automatically reissued before they expire. Defaults to true.true
IssuanceConfig
issuanceIssuanceConfigIssuance configuration
issuance.dcpProfile"vc20-bssl/jwt"DCP credential profile used for issuance and requests"vc20-bssl/jwt"
issuance.preAuthorizedCodeTtlMsNumberLifetime of OID4VCI pre-authorized codes in milliseconds300000
IssuerConfig
issuance.issuerIssuerConfig[]Issuer configuration[]
issuance.issuer[].tenantSlugStringTenant slug that acts as issuer (multi-tenant only)
issuance.issuer[].holderIdYesStringDID of the holder
issuance.issuer[].credentialTypeYesStringCredential type to be issued
issuance.issuer[].credentialIdStringStable logical credential ID to use for this configured issuance. Defaults to a holder-bound random ID.
issuance.issuer[].credentialSubjectYesObjectCredential subject; every subject must include a claim besides id. Existing id-only credentials must be re-issued.
issuance.issuer[].preAuthorizedCodeStringPre-authorized code
issuance.issuer[].validityDurationMsNumberValidity duration of self-issued credentials in milliseconds. Defaults to 3 months.7776000000
issuance.issuer[].reissueBeforeExpiryMsNumberHow long before a credential's expiry (in milliseconds) a reissue offer is sent to the holder. Defaults to 7 days. Reissuance can be disabled per credential type via the issue configuration's canReIssue flag.604800000
DCPHolderConfig
issuance.dcpDCPHolderConfig[]DCP Holder configuration[]
issuance.dcp[].tenantSlugStringTenant slug that acts as holder/claimer (multi-tenant only)
issuance.dcp[].preAuthorizedCodeYesStringPre-authorized code
issuance.dcp[].issuerIdYesStringDID identifier of the issuer
issuance.dcp[].credentialTypeYesStringCredential type to be issued
issuance.dcp[].preferredProofTypePreferred proof type for the credential"jwt"
OID4VCIHolderConfig
issuance.oid4vciOID4VCIHolderConfig[]OID4VCI Holder configuration[]
issuance.oid4vci[].tenantSlugStringTenant slug that acts as holder/claimer (multi-tenant only)
issuance.oid4vci[].preAuthorizedCodeYesStringPre-authorized code
issuance.oid4vci[].issuerUrlYesURLRoot URL of the issuer
issuance.oid4vci[].credentialTypeYesStringCredential type(s) to be issued
issuance.statusListCountNumberMaximum number of status list entries per StatusListCredential1000
DidServiceConfig
didServicesDidServiceConfig[]DID service configurations[]
didServices[].idYesStringID of the service
didServices[].typeYesStringType of the service
didServices[].serviceEndpointYesURLService endpoint
DcpStsConfig
dcpStsDcpStsConfigDCP self-issued token configuration
dcpSts.tokenTtlSecondsNumberLifetime of DCP self-issued tokens in seconds300
DcpConfig
dcpDcpConfigDCP interoperability settings
dcp.allowMissingPresentationAudienceBooleanAllow DCP presentation responses without an audience (EDC interoperability relaxation)false
InteropConfig
interopInteropConfigInteroperability settings
EdcInteropConfig
interop.edcEdcInteropConfigEDC interoperability settings
interop.edc.statusListVcClaimBooleanAccept status-list JWTs that carry the credential in a vc claim (workaround, disabled by default)false
RuntimeConfig
runtimeYesRuntimeConfigRuntime configuration
runtime.titleStringTitle of the wallet
runtime.acceptUnauthenticatedCredentialRequestsBooleanAccept unauthenticated credential requestsfalse
runtime.issueMobileCredentialsBooleanIssue mobile credentialsfalse
runtime.issueDebugCredentialsBooleanIssue debug credentialsfalse
runtime.colorStringPrimary color of the wallet"#3B8BF6"
runtime.lightThemeUrlStringLight theme logo URL
runtime.darkThemeUrlStringDark theme logo URL
DidConfig
didDidConfigDID configuration
did.method"did:web:" | "did:tdw:"Provided DID method"did:web:"
did.keyFormat"JWK" | "Multikey"Provided key format"JWK"
AuditModuleConfig
auditAuditModuleConfigAudit logging configuration
audit.enabledBooleanEnable audit loggingtrue
audit.minSeverity"debug" | "info" | "warning" | "error" | "critical"Minimum severity level to log"info"
audit.logDeniedBooleanAlways log denied access attempts regardless of action typetrue
audit.logDelegatedBooleanLog delegated access attempts when enabled, while still respecting action-specific success filterstrue
audit.logMutationsBooleanLog successful mutation actions (create, update, delete, manage)true
audit.logExecuteBooleanLog successful execute actionsfalse
audit.logReadsBooleanLog successful read actions — disabled by default as reads are frequent and rarely relevant for auditingfalse
audit.sensitiveResourcesArrayResources logged regardless of minimum severity, while still respecting action-specific success filters["w.key","w.credential","sso.user"]
AuditHandlersConfig
audit.handlersAuditHandlersConfigHandler configuration
audit.handlers.consoleBooleanEnable console audit log handlerfalse
audit.handlers.databaseBooleanEnable database audit log handlertrue
audit.handlers.otlpBooleanEnable OTLP audit log handlerfalse
OtlpAuditHandlerConfig
audit.otlpOtlpAuditHandlerConfigOTLP audit log handler configuration
audit.otlp.urlStringOTLP HTTP logs endpoint URL"http://localhost:4318/v1/logs"
audit.otlp.headersObjectAdditional HTTP headers to include in OTLP requests
audit.otlp.timeoutMillisNumberOTLP export timeout in milliseconds5000
audit.otlp.concurrencyLimitNumberMaximum number of concurrent OTLP export requests1
audit.otlp.serviceNameStringService name included on OTLP log attributes"tsg-dsp-api"
audit.otlp.serviceVersionStringOptional service version included on OTLP log attributes