How do I view, add, edit or remove web apps?

To view web apps

To add a web app

To edit a web app

To remove a web app

To view web apps:

Web Application Management page:

The Web Application Management page enables you to view, add, edit, and remove web applications for monitoring.

1. Click the Main Menu and then Web Application Monitoring.
   
   
   
   
2. The Web Application Monitoring page will open.
   
   

The Web Application page displays a table listing the web apps that you have added. The table details the following information:

Dashboards and dashlets:

You can view web application and SSL certificate status information via the following dashboards:

• Web Applications dashboard:
  This dashboard is applicable to the View context:
  
  
  
  At the View context level, this dashboard provides the following information:
  • Web App Poll Status Summary pie chart dashlet, showing a breakdown of the poll status for the web apps in the View.
  • SSL Cert. Status Summary pie chart dashlet, showing a breakdown of SSL certificate status for the web apps in the View.
  • Open Web App Incidents pie chart dashlet, displaying the open Web App Incidents in this View.
  • Web Apps table dashlet, listing the web applications in the View.
  
  
  
• Summary dashboard:
  This dashboard is applicable to web application objects:
  
  
  
  You can access this dashboard by clicking the specific web app display name from the Web Application Management table, or by navigating to the web app via the Explorer. At the web app context level, this Summary dashboard provides the following information:
  • Key Info dashlet summarizing details of the web app
    • Name
    • Type (i.e. web application)
    • HTTP Response Code
    • Web App SSL Cert. Status
    • If certificate or performance polling is enabled
    • URL
    • SSL Certificate Expiry Date
    • Days until Certificate Expiry
    • If Redirects are allowed
    • Response Size
    • If Max Response Size Exceeded
    • Redirect Count
    • If Regex Matched
    • TLS Version
    • Cipher Suite
    • Time to First Byte
    • Total Request Time
  • Incidents Summary dashlet displaying the incidents on this web app (relating to the time until expiry or HTTP Response Code).
  • Request Timings History dashlet displaying stacked bar charts of the performance metrics polled.
    • Data Transfer Time
    • Wait Time
    • Redirect Time
    • SSL Handshake Time
    • Connect Time
    • DNS Lookup Time

To add a web app:

1. Navigate to the Web Application Management page.
2. Click Add Web App at the top of the page (or via the Overflow Menu).
   
   
   
   
3. The Add Web App form will open on the right of the window.
   
   
   
   
4. Name - specify a display name for the web app.
5. Description - specify a description, if desired. This is not a mandatory field.
6. URL(s) - specify the URL(s) of the web app including either "http://"
    or "https://", e.g. https://www.example.com.
   • You can also optionally specify a port on the end (default is 443 for https), e.g. https://google.com:443.
   • You can bulk add two or more URLs, which must be separated by commas, e.g. https://google.com:443,http://www.example.com
7. Certificate Expiry Polling - specify whether to enable SSL certificate expiry polling. If enabled, incidents and events will be raised depending on the time until expiry of the web app's SSL certificates. The default polling period is once every 5 minutes.
   
   • Note, please see section below to add a certificate to the Java keystore to allow SSL Certificate Monitoring if it is not already found within the default Java keystore.
8. Performance Polling - specify whether to enable performance polling. If enabled, metrics will be gathered, and events and incidents will be raised depending on the HTTP response code. The default polling period is once every 5 minutes.
9. Response Regex – specify regex to attempt to match from the response data. If enabled, incidents and events will be raised depending on if the regex matched successfully or not.
10. Follow Redirects - specify whether it should follow redirects or not. If enabled, count of redirects will be collected.
11. Click Done in the top right to save your changes, otherwise click Cancel. When saved, the web app will appear in the table list.

Add a Certificate to the Java Keystore

Entuity has a certtool utility within the [Entuity Home]/bin directory that creates a second store for certificates that prevents them from being lost when the JRE is upgraded. Please see the following article for additional information.

To import a certificate into the Java Keystore:

1. From the command line or command prompt of your Entuity server, navigate to the [Entuity Home]/bin directory.
2. Run the following command to import the certificate to both the Entuity trust store and default JRE trust store.
   • Note:
     • An alias must be specified that is unique to both trust stores. The prefix entuity_ will be added to the alias.
     • Passwords are optional - if missing, then the default password changeit will be used for both stores.

   • -import -file <certificate file> -alias <certificate alias> [-entuityStorePass <password>] [-defaultStorePass <password>]

3. Once it has successfully imported the certificate, they can be found at the following directories.
   • Entuity trust store is located at [Entuity Home]/etc/entuity_cacerts
   • Default JRE trust store is located at [Entuity Home]/install/JRE/lib/security/cacerts

To edit a web app:

Note, you can edit multiple web apps at the same time.

1. Navigate to the Web Application Management page.
2. Select the web app that you wish to edit and click Edit Web App at the top of the page (or via the Overflow Menu or right-click Context Menu).
   
   
   
   
3. The Edit Web App form will open on the right of the window, which contains the same fields as when adding a web app (see above).
4. If you have selected multiple web apps to edit at the same time:
   • the Name field will display the name of the web apps if they all share the same name, or a '?' if they differ.
     • if the names are uniform, then any change to the Name field will change the names of all selected web apps.
     • if the '?' is present, then any change to the Name field will also change the names of all selected web apps to the new entry. If you do not make a change, this field will remain as '?', and each web app will retain its individual name.
     • will not be able to change the names of the selected web apps.
   • editing the Description field is governed by the same rules as applicable to the Names field above.
   • you will be unable to edit the individual URLs of the selected web apps. To edit these URLs, you will need to individually select and edit each web app.
   • if the selected web apps all share the same Certificate Expiry Polling, Performance Polling, or other settings, this will be reflected here (i.e., if the polling of all selected web apps are set to On, this switch will be set to On). If the selected web apps are set to mixture of On and Off, this switch will be set to Off.
5. Make your desired changes and click Done in the top right to save, otherwise click Cancel.

To remove a web app:

1. Navigate to the Web Application Management page.
2. Select the web app that you wish to remove and click Remove Web App at the top of the page (or via the Overflow Menu or right-click Context Menu).
   
   
   
   
3. A removal confirmation dialog will open. Confirm your choice.