Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
45 commits
Select commit Hold shift + click to select a range
1f4de20
docs: Add Azure multi-resource graph sync guide
melodyogonna Oct 9, 2025
aff75f7
docs: Improve clarity of Azure Resource Graph description
melodyogonna Oct 9, 2025
fe61736
docs: Refine Azure Resource Graph integration benefits
melodyogonna Oct 9, 2025
f9bcc03
docs: Improve intro and benefits for Azure Resource Graph integration
melodyogonna Oct 9, 2025
e059008
docs: Add supported resources section for Azure multi-resource graph
melodyogonna Oct 9, 2025
5dbd723
fix: Correct Azure ARG supported resources table descriptions
melodyogonna Oct 9, 2025
96cb542
docs: Refactor Azure Resource Graph to use Ocean framework config
melodyogonna Oct 9, 2025
02f963b
docs: Improve Azure multi-resource graph overview section
melodyogonna Oct 9, 2025
ad51c4f
docs: Update Azure multi-resource-graph overview content
melodyogonna Oct 9, 2025
633e1a4
docs: Update Azure Resource Graph overview for Ocean framework
melodyogonna Oct 9, 2025
34ac85b
docs: Add Azure Resource Graph sync documentation
melodyogonna Oct 13, 2025
ff5dc3d
docs: Improve Azure resource group tag filtering description
melodyogonna Oct 13, 2025
f65cfd8
docs: Add note for improving resource type filtering explanation
melodyogonna Oct 13, 2025
4476b6d
docs: Improve explanation of Azure Resource Graph resource type filte…
melodyogonna Oct 13, 2025
1b8dfd8
docs: Clarify resource type filtering for Azure Resource Graph
melodyogonna Oct 13, 2025
08a46a8
docs: Improve clarity of Azure Resource Graph resource type filtering
melodyogonna Oct 13, 2025
a03344e
chore: Add AI improvement placeholder to Azure Resource Graph FAQ
melodyogonna Oct 13, 2025
341071f
docs: Improve Azure resource graph FAQ on resource group filtering
melodyogonna Oct 13, 2025
adcf2f9
docs: Add internal question regarding Azure RG subscription limit
melodyogonna Oct 13, 2025
ba336f4
docs: Update Azure Resource Graph subscription sync limit to 5000
melodyogonna Oct 13, 2025
6aee654
<!-- silent -->
melodyogonna Oct 13, 2025
a8c3677
docs: Improve Azure Resource Graph integration overview section
melodyogonna Oct 13, 2025
0c7ed97
Delete old docs file
melodyogonna Oct 13, 2025
edaa94f
Merge branch 'main' of github.com:port-labs/port-docs into PORT-16507…
melodyogonna Oct 13, 2025
2d672c9
Chore: Remove reference to deleted incremental sync page
melodyogonna Oct 13, 2025
eda2da4
Fix integration version
melodyogonna Oct 14, 2025
b7f5440
Merge branch 'PORT-16507-azure-ms-documentation' of github.com:port-l…
melodyogonna Oct 14, 2025
4fd7f66
Deprecate multi-subscriptions page
melodyogonna Oct 14, 2025
a67308a
docs: Update formatting and indentation in Azure App Registration guide
kodjomiles Oct 14, 2025
11246f1
docs: Improve Azure Resource Graph documentation structure and examples
melodyogonna Oct 14, 2025
7fbd30d
docs: Make Azure Resource Graph config options succinct
melodyogonna Oct 14, 2025
dbe02ec
docs: Add AI prompt to shorten Azure ARG filtering description
melodyogonna Oct 14, 2025
95ef22e
docs: Refine Azure Resource Graph filtering description
melodyogonna Oct 14, 2025
36d0b70
docs: Add comment to improve FAQ section
melodyogonna Oct 14, 2025
ac1b728
docs: Make Azure Resource Graph FAQ more succinct
melodyogonna Oct 14, 2025
6019596
Merge branch 'PORT-16507-azure-ms-documentation' of github.com:port-l…
melodyogonna Oct 14, 2025
da07fa3
Merge branch 'main' of github.com:port-labs/port-docs into PORT-16507…
melodyogonna Oct 14, 2025
a4e432d
Add prerequisite to gitlab ci section
melodyogonna Oct 14, 2025
b96cc43
Chore: Reduce repetition in link
melodyogonna Oct 14, 2025
03e186d
docs: Update Azure Resource Graph documentation for clarity and struc…
kodjomiles Oct 14, 2025
ce09811
Merge branch 'PORT-16507-azure-ms-documentation' of github.com:port-l…
kodjomiles Oct 14, 2025
b9a968d
fix: Correct link to Azure App Registration Credentials in Azure Reso…
kodjomiles Oct 14, 2025
8e94fa7
Use admonition in the mapping comment
melodyogonna Oct 14, 2025
5e51758
Chore: use note rather than info for call out
melodyogonna Oct 14, 2025
59e877f
Add beta tag and deprecation notice
melodyogonna Oct 14, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -4,40 +4,40 @@ To ingest resources from Azure, you will need to create an Azure App Registratio

1. Create an Azure App Registration in the Azure portal.

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/1-app-registration.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/1-app-registration.png' width='85%' border='1px' /> <br/><br/>

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/2-register-an-application.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/2-register-an-application.png' width='85%' border='1px' /> <br/><br/>

2. Copy the `Application (client) ID` and `Directory (tenant) ID` from the App Registration.

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/3-result-of-app-registration.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/3-result-of-app-registration.png' width='85%' border='1px' /> <br/><br/>

3. Create a client secret for the App Registration.

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/4-creating-client-secret.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/4-creating-client-secret.png' width='85%' border='1px' /> <br/><br/>

4. Copy the `Application (client) Secret` from the App Registration.

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/5-copy-secret-value.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/5-copy-secret-value.png' width='85%' border='1px' /> <br/><br/>

5. Create a new role assignment for the App Registration. Go to the `Access control (IAM)` section of the subscription
you want to ingest resources from.<br/><br/>Click on `Add role assignment`.

:::info Multi Account Support
It is supported to ingest resources from multiple subscriptions, for that you will have to repeat the role assignment
for each subscription you want to ingest resources from.
:::
:::info Multi Account Support
It is supported to ingest resources from multiple subscriptions, for that you will have to repeat the role assignment
for each subscription you want to ingest resources from.
:::

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/6-add-role-assignment.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/6-add-role-assignment.png' width='85%' border='1px' /> <br/><br/>

6. Assign the `Reader` role to the App Registration.

:::tip Permissions
The Reader role is recommended for querying all resources in your Azure subscription. You can restrict permissions to specific resource groups or types by assigning a different role. If you do this, remember to adjust permissions when adding more resources to the catalog.
Basic permissions required for ingesting resources from Azure include:
- `Microsoft.Resources/subscriptions/read` (to list the accessible subscriptions)
- `Microsoft.Resources/subscriptions/resourceGroups/read` (to list the accessible resource groups)
- `read`/`list` permissions to the resources you want to ingest
:::
:::tip Permissions
The Reader role is recommended for querying all resources in your Azure subscription. You can restrict permissions to specific resource groups or types by assigning a different role. If you do this, remember to adjust permissions when adding more resources to the catalog.
Basic permissions required for ingesting resources from Azure include:
- `Microsoft.Resources/subscriptions/read` (to list the accessible subscriptions)
- `Microsoft.Resources/subscriptions/resourceGroups/read` (to list the accessible resource groups)
- `read`/`list` permissions to the resources you want to ingest
:::

<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/7-assign-member-to-role.png' width='85%' border='1px' /> <br/><br/>
<img src='/img/build-your-software-catalog/sync-data-to-catalog/cloud-providers/azure/app-registration/7-assign-member-to-role.png' width='85%' border='1px' /> <br/><br/>
Loading