- 07 Jan 2025
- 3 Minutes à lire
- SombreLumière
- PDF
TLS/SSL Encryption Setup for Server-Side Components
- Mis à jour le 07 Jan 2025
- 3 Minutes à lire
- SombreLumière
- PDF
You can use TLS/SSL encryption to secure the communication flow between OneSpan Authentication Server and its side products.
Using TLS/SSL with SOAP
OneSpan Authentication Server uses SSL to secure SOAP connections between itself and OneSpan Authentication Server applications and components. The SOAP client verifies the server with the help of SSL when connecting to OneSpan Authentication Server.
To enable TLS/SSL encryption for SOAP
- Start the OneSpan Authentication Server Configuration Utility.
- Click the Communicators icon, and switch to the SOAP tab.
- Select the Enable SOAP checkbox to enable the SOAP protocol and select Enable SSL to use encryption.
- Load the Certificate File, and enter your password.
- Click OK.
The following OneSpan Authentication Server components can use SSL over SOAP:
- Digipass Authentication for Windows Logon
- Digipass Authentication Module products
- LDAP Synchronization Tool
To enable TLS/SSL for Digipass Authentication for Windows Logon
- Start the Digipass Authentication for Windows Logon Configuration Center.
- Switch to the Connection Settings tab and select Verify server SSL certificate in the Authentication Server connection settings section.
- Click OK.
- Install the CA certificate in the Trusted Root Certification Authorities certificate store.
For more information about Digipass Authentication for Windows Logon, refer to the Digipass Authentication for Windows Logon Getting Started Guide and the Digipass Authentication for Windows Logon Product Guide.
To enable TLS/SSL for Digipass Authentication Module
- Start the respective configuration application of your product.
- Switch to the Connection Settings page and select the Verify server SSL certificate option in the Authentication Server connection settings section.
- Click OK.
- Install the CA certificate in the Trusted Root Certification Authorities certificate store.
All Digipass Authentication Module products have the same configuration to enable SSL encryption.
To enable TLS/SSL for LDAP Synchronization Tool
- Start the LDAP Synchronization Tool Configuration Utility.
- Click the Profiles icon.
- Click Add to create a profile.
- In the LDAP tab, configure the Connection section, and ensure that the LDAPS option is selected.
In the OAS tab, configure the Connection section:
- Ensure that Verify SSL is selected.
- On Linux, specify the path to the CA certificate of OneSpan Authentication Server.
- On Windows, you need to install the certificate in the Trusted Root Certification Authorities certificate store.
- Click OK.
Using TLS/SSL encryption for SEAL
Some products that are communicating with OneSpan Authentication Server use the SEAL protocol. The protocol has to be configured to use SSL encryption to be regarded as safe.
SEAL over SSL is enabled by default in OneSpan Authentication Server.
SEAL without SSL is also enabled by default in OneSpan Authentication Server. For additional security, consider disabling SEAL without SSL.
To enable TLS/SSL encryption for SEAL
- Start the OneSpan Authentication Server Configuration Utility.
- Click the Communicators icon, and select the SEAL tab.
- In the SEAL tab, select the Enable SEAL checkbox to enable the SEAL protocol and select Enable SSL to use encryption.
- Load the Certificate File, and enter your password.
- Click OK.
The following OneSpan Authentication Server components/features can use SSL over SEAL:
- Audit Viewer (for live audit)
- Replication
- Message Delivery Component (MDC)
- Tcl Command-Line Administration tool
To enable TLS/SSL encryption for live audit
- Start the OneSpan Authentication Server Configuration Utility.
- Click the Auditing icon and select Live Auditing Viewer in the Available Audit Methods tab.
- Click Edit.
- Select Enable SSL in the Live Audit Settings section.
- Load the Certificate file (.pem) in the Server Certificate section, and type your Password.
- Click OK.
To enable TLS/SSL for replication
- Start the OneSpan Authentication Server Configuration Utility.
- Click the Replication icon.
- In the Replication Settings, select the Enable Replication checkbox.
- Switch to the Destination Servers tab and then click Add.
- Select Enabled, enter the Display Name, IP Address, and the Port.
- Select Use SSL, load the SSL certificate file, and enter the corresponding password (if you set one), and the certification authority (CA) file of the destination server.
To enable TLS/SSL for Message Delivery Component (MDC)
- Start the MDC Configuration Utility.
- In the General settings tab, select Enable SSL, and load the Certificate file (.pem) in the Server Certificate section, and enter your Password.
- Click OK.
If the e-mail delivery option is selected, you must additionally ensure that encryption is used for the e-mail server host.
To enable TLS/SSL for e-mail delivery in Message Delivery Component (MDC)
- Launch the MDC Configuration Utility.
- Click the Email Delivery icon, and select Enable Email Delivery.
- In the SMTP Host section select Use SSL and Use TLS.
- Click OK.
To enable TLS/SSL for Tcl Command-Line Administration tool
- Open the dpadmincmd.xml file.
- Locate the SSL parameter in the configuration file: VASCO>AAL3>SEAL>SSL.
- Set Enabled to true.
- CA-File should contain the location of the certificate file, e.g. %PROGRAMFILES%\VASCO\IDENTIKEY Authentication Server\bin\ikey_seal_serverca.pem.
- Save the file.