docs: add Entra ID enterprise application enablement guide (#677)

Add documentation for enabling the NetBird enterprise application in
Microsoft Entra ID, including finding the app by Application ID and
granting admin consent for the directory.
This commit is contained in:
Jack Carter
2026-04-01 16:37:56 +02:00
committed by GitHub
parent 8c7226c050
commit 679ad7b3ad
4 changed files with 46 additions and 0 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 90 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 125 KiB

View File

@@ -333,6 +333,10 @@ export const docsNavigation = [
href: '/manage/team/add-users-to-your-network',
},
{ title: 'Approve Users', href: '/manage/team/approve-users' },
{
title: 'Enable NetBird for Entra ID',
href: '/manage/team/entra-id-app-enablement',
},
{
title: 'Provision Users & Groups',
href: '/manage/team/idp-sync',

View File

@@ -0,0 +1,42 @@
import {Note} from "@/components/mdx";
# Enable NetBird for Microsoft Entra ID
Before your organization can use Microsoft Entra ID features with NetBird — such as user provisioning, group sync, or single sign-on — you need to enable the NetBird enterprise application in your Entra ID tenant and grant admin consent.
## Prerequisites
- A Microsoft Entra ID tenant
- An account with **Global Administrator** or **Cloud Application Administrator** role
## Step 1: Find the NetBird Enterprise Application
1. Sign in to the [Azure portal](https://portal.azure.com)
2. Navigate to **Home** → **Microsoft Entra ID** → **Enterprise Applications**
3. Search for the application with Application ID: `7a7538de-b7ed-4e49-befe-edbe74d5e0a1`
4. Select the **NetBird** application from the results
<p>
<img src="/docs-static/img/manage/team/entra-id-app-enablement/enterprise-applications.png" alt="Find NetBird in Enterprise Applications" className="imagewrapper-big"/>
</p>
## Step 2: Grant Admin Consent
1. In the NetBird application overview, click **Permissions** in the left menu
2. Click **Grant admin consent for Default Directory**
3. Review the requested permissions and confirm
<p>
<img src="/docs-static/img/manage/team/entra-id-app-enablement/grant-admin-consent.png" alt="Grant admin consent for NetBird" className="imagewrapper-big"/>
</p>
<Note>
Granting admin consent allows NetBird to access the necessary directory data for your organization. This is a one-time setup step.
</Note>
## Next Steps
Once admin consent is granted, you can configure Entra ID integration with NetBird:
- [Provision Users & Groups via API](/manage/team/idp-sync/microsoft-entra-id-sync)
- [Provision Users & Groups via SCIM](/manage/team/idp-sync/microsoft-entra-id-scim-sync)