Skip to main content

DSX

Updated

Access Integration

  • BLE: Open the app to use your mobile credential
  • NFC: Tap and go access with your phone’s digital wallet
  • ACS Read: Sync users from ACS
  • ACS Write: Create and manage ACS users in Activate
  • Tenant Self Serve: Manage your employee suite and building access in Activate

 

Visitor Management: 

Not supported

 

Required Client Participation

See below for required roles and expectations on your side. 

Role Expectation
Executive Sponsor Monthly and/or escalation participation only
Project Manager Weekly participation
Integration Point of Contact Integration & internal IT configuration support to work with VTS and integrator, complete Integration UAT onsite, knowledgeable infrastructure resource
Integrator Client should expect to actively work with their integrator* to complete any items the client is unable to achieve on their own.
Testing Group Works with Project Manager, Integration POC, and VTS to validate integration and triage issues
Friendly Tenant Testing Group Recommended group of tenant users to test mobile access and onboarding prior to go-live.
*Client may incur additional fees from their integrator for this type of support — please confirm ahead of project start.

 

Client Prerequisites

These items must be completed before VTS can begin configuration.

Access

  1. Supported DSX Version: 6.0, 6.1
  2. Enable xp_cmdshell on DSX server using sp_configure
    • See Microsoft Documentation
    • This configuration is required to avoid errors related to some command permission: SQL Server blocked access to procedure 'sys.xp_cmdshell' of component 'xp_cmdshell'. This error is thrown as this component is turned off as part of the security configuration for this server.
  3. Configure DSX UDF for Email
    • must be Required and Unique, both marked as “true” in DSX
    • share the UDF name with your VTS representative 
  4. Configure DSX UDF for ProviderUserId (used by Activate for writes)
  5. Create and share DSX admin credentials (suggested username: VTSuser): username, password, server URL
  6. Confirm Shared File Path (not read-only) where WinDSX is installed (e.g. C:\WinDSX6)
  7. Confirm email addresses are populated in DSX cardholder profiles. Users without email will not be synced or provisioned mobile credentials
  8. Locations:
    • Location Group - (LocGroup) Group of locations. 
    • Users with same email and name can exist at different LocGrp. 
    • LocGrp is mandatory to use for all WRITE, UPDATE and DELETE type operations. 
    • Upon selecting ‘Location Group’ value below configs appear:
      1. Email UDF - The user-defined field created on DSX for Email 
      2. Activate UserId UDF - ProviderUserId, used internally in DSX for WRITE operation, is a Primary Key and will be used as Provider User ID in Activate
  9. Provide credential range
  10. HID Prerequisites
  11. Ngrok Prerequisites

Related articles