IBM Cloud Docs
Nzalerts on Azure

Nzalerts on Azure

This guide outlines two methods to set up Nzalerts on Microsoft Azure.

Setup options

Option 1: Providing access to IBM's multi-tenant app

Events will be published to your Azure event grid topic by granting access to IBM’s multi-tenant app.

Option 2: Providing your access key

Option 3: Email method

Events will be published to your Azure event grid topic by providing the endpoint and access key.

1. Providing access to IBM's multi-tenant app:

Step1: Create the event grid topic:

  1. Login to Azure portal.
  2. Navigate to search bar and search for Event-Grid.
  3. Select Topic in Event-Grid. Click on Create to create a new topic.
  4. Fill out the details like Resource Group, Topic Name.
  5. Then click on Review+create to create the topic.

Step 2: Give consent to make IBM’s multi-tenant app as Service Principal

  1. Login to the Azure portal.

  2. Get the Directory ID of your Microsoft AD on which you need your topic to be published. Directory ID would be required for creating the notification method.

  3. Refer the document to create the notification method. Azure Event Grid Notification Method.

  4. A consent URL will be generated once you input your Directory ID. For example, see the following.

    https://login.microsoftonline.com/<>/oauth2/authorize?client_id=<>&response_type=code

  5. Paste the link on the browser. Only global admins (or roles with app consent rights) can consent on behalf of the tenant. Click Accept. This will create a Service principal of our app in your tenant.

Step 3: Give publish permission

To get the events to be published in that topic, click the created topic and navigate to Access Control (IAM) on the left side.

  1. Click on Add Role Assignment.
  2. Choose role Eventgrid data sender.
  3. Assign to: User, Group or service principle.
  4. Select the multi-tenant app for which customers has consented and then Save.

Step 4: Create event rule method in NzSaas console

  1. Create event rule will take tenant id and event grid topic as input. Refer notify type, see Azure_Event_Grid.

Once the events are published to Azure event grid, you can configure the downstream handling based on your requirements—whether it's delivering the events via email, forwarding them to a queue, or integrating with other services.

2. Providing your access key:

Step 1: Create event grid in your account

  1. Login to Azure portal.
  2. Navigate to search bar and search for Event Grid.
  3. Select Topic in EventGrid. Click on Create to create a new topic.
  4. Fill out the details like Resource Group, Topic Name.
  5. Then click on Review+create to create the topic.

Step 2: Create notification method

  1. From the Event grid topic:

    Get the Topic Endpoint from the Overview tab.

    Get the Access Key from Settings -> Access Keys.

  2. Refer to the Notification method to complete the setup.

3: Email method

  1. Go to Settings -> Monitoring and alerts section.
  2. Navigate to Add method radio button and click it.
  3. In the Select method section, from the select method drop down choose Email and provide the name for the notification method in the enter method name field and click next.
  4. In the Configure method section, enter the mail address in the respective fields.
  5. Click Confirm.

Create rule for Email method

  1. Go to Settings -> Monitoring and alerts section.
  2. Navigate to Create rule -> Define rule.
  3. Enter rule name and enable the status and click Next.
  4. Go to Select destination, select the destination as Email and choose email method.
  5. Click Next to go to Choose event.
  6. Enter the details and click Next to go to Event expression.
  7. Fill in the necessary fields and click Confirm to complete the rule setup.