# Getting Started with Azure

Two methods are available when connecting and importing diagram data from Azure into Hava. Both ways produce the exact information required using Powershell or the Azure Portal.

The first time importing into Hava, you will be presented with a welcome screen with a container displaying "Import your own environments".

![Getting Started with Azure](https://3601125483-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Loco-kTiJ7Tu_lfPZqb%2Fuploads%2FO2quuE5bDUC8rHjhHbtp%2FHava__Welcome_Screen.jpg?alt=media\&token=0483febb-5ac3-4038-bb86-173364695645)

If you've imported before, there will be a different container, same as the right image below.

![Add Environment](https://codahosted.io/docs/cYayXS-HlE/blobs/bl-qFkqQQ2yp1/876f968c83f712f76bb64a5ee6a5668fb7406795c4ab8bac33ac9dd45a82c1dfc1829d4dd1370e2d6059aa4fdd666a5b85d4a953d7c2d17300c6bed493e5f031f8638733a8dffc730160504abcf1f77230202254264c5ee2d5cfce1cb1ef1bd8a56afc8e)

<figure><img src="https://3601125483-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Loco-kTiJ7Tu_lfPZqb%2Fuploads%2FT2M8CUv7MtaYTJfKYfPF%2FHava_Add_New_Cloud_Environment.jpg?alt=media&#x26;token=99ac2214-0cfc-4091-808e-2315b2033dab" alt=""><figcaption><p>Add new environment</p></figcaption></figure>

### 1. Add Environment

Simply click on the  button.

### 2. Select Azure

From the left hand menu select Azure.

![](https://codahosted.io/docs/cYayXS-HlE/blobs/bl-f_McExlY1D/f0dae9b9664ed15e7f22c3afac54be6e2988aaab3b119e0dec8d5371207f28dca8dd10757d10ba228475992cef3a22a721109ef38f056f2f0d24f8c93bddd662817236add5d85baa35ac9eca132cbe48a38702401538332b10d30881b59220bdab818323)

<figure><img src="https://3601125483-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Loco-kTiJ7Tu_lfPZqb%2Fuploads%2Fe5mF5pxulZFXLGjsVdOS%2FAdd_Azure_Environment_to_Hava.jpg?alt=media&#x26;token=42c7d2c5-555b-4e25-b4f4-89f2c6047181" alt=""><figcaption></figcaption></figure>

### 3. Create a new Service Principal

Here you will need to create a new Service Principal and retrieve a set of ids and secret keys using Powershell or the Azure Portal at <https://portal.azure.com>. <br>

{% hint style="info" %}
The recommended method to create your credentials is using Powershell. It can be run locally or directly from the Azure Portal, and offers a much simpler approach.
{% endhint %}

* Guide to using Powershell

{% content-ref url="getting-started-with-azure/powershell" %}
[powershell](https://docs.hava.io/importing/azure/getting-started-with-azure/powershell)
{% endcontent-ref %}

* Guide to using the Azure Portal

{% content-ref url="getting-started-with-azure/azure-portal" %}
[azure-portal](https://docs.hava.io/importing/azure/getting-started-with-azure/azure-portal)
{% endcontent-ref %}

### 4. Import

Once this is complete and the Subscription ID, Tenant ID, Client ID and Secret Key have been populated into Hava simply hit the IMPORT button.<br>

![](https://codahosted.io/docs/cYayXS-HlE/blobs/bl-xbL5l1bsIK/c7f84d39a59e78306e35387d488683c11c4772af9ee52009bddd96b7fc47c1428e64819f2a8298197ded691e7a6cf7e1c53c427a44bf2b3a3fd91d4cd6101ef8d65ef7829a8d46a1ed8e7c1154a01015b92600ff682aef40488d4e3bea2acb29ebb07831)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hava.io/importing/azure/getting-started-with-azure.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.