Reset certificate expiration alert period

By default, B2Bi automatically displays a UI alert 14 days before security certificates are about to expire.

At the same time, B2Bi starts sending email alerts to a designated certificate caretaker if all of the following conditions are met:

  • The default options in the file .../Interchange/conf/events.xml are enabled.
  • The file ../Interchange/conf/alerts.xml is configured to send email alerts to one or more designated certificate caretakers.
  • In the UI, the SMTP server page is properly configured.

If the 14 day warning period is insufficient time to arrange certificate updates, you can increase the number of days. To reset the certificate expiration alert period:

  1. Open a session in the UI as an administrator user and enter the URL:
  2. http://<hostname>:6080/ui/core/SystemProperties
  3. This opens the hidden System properties page.
  4. Caution: Incorrectly modifying values on this page can severely degrade your product behavior. Do not modify values on this page without explicit guidance from Axway support.
  5. Click Show default system properties to display a complete list of available properties.
  6. Locate the entry in the system properties list: certificate.Validation.Config.Days
  7. Click the Add property button located on the left of this entry.
  8. This action displays fields for editing the property.
  9. In the Value field, enter a new value (in days) for pre-expiration warnings to begin.
  10. Click Add.
  11. Click Save changes.

Persistence of settings – Each of the settings you change in the Systems properties page is persisted for updates and service packs, and does not need to be reset. However, this is not true of the alerts.xml and event.xml files. If you have customized either of these files, your changes are overwritten by upgrades and service packs. Before applying upgrades or service packs you must make copies of these customized files, as is recommended in the upgrade chapters of this document.

Alert email controls – The frequency and destination of emails alerts are controlled in the .../Interchange/conf/alerts.xml file. For complete details on how to configure this file, see the B2Bi Administrator Guide / "The alerts xml file" chapter.

  • Frequency: The frequency at which B2Bi sends certificate expiration alert emails is controlled through the <Interval minutes="mm"/> tag. This tag controls all alert types except those related to certificate validation checks. The default value is 60 minutes. That is, by default, an alert email is sent at a minimum of once per hour when an alert threshold is reached. The Interval tag is a minimum value. If the trading engine is busy with priority tasks, then the email alert interval may be extended.
  • This "Frequency" setting does not effect the way B2Bi performs certificate validation. For validation checks, certs are always checked only once per day. The system checks them every day sometime between midnight + Interval. A value of Interval=60 means that B2Bi does certificate checking between midnight and 1 am. Then it does not run again until the next day.
  • Destination: The destination of email alerts is controlled in a section of tags near the bottom of the alerts.xml that are initially commented out (disabled). You uncomment (enable) the entire section and populate it with the email addresses. The following shows the initial state of the section in the alerts.xml file:
  • <!-- Uncomment to enable
      <Community id="default">
        <ActionParameters>
          <Parameter name="FromEmailAddress" value="Interchange@axway.com"/>
          <Parameter name="AlertEmailAddresses" value="targetuser@example.com"/>
        </ActionParameters>
      </Community>
    -->

  • The following shows the same section after it has been uncommented (enabled) and properly populated. Multiple email addresses are separated with commas. Note that the "FromEmailAddress" parameter must be populated and syntactically correct, but no email is ever be sent to this address.
  • <Community id="default">
      <ActionParameters>
        <Parameter name="FromEmailAddress" value="MyAS2Interchange@MyCompany.com"/>
        <Parameter name="AlertEmailAddresses" value="name1@MyCompany.com,name2@MyCompany.com"/>
      </ActionParameters>
    </Community>

Related topics

Related Links