# Microsoft Azure Virtual Machines

## Connection Requirements

{% stepper %}
{% step %}

### URL

Url Address:

> 🔵 Default:\
> login.microsoftonline.com
> {% endstep %}

{% step %}

### Tenant ID & Client ID

* Log in to the Azure Portal with an administrator account.
* Search for App registrations.
* Select App registrations > New registration. Fill in the details and click Register.
* After you have created the app, the Application ID (Client ID) and Directory ID (Tenant ID) values are displayed.
  {% endstep %}

{% step %}

### Client Secret

In the left menu, click Certificates & Secrets, then click New Client Secret. Click Add and copy the secret.
{% endstep %}

{% step %}

### Subscription ID

Follow these steps to get the identity of a subscription in the Azure portal:

* Sign in to the Azure portal.
* Under the Azure services heading, select Subscriptions.
* Find the Subscription ID for the subscription shown in the second column.
* Copy the Subscription ID.
  {% endstep %}

{% step %}

### Proxy

Proxy URL. (optional)
{% endstep %}

{% step %}

### Is Secure?

Enable this option if the connection will be established over HTTPS.
{% endstep %}

{% step %}

### Fetch Devices

Choose to fetch devices or not.
{% endstep %}

{% step %}

### Fetch Certificates

Choose to fetch certificates or not. Your app needs to have Key Vault Certificate User and Key Vault Reader roles.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
⚠️ Attention\
Please perform a **connection test** to ensure there is a valid connection to the host.\
When the discovery operation is finalized, you will be able to see the details on the **Assets** page.
{% endhint %}


---

# 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.octoxlabs.com/adapters/adapters/microsoft-azure-virtual-machines.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.
