Skip to content

Manage DS settings

All the card schemes supported by ActiveServer can be managed from the Directory Servers page under the Settings tab.

User Access

A user requires the System admin role to manage DS settings.

Directory Server - Settings tab

To edit a card scheme's settings:

Select the appropriate card scheme tab at the top of the page to display its details.

Settings

The following settings can be edited:

  • Cache refresh interval - 3DS Servers are required to make a call to each registered DS every 24 hours at a minimum, and once per hour at a maximum to refresh their cache. The cache contains information about the Protocol Version Numbers(s) supported by available ACSs, the DS, and also any URL to be used for the 3DS Method call. (unit: hours)
  • 3DS Server Operator ID - DS assigned 3DS Server identifier. Each DS can provide a unique ID to each 3DS Server on an individual basis, usually during or at the end of the card scheme compliance process. Requirements for the presence of this field in the AReq and PReq messages are DS specific.
  • HTTPS listening port - port that AS is listening on for HTTPS communications during authentications. This value is read from the configuration file for the corresponding DS setting and is used to listen for RReq requests.
  • 3DS Server URL - fully qualified URL of the 3DS Server to which the DS will send the RReq message after the challenge has completed. URL is fully customisable to your environment/load balancing setup and can be different to the server external URL.

Timeouts

The following settings can be edited:

  • Use system default - toggle that Enables or Disables the use of system default 3DS2 message timeout settings:
  • Enabled - uses the timeout settings defined in 3D Secure 2 settings
  • Disabled - allows the user to edit the timeout settings individually per DS:
    • ACS Method
    • Preparation response (PRes)
    • Authentication response (ARes)
    • Challenge response (CRes)

Server URLs

In the Server URLs section, the DS URLs can be input for the production addresses of the card scheme DS. The Primary directory will be used on the first attempt. If the first attempt results in an unsuccessful connection, ActiveServer will retry using the Alternate directory URL.

The Status button can be used to toggle whether DS URL will be used for all connections made to the DS, with Enabled allowing connections and Disabled ignoring the URL for connection attempts.

Use the Priority (Default) arrows to switch the URL priorities by moving the DS URL between the Primary directory and Alternate directory.