> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insecureweb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration guide for Azure

> At its core, Azure is a public cloud computing platform—with solutions including Infrastructure as a Service (IaaS), Platform as a Service (PaaS), and Software as a Service (SaaS) that can be used for services such as analytics, virtual computing, storage, networking, and much more.

## Installing Azure

### 1. Create "Event Hub"

<Note>
  Using the official Azure documentation [Quickstart: Create an event hub using Azure portal](https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-create)
</Note>

### 2. Create a new "Shared access policy" to allow access to the Event Hub created, make sure you select the "Listen" permission.

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/evenhubaccesspolicy.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=a140a22eadf67d2b25c4c01e78fdf81f" alt="Azure" data-path="images/integrations/azure/evenhubaccesspolicy.png" />

### 3. Get the Event Hub Shared Access policies - Connection string–primary key from "Shared access policy" created previously. It will be used to configure your tenant.

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/aacess_shared_policy.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=fb145eab93b3daed26744f2610088410" alt="Azure" data-path="images/integrations/azure/aacess_shared_policy.png" />

> Sample Connection string–primary key:

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/examplekey.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=0e563ce7a85961ab080d387a55387792" alt="Azure" data-path="images/integrations/azure/examplekey.png" />

### 4. Get the Consumer Group Name

> In: All services-> Event Hubs -> Your\_Event\_Hub\_Namespace -> Event Hubs -> Your\_Event\_Hub\_Instance -> Consumer groups. It will be used to configure your tenant.

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/consumer_group.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=d08e87aa24bb2410625b97dc8cfcbc9c" alt="Azure" data-path="images/integrations/azure/consumer_group.png" />

<Note>
  Create a new consumer group specifically for Logstash. Do not use the \$default or any other consumer group that might already be in use. Reusing consumer groups among non-related consumers can cause unexpected behavior and possibly lost events. All Logstash instances should use the same consumer group so that they can work together for processing events.
</Note>

### 5. Create a "Storage Account"

<Note>
  Using the official Azure documentation [Quickstart: Create a storage account](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal)
</Note>

### 6. Get the "Storage Container Name"

> In: All services -> Storage accounts -> Your\_Storage\_Account -> Containers. It will be used to configure your tenant.

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/container_name.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=2d83fcad0a2f7f10600ab06a472e822c" alt="Azure" data-path="images/integrations/azure/container_name.png" />

### 7. Get the Storage Account Connection string with key to access Azure "Storage Account".

> Find the connection string here: All services -> Storage accounts -> Your\_Storage\_Account -> Access keys. It will be used to configure your tenant.

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/account_storage.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=3d00d1f575f69ebbaa1e4a614746ba28" alt="Azure" data-path="images/integrations/azure/account_storage.png" />

> Sample connection string:

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/samplestring.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=7b9d7f8254831c0d8825ea14d1d3b525" alt="Azure" data-path="images/integrations/azure/samplestring.png" />

### 8.Configure your Azure Subscription to send log to the Event Hub

> Go to Subscription and click on "Resource providers". Search for "Event Grid", and make sure is registered in the "Resources providers".

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/eventgrid.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=3e4ff151375bd311f7cd4f0d81d12421" alt="Azure" data-path="images/integrations/azure/eventgrid.png" />

### 9. Create a new Event by clicking in the Events -> Event Subscription

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/eventsubs.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=5d13aa8b94cac3fe332a05cf4f319f45" alt="Azure" data-path="images/integrations/azure/eventsubs.png" />

### 10.Configure the "Event Subscription" to send logs to the Event Hub created previously.

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/eventhubselection.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=d770c32b55ae95dcf7ebe5b64c4d1404" alt="Azure" data-path="images/integrations/azure/eventhubselection.png" />

### 11. Use the data collected in the previous steps to fill the form as documented below. You can add more than one Event Hub configuration by clicking on the Add tenant button.

<Note>
  >

  * The input field Event Hub Shared access policies - Connection string refers to Azure's Event Hub Shared Access Policies - Connection string-primary key: Value obtained in step 3

  - Consumer Group Name: Value obtained in step 4

  * Storage Container Name: Value obtained in step 6
  * Storage Account Connection string with key: Value obtained in step 7
</Note>

<img height="200" className="block rounded-xl" src="https://mintcdn.com/insecurewebllc/QbitNOzp3ljcQlGB/images/integrations/azure/step11.png?fit=max&auto=format&n=QbitNOzp3ljcQlGB&q=85&s=1ed7b31534e41126bbb361a9b0c0f8cd" alt="Azure" data-path="images/integrations/azure/step11.png" />

### 12. Click on the button shown below, to activate the UTMStack features related to this integration