Skip to content

Manage DS settings

All the settings for 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.

    Tip

    The 3DS Server URL may have already been set when updating the 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:
    • Preparation response (PRes)
    • Authentication response (ARes)

Server URLs

In the Server URLs section, the DS URLs can be input for the addresses of the card scheme DS.

The Default URL is used for AReq and PReq message communications with the DS provider.

The PReq URL can optionally be filled in if the DS provider has a separate PReq endpoint for those requests. If a value is entered in this field, it will override the Default URL. If this value is empty, ActiveServer will send PReq messages to the Default URL if it entered.