Reference of integration between BMC Helix ITSM and Azure Monitor by using BMC Helix iPaaS
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
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
- External Escalation
- Fax
- System Management
- Phone
- Voice Mail
- Walk In
- Web
- BMC Impact Manager Event
The default value of this variable is Other.