6.12 LiveNX Integration - BlueCat Infrastructure Assurance - 25.2.0

BlueCat LiveAssurance User Guide
ft:locale
en-US
Product name
BlueCat Infrastructure Assurance
Version
25.2.0

Infrastructure Assurance v25.1.0 supports integration with LiveNX v25.1.0 and later, enabling the storage of alerts (generated in Infrastructure Assurance) in the LiveNX database.

Note:

Prerequisites

Before you configure the integration, ensure that you've set a token for LiveAction Receiver in the Network Configuration page of the LiveNX UI.

Use the following procedure to set this token in the LiveNX UI:

  1. Log in to the LiveNX web interface.

  2. Select the gear icon available in the Navigation bar.

  3. Select Network Intelligence Configuration > Network Configuration in the sidebar.

  4. In the Network Configuration page that is displayed, configure the following parameters:
    • LiveNX REST API Token—You can obtain this token from the LiveNX Swagger page (<LiveNX-URL>:8093/v1/docs).
    • LiveAction Receiver Configuration—Enable this option.
    • Token—If not present already, create a token for the LiveAction Receiver Configuration. You can enter any value manually. Alternatively, you can automatically generate a UUID by re-saving the configuration. (TIP: Temporarily modify a field and select Save.)
      Note: Greenfield deployments will always have a UUID pre-populated.

  5. Make a note of this token as you will use it when configuring the LiveNX integration in the Infrastructure Assurance UI.

  6. Select Save.

Procedure to configure integration with LiveNX

  1. Select Settings in the sidebar, then select Integrations.

  2. From the Add New Integration drop-down list, select LiveNX.

  3. Configure the following parameters:

    • Integration Name—enter a name for the LiveNX integration.
    • URL—enter http://localhost as the URL.
    • Token—enter the LiveAction Receiver token that grants authorized access to send alerts to LiveNX. This is the same token that is configured in the Network Configuration page of the LiveNX UI.

  4. Select Save.

  5. For the integration to start, you must restart the authserver by using the following command:

    cd /data/bcia && docker compose restart authserver

After successful integration, the Infrastructure Assurance alerts are displayed in your LiveAssurance Events dashboard within LiveNX. Clicking an alert will take you to the Issues tab in the Infrastructure Assurance UI, which displays a detailed view of the alert.

Note: In addition to storing alert data in the LiveNX database, the data is also preserved in the file /usr/share/indeni-services/config/livenx.env. When the LiveNX integration is deleted, this file will also be deleted.