After you have installed AppDNA, the Configuration Wizard creates a website in IIS on the server and all communication from clients to the server are made through various SOAP APIs that the website provides.
However, the configuration wizard only sets this site up with default http access on port 8199. In most modern enterprise environments, you will want all of your http traffic running as https over SSL or more likely TLS 1.2. Whilst AppDNA runs perfectly well over a secure https channel, it cannot be initially configured that way and changing it is not a simple task. Though neither is it very difficult if you know how.
This article provides a step by step guide to show you how to get your AppDNA installation running over https.
On the AppDNA Server open up IIS Manager
Select the AppDNA Website and click on the Configuration Editor in the action pane
From the Section drop down menu Select system.webServer and then serverRuntime
Modify the uploadReadAheadSize Setting to 104857600 and click Apply
Alternatively open an elevated command prompt and run the following command
“%windir%\system32\inetsrv\appcmd.exe” set config -section:system.webServer/serverRuntime /uploadReadAheadSize:”104857600” /commit:apphost
Select the AppDNA Website and click on Bindings in the action pane
Click Add on the bindings dialog page
Choose https from the Type dropdown and select the SSL Certificate that you want the site to use
Select the AppDNA web site again and then click on the SSL settings icon in the main pane
Check the Require SSL Check box and click Apply
You will now find that navigating to the AppDNA Web site, or trying to launch the client will give an authentication error
Open the AppDNA Configuration wizard
Select the options for Reconfiguration Installation then Reconfigure System and then Web Site.
Change the Port that AppDNA will use from the default http port 8199 to the ssl port 443
The configuration wizard will not allow us to do it.
We will have to edit it manually.
Browse to the the AppDNA Server's installation directory "C:\Program Files\Citrix\AppDNA\Server" (Program Files (x86) if you are using a version of AppDNA earlier than 7.13)
Locate the file named web.config (make a backup copy) and open it with your favorite xml editing tool
Locate the key for the 'ReportBaseUrl' under the settings section and modify the url so that the protocol reads https:// (instead of http://) and the port reads 443 (instead of 8199)
If The certificate you used contains the FQDN of the server then make sure your configuration here does too.
Save these changes and you will now be able to access the AppDNA Web Client over https
This time the UI will allow us to do all the things we need.
Open the AppDNA client but do not attempt to log in yet (if you have auto login configured, just dismiss the error message)
Select the expand icon on the Options
Then click the pencil Edit icon next to your site name
Notice that the site is still points to the http://... version of the url
Click Next through the wizard until you get to the edit url page
Modify the protocol and ports in the url as we have done previously
Again make sure that the address of the Web Server exactly matches that contained in the certificate, or it will fail to authenticate correctly.
Click Next through to the end of the wizard and you will see the modified url reflected in the site details
We are done. You should be able to login now and verify that the client is communicating with the server and accessing report on the new https channel
However, please remember that this last step will need to be repeated on AppDNA clients and for each AppDNA Site that is using the new SSL binding.