{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":30270,"path":"it-operations-management/event-management/azure-integration.md","title":"Integrate Azure Monitor as an authenticated data source","bundle":null,"doc_type":null,"release":"australia","body":"\n# Integrate Azure Monitor as an authenticated data source\n\nIntegrate Microsoft Azure with Event Management by adding the Azure Monitor as an authenticated data source.\n\nYou can configure the Event Management environment for the collection of events from Azure Monitor by setting your ServiceNow AI Platform instance as the rest endpoint.\n\nOnce the endpoint is configured, when an Azure Monitor alert message arrives, Event Management:\n\n-   Authenticates the Azure Monitor alert message with the relevant ServiceNow user, using OAuth configuration or a standard webhook.\n-   Extracts information from the original Azure Monitor alert message to populate required event fields and inserts the event into the ServiceNow AI Platform database.\n-   Captures specified content in the **Additional Information** field of the event form.\n\n## What authentication is used\n\nThere are two methods of authentication:\n\n-   OAuth authentication: Provides enterprise-grade authentication to keep your enterprise environment safe. Authentication is performed using Azure Monitor V1 or V2 access tokens. For more information, see [Integrate Azure Monitor with OAuth authentication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/azure-events-authentication.md).\n-   API key authentication: Integrate using API key to secure communication between Azure and ServiceNow. For more information, see [Integrate Azure with REST API key token](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/integrate-azure-api-key.md).\n-   Basic webhook authentication: Provides a basic standard of authentication, without the need for Azure Active Directory. This authentication can be especially useful for distributed small teams, such as SRE or DevOps teams. For more information, see [Integrate Azure Monitor with basic authentication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/azure-events-webhook.md).\n\n## What to know before you begin\n\nYou can use your integrated Azure Monitor as a data source only after you have verified the following:\n\n-   For both methods of authentication, the relevant ServiceNow sys\\_user is assigned the evt\\_mgmt\\_integration role.\n-   The Event Management Connectors plugin is installed in the ServiceNow AI Platform instance. You can download the plugin from the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) website.\n-   Azure Cloud Discovery must be performed to ensure that the created alerts are bound to the configuration items in the ServiceNow AI Platform. For more information, see [Discovery for Microsoft Azure](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/discovery/azure-cloud-discovery.md).\n\n## Event Rules and Event Field mappings\n\nThese event rules and event field mappings are provided with the base system:\n\n|Module|Description|\n|------|-----------|\n|Event Rules|**Azure Monitor**: A general event rule to handle all Azure Monitor events.|\n|Event Field Mappings|**Azure Monitor - ci\\_type**: To map ci\\_type of events based on resourceType field. A base set of mapping pairs are provided.|\n\nThese are the mappings provided with the base system in **Azure Monitor - ci\\_type**:\n\n\\[Omitted image \"Azure-base-mapping.png\"\\] Alt text: Azure Mapping Pairs\n\n**Note:** You can add new mapping pairs to the Event Field Mapping - **Azure Monitor - ci\\_type** as per the requirement, to map events to the respective ci\\_type based on resourceType.\n\nStarting from the Xanadu release, the OOTB \\(Out-Of-The-Box\\) rules provided with the connector, which you have not previously used \\(i.e., neither activated, deactivated, nor modified\\), will now have the **Apply additional matching rules** check box set to true. Previously, this check box was disabled. This change allows you to execute more event rules or automation using the same filter conditions for the connector.\n\n**Note:** This feature applies only to active event rules.\n\nIf you want to send alert state changes on the ServiceNow instance from the ServiceNow alerts to the Azure Portal, you need to enable the Azure Monitor Bi-directional connector. For more information, see [Configure Azure Monitor Bi-directional connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-azure-bi-directional-connector.md).\n\n## Severity mapping from Azure severity to ServiceNow event severity\n\n|Azure severity condition|ServiceNow event severity|\n|------------------------|-------------------------|\n|When an Azure alert monitorCondition is Fired|\n|Azure Sev0|ServiceNow Critical \\(severity \"1\"\\)|\n|Azure Sev1|ServiceNow Major \\(severity \"2\"\\)|\n|Azure Sev2 and Sev3|ServiceNow Warning \\(severity \"4\"\\)|\n|Azure Sev4|ServiceNow OK \\(severity \"5\"\\)|\n|When an Azure alert monitorCondition is resolved|\n|Any Azure severity|ServiceNow CLEAR \\(severity \"0\"\\)|\n\n-   **[Azure Monitor Issue integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/azure-monitor-issue-integration.md)**  \nAn Azure Issue is a unified case that aggregates related alerts and signals from Azure Monitor into a single, trackable operational problem. It preserves investigation context and serves as a durable record for incident management Incident Management, so you can resolve problems faster instead of tracking scattered alerts.\n-   **[Integrate Azure Monitor with basic authentication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/azure-events-webhook.md)**  \nIntegrate Microsoft Azure with Event Management by adding a standard webhook in Azure Monitor.\n-   **[Integrate Azure with REST API key token](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/integrate-azure-api-key.md)**  \nIntegrate using an API key to establish secure communication and automate data exchange via REST API. This simplifies integration, enabling seamless access to services and enhancing operational efficiency.\n-   **[Integrate Azure Monitor with OAuth authentication](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/azure-events-authentication.md)**  \nIntegrate Microsoft Azure with Event Management by authenticating Azure V1 or V2 tokens in the Azure Monitor.\n-   **[Configure Azure Monitor Bi-directional connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-azure-bi-directional-connector.md)**  \nThe Azure Monitor Pull connector sends information from ServiceNow Event Management to the Azure Portal. The pull connector sends the alert state changes from the ServiceNow environment to the Azure Portal.\n\n**Parent Topic:**[Integrate with push connectors](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/event-management/configure-listener-transform-script.md)\n\n"}}