> For the complete documentation index, see [llms.txt](https://docs.cloudassert.com/hybr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudassert.com/hybr/features/cloud-cost-management/getting-started/azure.md).

# Azure

## Onboard an Azure Subscription

## Azure Application Creation

1. Log in to Azure Portal (<https://portal.azure.com/>) and navigate to Azure Active Directory(AAD) -> App Registration.

<figure><img src="/files/bdHGVdzsAVy7GShQ6KB4" alt=""><figcaption><p>Azure Active Directory</p></figcaption></figure>

<figure><img src="/files/ZULn35TmyhSU4CkEXPcV" alt=""><figcaption><p>App Registration</p></figcaption></figure>

2. Select "New Registration" to create a new app registration for AAD.

<figure><img src="/files/B2O7Ndl07ycZs0uVKYeK" alt=""><figcaption><p>Create App Registration</p></figcaption></figure>

3. Give a friendly App Registration name and register it.
4. Once registered, new application will be created.

<figure><img src="/files/uAtVQn0LORYKVhFErLfn" alt=""><figcaption><p>New Application</p></figcaption></figure>

5. Navigate to "Certificates & Secrets" available in the navigation.

<figure><img src="/files/m7D9x30YRqMloFiLMkcX" alt=""><figcaption><p>Certificates &#x26; Secrets Tab</p></figcaption></figure>

6. Create a new client secret for the newly created application.

<figure><img src="/files/xvLnOj8wCNEgxJaki3vz" alt=""><figcaption><p>Create Client Secret</p></figcaption></figure>

7. Give a friendly description for the secret and select its expiry time based on the need and complete the process by adding it.
8. Once the client secret is created, copy the value and save it for the future use, since it can't be retrived again.

<figure><img src="/files/RhUoslANQPx0vfKWxBWZ" alt=""><figcaption><p>Client Secret tab</p></figcaption></figure>

9. Now, an application is created for the subscription with client secret. The details from the Application Overview can be used to onboard Azure Connection for the endpoint type "Azure Subscription Details" without logging in.

<figure><img src="/files/BigT5V27zUmyn4g3oIWM" alt=""><figcaption><p>Onboard Azure Subscription Connection Creation - Step 1</p></figcaption></figure>

<figure><img src="/files/Fb7TpNfvQzkTjY1z7IJv" alt=""><figcaption><p>Onboard Azure Subscription Connection Creation - Step 2</p></figcaption></figure>

10. A detailed explanation and steps for onboarding Azure subscription in Hybr is available below.

## Cost Export Creation

1. Log into Azure Portal(<https://portal.azure.com/>) and navigate to Cost Management.
2. Select "Export" from navigation option available.

<figure><img src="/files/Wjr46FvNhuHZQuNt9jXE" alt=""><figcaption><p>Cost Exports</p></figcaption></figure>

3. Add the cost exports for the selected subscription.

<figure><img src="/files/JGtOA8wl0A6D9mB6VgwO" alt=""><figcaption><p>Add Cost Export</p></figcaption></figure>

4. Give a friendly name for the cost export being added.
5. Select the export type as "Daily", "Weekly", "Monthly" or "One time" based on the need.

<figure><img src="/files/P2ByCUAj4D3MjKrMUTFr" alt=""><figcaption><p>Cost Export type</p></figcaption></figure>

6. Hybr supports the export type of "Daily","Monthly" and "One time", so cost exports can be created for all the three types.
7. Provide Storage accout details, where the cost exports need to be stored.

<figure><img src="/files/RdnJh0WmY2roWqiMK8Ri" alt=""><figcaption><p>Existing Storage Account details</p></figcaption></figure>

8. Either an existing account or new account can be created for any available subscription.

<figure><img src="/files/luUiuULuK1AsTycWw6SS" alt=""><figcaption><p>New Storage Account</p></figcaption></figure>

9. The data provided during the cost export creation will be the exact same details that need to be provided during the azure connection onboard in Hybr for the endpoint type "Azure Cost Export" without getting Admin consent.

<figure><img src="/files/yJb3YBCY1JV1FBvjT4J8" alt=""><figcaption><p>Onboard Azure Cost Export Connection - Step 1</p></figcaption></figure>

<figure><img src="/files/qC2uAv4AhWbVY3Zuvtvg" alt=""><figcaption><p>Onboard Azure Cost Export Connection - Step 2</p></figcaption></figure>

10. A detailed explanation and steps for onboarding Azure Cost Export connection in Hybr is available below.

## Onboard an Azure Subscription

Log in to Hybr Admin portal and navigate to Reporting → Data Sources -> Connections page.

**Note**: The below pre-requisite is required only when the Azure Application has to be created automatically. It is not needed for manual onboard.

#### Pre-requisite:

A Global Administrator of Azure Active Directory is required to grant Admin Consent to Hybr Application for creating Azure Application and Service Principal to access the subscription resources.

1. Click on Grant Admin Consent button

   <figure><img src="/files/4sptr9T6QI0li7uoOMEi" alt=""><figcaption><p>Reporting -> Data Sources -> Connections</p></figcaption></figure>

2. Grant Admin Consent dialog opens. Click on ok button

   <figure><img src="/files/KkXYfGZjzEoGhlEPirjp" alt=""><figcaption></figcaption></figure>

3. Login with an account (Global Administrator) who has permissions to grant access. A pop-up window opens requesting permission to grant access for Hybr Application.&#x20;

4. Select the checkbox 'Consent on behalf of your organization' and click Accept button.

<figure><img src="/files/sShH8iLDpcmpD4Xx7Eyt" alt=""><figcaption></figcaption></figure>

### Creating a Azure Connection

To create a new connection, follow these steps:

1. Log in to Hybr Admin portal and navigate to Reporting → Data Source -> Connections page.
2. Create a Azure Connection using Create Connection button.

<figure><img src="/files/Ezb7DL3M5HV8gzjd1J64" alt=""><figcaption><p>Reporting -> Data Sources -> Connections</p></figcaption></figure>

4. Select Connection category as "Azure".
5. Give a friendly connection name to the Azure connection.

<figure><img src="/files/uwouaD9kbDK6wos4GCbz" alt=""><figcaption></figcaption></figure>

6. Click on any endpoint to create an Azure connection
7. Select or de-select Continue without Logging In Button based on your needs.

* Login and onboard (Continue without logging in is de-selected) - Will allow to login in using Azure credentials and automatically shows up the subscriptions available for the logged in user, from which he can select the required subscription.
* Manual onboard (Continue without logging in is selected) - The user can continue to onboard the subscription by manually providing the required details.( Prerequisite : The necessary needed resources for Azure connection( Azure Application, Service Principal, Cost Exports, etc.) should be created from Azure Portal and those details must be provided) &#x20;

#### Login and onboard a subscription

8. Select the Endpoint as "Azure Subscription Details" and click Next button
9. Login pop-up window appears. Provide the credentials which has access to the subscription that needs to be onboarded
10. Once the login is successful, the user subscriptions will be listed.
11. Select the required subscription
12. Selecting 'Create Azure Application automatically' will create an application and service principal automatically if the logged in user has required permissions to create them. If the user does not have the permission to create an application, unselect the checkbox and click on  next step

<figure><img src="/files/f2GU7Ksu0OybklPIxUuZ" alt=""><figcaption></figcaption></figure>

11. The Azure Application and service principal will be created and access control will be provided to the service principal to access subscription resources.

<figure><img src="/files/cX49xyE1bcd1Py68J7q8" alt=""><figcaption></figcaption></figure>

11. In next step, select 'Configure Azure Cost Export' to configure the cost exports for selected subscription
12. Select Cost Export Data Type as Daily, Monthly and One-Time, Type as Usage or Actual Cost.
13. Select the storage subscription and storage account where cost exports should be downloaded

<figure><img src="/files/nM5P8gj0zmsR3kB9bRSC" alt=""><figcaption></figcaption></figure>

11. Click Complete button to create the required Azure Cost Exports and Azure Connections.
12. This will create both Azure Api Endpoint Connection and Azure Cost Export Connection

<figure><img src="/files/w6On91dqAfvw9AdVoHRd" alt=""><figcaption></figcaption></figure>

#### Manual Onboard

Pre-Requisite : Create necessary resources before entering the credentials (e.g. Subscription)

#### Azure Cost Export

<figure><img src="/files/gbER3SWMAHhjEbubZtq0" alt=""><figcaption></figcaption></figure>

1. Select the Endpoint as "Azure Cost Export" and click Next button

<figure><img src="/files/ux6JsbGjLTG3eqsEIjVS" alt=""><figcaption></figcaption></figure>

2. &#x20;Enter the Subscription Id for which cost export need to be done
3. Cost Export Data Type :

* Usage Cost - Selecting this will export the Usage Cost
* Actual Cost - Selecting this will export the Actual  Cost

4. Export Type :

* Daily - Selecting this will export data with granularity Daily

Selecting this granularity will ask for Storage Directory for Daily granularity and its Exports name           &#x20;

<figure><img src="/files/Tbp8lftBzCriaIoPKzmb" alt=""><figcaption></figcaption></figure>

* Monthly - Selecting this will export data with granularity Monthly

Selecting this granularity will ask for Storage Directory for Monthly granularity and its Exports name  &#x20;

&#x20;&#x20;

<figure><img src="/files/pLn5kJypfT3jGQF0Vzcu" alt=""><figcaption></figcaption></figure>

* One Time - Selecting this will export data with granularity One Time

Selecting this granularity will ask for Storage Directory for One time granularity and its Exports name     &#x20;

&#x20;     &#x20;

<figure><img src="/files/ZMPXVjIXMN5Fvb9zTbUF" alt=""><figcaption></figcaption></figure>

5. Enter the Storage Subscription Id and Storage Account Connection string where the exports will be downloaded and complete the wizard

<figure><img src="/files/R2sMYQ0rtQZKlHRVcO3b" alt=""><figcaption></figcaption></figure>

#### Azure Subscription Details

<figure><img src="/files/GxG3Wvhdbe60kN0nExG2" alt=""><figcaption></figcaption></figure>

1. Select the Endpoint as "Azure Subscription Details" and click Next button
2. Enter the Subscription Id, Tenant Id, Application Id and Secret , Arm endpoint Url and TokenRequest Resource Url and click next

<figure><img src="/files/wL46JdwXSrksKCzVtr8e" alt=""><figcaption></figcaption></figure>

3. Configure Azure Cost Export

<figure><img src="/files/MZntwVV9tXPoaKPhhoLa" alt=""><figcaption></figcaption></figure>

* Enable - will create a connection for azure cost export connection ( as same as above steps for cost export)
* Disable - Only creates connection with subscription details &#x20;

4. Connection will be created

<figure><img src="/files/Imx8rmzU16U66HLzTGQB" alt=""><figcaption></figcaption></figure>

### Editing an Azure Connection

If you want to make changes to an existing connection, follow these steps.

1. Log in to Hybr Admin portal and navigate to Reporting → Data Sources -> Connections page.
2. Select the connection and click on the "Edit" button&#x20;

<figure><img src="/files/aVn9wSDOfzRG3lPlqYdT" alt=""><figcaption></figcaption></figure>

3. The saved details will be auto filled in the wizard

#### Cost Export Connection Wizard

<figure><img src="/files/kBfxfxV5Uz8t6X6Lophp" alt=""><figcaption></figcaption></figure>

#### Subscription Connection Wizard

<figure><img src="/files/ybi40GJxhDEu6A00eSks" alt=""><figcaption></figcaption></figure>

3. Make the desired changes to your connection.
4. Save your changes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cloudassert.com/hybr/features/cloud-cost-management/getting-started/azure.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
