OneSpan User Websites supports a backup OneSpan Authentication Server instance to use if the primary server instance becomes unavailable. This prevents service interruptions, even if one of the OneSpan Authentication Server instances is shut down for maintenance.
Before you begin
Ensure that you have two OneSpan Authentication Server instances installed and configured correctly.
Configure a primary and a backup OneSpan Authentication Server instance
To configure a OneSpan Authentication Server instance use the following command:
admintool type website server add name url
To configure a OneSpan Authentication Server instance and automatically retrieve and add the respective server certificates to the trust store use the following command:
admintool type website autoadd name url
where:
website is the website to configure, i.e., selfmgmt for User Self-Management Website and votp for Virtual Mobile Authenticator OTP Request Website. If you deploy both websites, you need to run the command twice with different parameters for type.
name is the parameter to set an instance of OneSpan Authentication Server as primary or backup server. Possible values are primary or backup.
url is the web address of the OneSpan Authentication Server instance in URL format. This includes the protocol string, the host component (IP address, host name, or FQDN), and the SOAP port, for example, https://192.0.2.1:8888. If you are using a host name or FQDN, it must be correctly resolved by a DNS server.
TLS certificate matching requirements
The URL host component that is used to connect to the OneSpan Authentication Server instance (either IP address, host name, or FQDN) must match the common name (CN) or the subject alternative name (SAN) in the TLS/SSL server certificate for SOAP connections. For example, if the certificate contains only a hostname (e.g., CN=oas), you must use that hostname – not an IP address. Otherwise, you will receive an error that the certificate does not match the common name of the certificate subject when the user websites attempt to connect to OneSpan Authentication Server.
The self-signed TLS/SSL certificates created by the OneSpan Authentication Server Configuration Wizard contain only the IP address in the subject alternative name (SAN). If you need to use the FQDN when establishing the connection, you have to create a certificate that contains the FQDN in the SAN.
In that case, we recommend to include a short name, the FQDN, and the IP address in the SAN, for example, SAN=OAS:oas.example.com:192.0.2.1.
TIP: You can also use wildcard certificates to cover an unlimited number of sub-domains in a main domain. For example, *.example.com covers host1.example.com, host2.example.com, etc.
Set the primary server for the Virtual Mobile Authenticator OTP Request Website using https on the host oas.example.com and port 8888:
admintool type votp server add primary https://oas.example.com:8888