Administration Web Interface Configuration via web configuration files

You can configure web administration using settings from a web configuration file. This allows you to quickly apply pre-set configurations to the Administration Web Interface.

When you configure the Administration Web Interface to apply settings from a file, those settings take precedence over any other configurations applied through other means. As such, to perform any further configurations, you will have to do so via the configuration file.

Creating web configuration files

The settings in the web administration configuration file are based on the parameters, options, and syntax of Java system properties. As such, the easiest way to create a configuration file is via the OneSpan Web Configuration Tool.

Creating the configuration file involves running the same commands for configuring web administration with the following additional parameter:

-Dcom.vasco.identikey.webapps.configfile=properties_file

where properties_file is an absolute path to the target properties file.

Consider the following command:

java -Dcom.vasco.identikey.webapps.configfile=properties_file
-jar admintool.jar server add "Admin Server" http://192.0.2.1:8888 10 3

This command will create the properties file. This properties file will apply the following settings for an OneSpan Authentication Server instance:

• The Administration Web Interface will connect to the IDENTIKEY SOAP communicator using http at address 192.0.2.1 and port 8888.
• The Administration Web Interface will use the name Admin Server for that connection.
• The Admin Server connection will have a connection timeout of 10 seconds.
• The Admin Server connection will only allow a maximum of 3 concurrent connections.

Applying web configuration file settings (to the Administration Web Interface)

After creating the web configuration file, you will need to instruct the Apache Tomcat web server to read the configuration file. The next time the Apache Tomcat web server restarts, it will apply the web administration settings from the configuration file.

These settings will take precedence over all attempts to configure web administration. As such, to configure web administration again, you will need to do so via the configuration file.

To apply web configuration file settings to Administration Web Interface

1. Change the Java options in your Apache Tomcat start-up configuration by adding the following line directly in the Java options section:

   JAVA_OPTS="$JAVA_OPTS -Dcom.vasco.identikey.webapps.configfile=properties_file"

   where properties_file is an absolute path to the target properties file.

   For more information about changing options, refer to the Apache Tomcat product documentation.

   Note that these are the same admintool.jar parameters to use when creating the configuration file (see Creating web configuration files ).

   To find the Java options section, search for other lines that begin with JAVA_OPTS. Append the aforementioned Java option line to this group.

2. Restart OneSpan Authentication Server.

The settings in the web administration configuration file are a collection of Java options written as Java system properties. Thus, you can write these settings directly in the Apache Tomcat server init script (/etc/init.d/tomcat9) if you prefer this method.