Configuring DirX Audit 9.1 installation & environment for the first time

This is a list of configuration items to check for DirX Audit Manager to be accessible

  • Allow the REST API port (30501 by default) in the firewall settings. Each tenant has its separate port.

  • Add the hostname:port where the Apache Tomcat service is running into the allowOrigins field in the REST configuration in DirX Audit Tenant Configuration Wizard, for example https://hostname.domainname:8443 where hostname.domainname is the fully qualified domain name of the server. Make sure not to leave out the https:// URL protocol prefix!

  • Add the DirX Audit Server hostname in the hosts file in case the hostname is not known to Windows, C:\Windows\System32\drivers\etc\hosts, for example 127.0.0.1 dxt-hostname.test.com.

  • Both the Apache Tomcat service and the DirX Audit Server service for the respective tenant must be running to be able to access the DirX Audit Manager.

  • Both the Apache Tomcat service and the DirX Audit Server REST service for the respective tenant must have the same SSL settings so that users can access the DirX Audit Manager. When the SSL is enabled for the REST service the user has to access the Apache Tomcat service hosting DirX Audit Manager via https, when the REST service does not use SSL the DirX Audit Manager can be only accessed via http.

  • It might be necessary to access the REST service URI in your browser, for example https://hostname.domainname:port/Tenants/tenantId/api/audit/Me and confirm a security exception or add the server certificate authority (CA) as trusted in your browser certificate list. The REST API port is by default 30501. The same applies for the authorization server URL if you set up an OpenID Connect configuration.

  • When configuring the Audit Manager Application in the tenant configurator make sure to enter a hostname in the REST server URL base and not an IP address. Make sure to enable Manager redeployment when making changes to the REST server URL base value. After the configurator is finished check also the install_path\web\audit-manager-tenantId\plugins\dirx-dxt-app-manager\assets\config\app-config.json and check that the key basePath includes a hostname in the REST service URI and not an IP address.

  • Disable (set to false) both cross-site request forgery (CSRF) settings in case of problems with getting the search results: install_path\server_container\tenants\tenantId\conf\application.properties, for example authn.csrf.enable=false and springdoc.swagger-ui.csrf.enabled=false.