Configure the FORGE VESPER Connector

This document lists the environment variables for the FORGE VESPER Connector.

Environment Variables

Configuration	Description	Sample/type of valid values	Mandatory	Default value
Guishell__BackofficeUrl	Guishell backoffice URL	https://localhost:3000	Yes
Guishell__ClientId	Guishell client id	your-client-id	Yes
Guishell__ClientSecret	Guishell client secret	your-client-secret	Yes
ManagementApi__Url	FORGE Management API URL	https://management-api.example.com	Yes
ManagementApi__ResourceName	FORGE Management API Resource name	management-api	Yes
AmazonSqs__AccessKeyId	AWS SQS access key ID	AKIA...	Yes
AmazonSqs__SecretAccessKey	AWS SQS secret access key	your-secret-access-key	Yes
AmazonSqs__Region	AWS SQS region	eu-central-1	Yes
AmazonSqs__QueueUrl	AWS SQS queue URL	https://sqs.eu-central-1.amazonaws.com/123/queue	Yes
AmazonSqs__PrefecthCount	SQS prefetch count	10	No	10
AmazonSqs__Timeout	SQS timeout (hh:mm:ss)	00:00:30	No	00:00:30
AmazonSqs__RetryCount	SQS retry count	2	No	2
AmazonSqs__ReceiveMessageWaitTimeSeconds	SQS receive message wait time (seconds)	20	No	20
AmazonSqs__VisibilityTimeoutSeconds	SQS visibility timeout (seconds)	120	No	120
AmazonSqs__VisibilityHeartbeatSeconds	SQS visibility heartbeat (seconds)	60	No	60
ProcessorSettings__RetryCount	Processor retry count	2	No	2
ProcessorSettings__RetryDelay	Processor retry delay (hh:mm:ss)	00:00:01	No	00:00:01
Vesper__DatasourceName	Vesper datasource name	Vesper	Yes	Vesper
Vesper__EventMappings__0__EventName	Event mapping: event name (first mapping)	UPDATED_VOD	No	UPDATED_VOD
Vesper__EventMappings__0__EntityCode	Event mapping: entity code (first mapping)	vesper-video	No	vesper-video
MongoDb__ConnectionString	Mongo DB connection string with database name	mongodb://localhost:27017/database-name	Yes
MongoDb__LockTtlSeconds	Mongo DB lock TTL in seconds for distributed locks	3600	No	3600
MongoDb__AreaCode	AreaCode setting for multi datacenter scenario	Vesper	No	Vesper
Vesper__ContextTags__0	Tag that, when matched among incoming Vesper tags, triggers the connector logic	Sport	No	Sport
ExternalTags__DataSources__0__DataSourceName	Name of the external tag datasource matched against incoming tags	Structured external tag not supported	No
LOG_MINIMUM_LEVEL	The minimum logging level	Information	No	Warning
MICROSOFT_LOG_MINIMUM_LEVEL	The minimum logging level used for the logs written by .NET framework	Warning	No	Warning

Authentication settings

Configuration key	Description	Sample	Mandatory	Default Value
ApiKey__HeaderName	Request header that contains the shared secret	x-api-key	No	x-api-key
ApiKey__ApiKeyValue	Shared secret value expected by the service	your-shared-secret	Yes
ApiKey__UserName	Authenticated user name assigned to accepted requests	ServiceUser	No	ServiceUser

Notes

• ExternalTags__DataSources__0__DataSourceName is intended for external tag matching. The document notes that structured external tag data sources are not supported and that the connector skips unsupported tags such as Competitions.
• The connector relies on the configured queue, visibility timeout, and heartbeat values to maintain message processing safely and avoid duplicate or stale work.