Skip to content
Open
Show file tree
Hide file tree
Changes from 11 commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
25b4689
chore: update version references; add tabs for auth methods
jeff-matthews Nov 7, 2025
538326e
docs: updates based on semi-successful config
jeff-matthews Nov 14, 2025
9b058dd
chore: editorial notes
jeff-matthews Nov 14, 2025
f50d321
docs: rewrite app registration and ms graph permissions
jeff-matthews Nov 18, 2025
ca0dbd7
docs: remove optional branding steps
jeff-matthews Nov 18, 2025
4299fee
chore: segment assign required access roles sections
jeff-matthews Nov 18, 2025
e52c654
chore: delete obsolete editorial note
jeff-matthews Dec 2, 2025
8f0dc6f
chore: formatting
jeff-matthews Dec 2, 2025
ffd73c8
docs: add placeholder sections for managed ID config
jeff-matthews Dec 2, 2025
4aedb0b
docs: clarify prerequisites
jeff-matthews Dec 2, 2025
379dffe
chore: remove VM note
jeff-matthews Dec 2, 2025
e238c10
chore: fix snippet file name and imports
jeff-matthews Dec 2, 2025
ff630a2
chore: fix typo
jeff-matthews Dec 2, 2025
bc4b0cd
Merge branch 'main' into BED-6715-managed-id-auth-method
jeff-matthews Jan 26, 2026
17dbac3
Merge branch 'main' into BED-6715-managed-id-auth-method
jeff-matthews May 13, 2026
9157f2e
chore: restore optional branding section since it's part of the ps sc…
jeff-matthews May 13, 2026
d15d578
chore: add missing image alt text
jeff-matthews May 13, 2026
7283670
docs: apply suggestions based on codex audit
jeff-matthews May 13, 2026
934ac6d
docs: apply suggestions from augment audit
jeff-matthews May 13, 2026
3a2da05
docs: apply suggestino from CR review
jeff-matthews May 13, 2026
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
Binary file removed docs/assets/azurehound-install-app-registrations.png
Binary file not shown.
Binary file removed docs/assets/azurehound-install-branding-result.png
Binary file not shown.
Binary file removed docs/assets/azurehound-install-branding.png
Binary file not shown.
Binary file removed docs/assets/azurehound-install-upload-logo.png
Binary file not shown.
Binary file removed docs/assets/image-103.png
Binary file not shown.
Binary file removed docs/assets/image-106.png
Binary file not shown.
Binary file removed docs/assets/image-108.png
Binary file not shown.
Binary file removed docs/assets/image-110.png
Binary file not shown.
Binary file removed docs/assets/image-111.png
Binary file not shown.
Binary file removed docs/assets/image-113.png
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
584 changes: 373 additions & 211 deletions docs/install-data-collector/install-azurehound/azure-configuration.mdx

Large diffs are not rendered by default.

141 changes: 101 additions & 40 deletions docs/install-data-collector/install-azurehound/create-configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,23 @@ title: Create an AzureHound Configuration
description: Learn how to create a configuration file for AzureHound Enterprise data collection.
---

import ManagedIdentityRecommendation from '/snippets/hounds/manged-id-recommendation.mdx';
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Outdated

<img noZoom src="/assets/enterprise-edition-pill-tag.svg" alt="Applies to BloodHound Enterprise only"/>

## Prerequisites

To complete the configuration process, you must have the following information:

| Item | Description |
| --- | --- |
| Directory (tenant) ID | Identifies the Microsoft Entra ID instance where you must [register](/install-data-collector/install-azurehound/azure-configuration) the AzureHound Enterprise application. |
| Application (client) ID | Identifies the AzureHound Enterprise [app registration](/install-data-collector/install-azurehound/azure-configuration) that you must create in the Microsoft Entra admin center. |
| AzureHound token ID | Identifies the AzureHound Enterprise [collector client](/collect-data/enterprise-collection/create-collector) that you must create in BloodHound Enterprise. |
| AzureHound token | Provides the authentication key for the AzureHound Enterprise [collector client](/collect-data/enterprise-collection/create-collector) that you must create in BloodHound Enterprise. |
| **Directory (tenant) ID** | Identifies the Microsoft Entra ID instance where you must [register](/install-data-collector/install-azurehound/azure-configuration) the AzureHound Enterprise application. |
| **Application (client) ID** | Identifies the AzureHound Enterprise [app registration](/install-data-collector/install-azurehound/azure-configuration) that you must create in the Microsoft Entra admin center. |
| **AzureHound token ID** | Identifies the AzureHound Enterprise [collector client](/collect-data/enterprise-collection/create-collector) that you must create in BloodHound Enterprise. |
| **AzureHound token** | Provides the authentication key for the AzureHound Enterprise [collector client](/collect-data/enterprise-collection/create-collector) that you must create in BloodHound Enterprise. |
| **BloodHound Enterprise URL** | The URL of your BloodHound Enterprise tenant (for example, `https://enterprise.bloodhoundenterprise.io/`). |
| **Managed Identity Client ID** | If using [Azure Managed Identity](/install-data-collector/install-azurehound/azure-configuration#managed-identity-recommended) authentication, identities the Managed Identity assigned to the Entra ID [app registration](/install-data-collector/install-azurehound/azure-configuration). |
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Outdated
| **Certificate and private key** | If using [Certificate](/install-data-collector/install-azurehound/azure-configuration#certificate) authentication, identifies the certificate and private key to authenticate the AzureHound Enterprise application. The AzureHound Enterprise CLI tool can generate this for you during the configuration process if needed. |
Comment thread
jeff-matthews marked this conversation as resolved.
Outdated

Configuring AzureHound Enterprise involves the following steps:

Expand Down Expand Up @@ -57,7 +64,7 @@ Follow the steps below to create your AzureHound Enterprise configuration file u
1. Start the AzureHound Enterprise CLI tool with the `configure` command.

```text
C:\Users\Administrator.ROOT\Downloads\azurehound-v2.0.5\azurehound-windows-amd64>azurehound.exe configure
C:\Users\Administrator.ROOT\Downloads\azurehound-v2.8.1\azurehound-windows-amd64>azurehound.exe configure
```

To see all available options, run `azurehound.exe -h`.
Expand All @@ -67,7 +74,7 @@ Follow the steps below to create your AzureHound Enterprise configuration file u
<Note>Most organizations use the `cloud` region.</Note>

```text
AzureHound v2.0.5
AzureHound v2.8.1
Created by the BloodHound Enterprise team - https://bloodhoundenterprise.io

Use the arrow keys to navigate: ↓ ↑ ← →
Expand All @@ -93,51 +100,105 @@ Follow the steps below to create your AzureHound Enterprise configuration file u
</Step>

<Step title="Configure AzureHound authentication">
1. Select a method for authenticating AzureHound Enterprise to BloodHound Enterprise.
Choose one of the following authentication methods for AzureHound Enterprise to connect to your Microsoft Entra ID and Azure environment:

<Note>We **highly** recommend certificate-based authentication.</Note>
<Note>We **highly** recommend **Azure Managed Identity**-based authentication.</Note>

```text
Use the arrow keys to navigate: ↓ ↑ ← →
? Authentication Method:
> Certificate
Client Secret
Username and Password
```
<Tabs>
<Tab title="Azure Managed Identity" icon="key">

1. If using Certificate authentication, press **Enter** or type `Y` to create a new certificate and key.
<ManagedIdentityRecommendation />

```text
Authentication Method: Certificate
? Generate Certificate and Key? [Y/n]
```
Before configuring Azure Managed Identity authentication, you must first create a [user-assigned managed identity](/install-data-collector/install-azurehound/azure-configuration#managed-identity-recommended).

1. Select **Azure Managed Identity** as the authentication method.

```text
Use the arrow keys to navigate: ↓ ↑ ← →
? Authentication Method:
Certificate
Client Secret
Username and Password
> Azure Managed Identity
```

1. Select the type of Managed Identity.

```text
Use the arrow keys to navigate: ↓ ↑ ← →
? Managed Identity Type:
System-Assigned
> User-Assigned
```

1. Enter the **Client ID** of the User-Assigned Managed Identity.

```text
v Input the User-Assigned Managed Identity (Client ID):
```

<Note>To find the Client ID, navigate to the Managed Identity in the Azure portal and copy the value from the **Client ID** field in the Overview.</Note>

<Note>
- The certificate generated by AzureHound expires after one year.
- If using a certificate issued by another authority, AzureHound Enterprise supports certificates with the following characteristics:
- PEM encoded
- RSA 256
- PKCS#8 or PKCS#5
</Note>
1. Press **Enter** (or enter `Y`) to connect to BloodHound Enterprise.

1. If using Certificate authentication, enter an optional passphrase for the private key.
```text
? Setup connection to BloodHound Enterprise? [Y/n]
```

1. Enter the URL of your BloodHound Enterprise tenant.

```text
v BloodHound Enterprise URL: https://enterprise.bloodhoundenterprise.io/
```
</Tab>

<Tab title="Certificate" icon="file-certificate">
1. Select **Certificate** as the authentication method.

```text
Use the arrow keys to navigate: ↓ ↑ ← →
? Authentication Method:
> Certificate
Client Secret
Username and Password
Azure Managed Identity
```

1. Press **Enter** or type `Y` to create a new certificate and key.

```text
Authentication Method: Certificate
? Generate Certificate and Key? [Y/n]
```

<Note>
- The certificate generated by AzureHound expires after one year.
- If using a certificate issued by another authority, AzureHound Enterprise supports certificates with the following characteristics:
- PEM encoded
- RSA 256
- PKCS#8 or PKCS#5
</Note>

1. Enter an optional passphrase for the private key.

```text
Authentication Method: Certificate
v Private Key Passphrase (optional):
```
```text
Authentication Method: Certificate
v Private Key Passphrase (optional):
```

1. Press **Enter** (or enter `Y`) to connect to BloodHound Enterprise.
1. Press **Enter** (or enter `Y`) to connect to BloodHound Enterprise.

```text
? Setup connection to BloodHound Enterprise? [Y/n]
```
```text
? Setup connection to BloodHound Enterprise? [Y/n]
```

1. Enter the URL of your BloodHound Enterprise tenant.
1. Enter the URL of your BloodHound Enterprise tenant.

```text
v BloodHound Enterprise URL: https://enterprise.bloodhoundenterprise.io/
```
```text
v BloodHound Enterprise URL: https://enterprise.bloodhoundenterprise.io/
```
</Tab>
</Tabs>
</Step>

<Step title="Configure AzureHound collector client">
Expand Down
1 change: 1 addition & 0 deletions docs/snippets/hounds/manged-id-recommendation.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Microsoft [recommends](https://learn.microsoft.com/en-us/entra/identity/managed-identities-azure-resources/overview#use-managed-identities-for-azure-resources) the User-Assigned Managed Identity for Microsoft services, so the following example shows the **User-Assigned** type.