Configuring DirX Audit 9.0 installation & environment for the first time

This is a list of things to check for the newly delivered component DirX Audit Manager (REST / Angular) 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. 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/common/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.

  • Edit 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.