This documentation supports the 23.3 and consecutive patch versions of BMC Helix Multi-Cloud Broker.To view an earlier version, select the version from the Product version menu.

Reference of integration between BMC Helix ITSM and Azure Monitor by using BMC Helix iPaaS


You can integrate BMC Helix iPaaS with Azure Monitor to create a BMC Helix ITSMincident from an Azure alert.  You can also update the status of the alert directly from the incident.

BMC Helix Multi-Cloud Broker, along with BMC Helix iPaaS provides an out-of-the-box integration template to integrate BMC Helix ITSMand Azure Monitor. You configure the integration in BMC Helix Multi-Cloud Broker and deploy the template to your BMC Helix iPaaS environment.

List of project variables

The following sections describe the variables that you can update as per your requirements:


  • BMC Helix iPaaS variables:

    Project variable

    Action

    BHIP_API_NAME

    Enter the name for API that is created in BMC Helix iPaaS to receive BMC Helix Multi-Cloud Broker webhook requests.

    The default value of this variable is set to BMCHelixAzureAlertsITSMIncident.

    If required, you can change the name.

    BHIP_API_User_Roles

    Specify the organization roles that should have access to the new API. You can add multiple comma separated values.

    Important: If you do not specify any value, all the organization roles get access to the new API.

    BHIP_MCB_API_Profile_User_Name

    Enter the user name that should be used while creating the BMC Helix Multi-Cloud Broker API profile.

    The integration template creates an API in BMC Helix iPaaS to handle requests from BMC Helix Multi-Cloud Broker.

    BHIP_MCB_API_Profile_User_Password

    Enter the password that should be used while creating the BMC Helix Multi-Cloud BrokerAPI profile.

    The integration template creates an API in BMC Helix iPaaS to handle requests from BMC Helix Multi-Cloud Broker.

    BHIP_Vendor_API_Profile_Type

    Do not change this value.

    The default value of this variable is OAuth

    BHIP_Vendor_API_Profile_User_Name

    Do not enter any values in these variables.

    BHIP_Vendor_API_Profile_User_Password

    BHIP_Vendor_API_Profile_ApiKey_Name

    BHIP_Host

    Enter the BMC Helix iPaaS instance URL where you want to run this project.

    Important: Make sure that you do not enter any leading and trailing spaces.

    BHIP_User_Name

    Enter the user name for the BMC Helix iPaaS instance.

    BHIP_User_Password

    Enter the password for the BMC Helix iPaaSinstance.

    Enable_BMC_Helix_To_Vendor_Integration

    Enable the update of the status of Azure Monitor alerts when the status of the corresponding BMC Helix ITSMincident is changed to In Progress, Resolved, or Closed.

    By default, this variable is enabled. If you want to disable updates of Azure Monitor alerts, set the default value to false.

    Enable_Vendor_To_BMC_Helix_Integration

    Enable the creation of a BMC Helix ITSMincident from an Azure alert. It also updates the status of the alert from the incident.

    By default, this variable is enabled. If you want to disable the creation of BMC Helix ITSMincidents, set the default value to false.

    BHIP_Vendor_API_OAUTH_PROVIDER

    Enter the name of the authentication provider.

    The default value of this variable is Azure AD. If you use a different authentication provider, refer to the documentation of that provider to configure the variable.

    BHIP_Vendor_OAUTH_CLIENT_ID

    Enter the client ID for your Azure Monitor instance only if you have provided the following values in the variables:

    • BHIP_Vendor_API_Profile_Type—OAuth
    • BHIP_Vendor_API_OAUTH_PROVIDER—Azure AD

    BHIP_Vendor_OAUTH_CLIENT_SECRET

    Enter the client secret for your Azure Monitor instance only if you have provided the following values in the variables:

    • BHIP_Vendor_API_Profile_Type—OAuth
    • BHIP_Vendor_API_OAUTH_PROVIDER—Azure AD

    Important

    To configure the OAuth variables, see Azure AD OAuth 2.0 API Security Profile in the Jitterbit documentation.

  • BMC Helix Multi-Cloud Broker variables:

    Project variable

    Action

    MCB_Host

    Enter the BMC Helix Multi-Cloud Brokerhost URL in the following format:

     [http/https]://[hostname]:[port]

    Important: Make sure that you do not enter any leading and trailing spaces.

    MCB_User_Name

    Enter the user name that enables users to interact with BMC Helix Multi-Cloud Broker.

    MCB_User_Password

    Enter the password for the provided username.

    MCB_Vendor_Name

    Do not change this value.

    This variable is autopopulated.

    MCB_Assigned_Group

    Enter the name of the support group to which you want to assign the incident.

    MCB_Assigned_Support_Organization

    Enter the name of the support organization to which you want to assign the incident.

    MCB_Assigned_Support_Company

    Enter the name of the support company to which you want to assign the incident.

    MCB_Assigned_Company

    Enter the name of the company for which you want to create the incident.

    MCB_Assigned_Company_Id

    Enter the ID of the company for which you want to create the incident.

    MCB_Assigned_Business_Unit

    Enter the name of the business unit to which you want to assign the incident.

    The following variables are inputs from BMC Helix ITSM. Either enter values for these variables or map the appropriate Azure Monitor fields if the data is available:

    Project variable

    Action

    ITSM_Company_Name

    Enter the company name for which the integration template needs to be run; for example, Apex Global.

    ITSM_Customer_First_name

    Enter the first name of the BMC Helix ITSMcustomer.

    ITSM_Customer_Last_Name

    Enter the last name of the BMC Helix ITSMcustomer.

    ITSM_Incident_Type

    Enter any of the following incident types for which you want to create a corresponding Azure Alert:

    • User Service Restoration
    • User Service Request
    • Infrastructure Restoration
    • Infrastructure Event
    • Security Incident

    The default value of this variable is set to User Service Restoration.

    Reported_Source

    Enter one of the following sources from which the BMC Helix ITSMincident is created:

    • Direct Input
    • Email
    • External Escalation
    • Fax
    • System Management
    • Phone
    • Voice Mail
    • Walk In
    • Web
    • BMC Impact Manager Event

    The default value of this variable is Other.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*