> ## Documentation Index
> Fetch the complete documentation index at: https://specterops-bp-2641-crowdstrike-integration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SAML: Entra ID Configuration

> This document provides instructions for creating an application within Entra ID for compatibility with BloodHound Enterprise.

export const IDPIntro = ({auth_mode}) => {
  const mode = (auth_mode || '').toUpperCase();
  const isOIDC = mode === 'OIDC';
  const href = isOIDC ? '/manage-bloodhound/auth/oidc' : '/manage-bloodhound/auth/saml';
  const label = isOIDC ? 'OIDC' : 'SAML';
  return <Tip>
      See <a href={href}>{label} in BloodHound</a> for order of operations, general {label} setup, and user configuration in BloodHound.
    </Tip>;
};

<img noZoom src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/_rZ1zFkP5xLBuV5I/assets/enterprise-AND-community-edition-pill-tag.svg?fit=max&auto=format&n=_rZ1zFkP5xLBuV5I&q=85&s=2b8e51d7e5a52c262dd70a93b9024f7e" alt="Applies to BloodHound Enterprise and CE" width="482" height="45" data-path="assets/enterprise-AND-community-edition-pill-tag.svg" />

<IDPIntro auth_mode="SAML" />

## Create an Enterprise Application

1. Login to Azure at [https://portal.azure.com](https://portal.azure.com)
2. Navigate to the **Enterprise Applications** section of Entra ID.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-44.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=ec39fa30d39954a5f10b29107e8223b0" width="430" height="207" data-path="assets/image-2-44.png" />
</Frame>

3. Click **New Application**.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-46.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=c9f3c99fdc9b8ccbfea37f490dc4d143" width="564" height="171" data-path="assets/image-2-46.png" />
</Frame>

4. Click **Create your own application**.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-47.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=ac1deac4291ee183cc34cbc1beb259f7" width="484" height="231" data-path="assets/image-2-47.png" />
</Frame>

5. Provide a name for your application and click **Create**.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-48.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=f58570108333acbcba675afc73d12cd1" width="573" height="850" data-path="assets/image-2-48.png" />
</Frame>

## Configure Single Sign-On Settings

1. Your browser should redirect you to your newly created application. Click on **Single sign-on**.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-49.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=e1bd8040f0f936a7eeed5484801c6169" width="406" height="498" data-path="assets/image-2-49.png" />
</Frame>

2. Click on **SAML**.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-50.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=fff13fd3af2fe47c225480a73f0a3ea7" width="370" height="199" data-path="assets/image-2-50.png" />
</Frame>

3. Click **Edit** under the Basic SAML Configuration section.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-51.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=b0a310d6f88c3dc90a15e35d73c1bef7" width="760" height="226" data-path="assets/image-2-51.png" />
</Frame>

4. Configure SAML. The following screenshot shows the tenant codename is "demo" and the provider name is "entra".

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-52.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=b7c43db98d5eadbb88a02b182646359b" width="793" height="651" data-path="assets/image-2-52.png" />
</Frame>

5. Azure will inform you the settings have saved successfully.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-53.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=c80af070c81cebed370bbf644a1dc9b7" width="358" height="77" data-path="assets/image-2-53.png" />
</Frame>

6. Click the **X** to close the dialog.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-54.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=30e8c6f3fff11b53d96c194ee5f2a14b" width="859" height="250" data-path="assets/image-2-54.png" />
</Frame>

7. Scroll down to the **SAML Certificates** section and download the **Metadata XML**.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-55.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=251edfa2c1cc27e3dd51519c1d369c3f" width="765" height="408" data-path="assets/image-2-55.png" />
</Frame>

8. Use the **Users and Groups** section to configure groups and users which you would like to grant access to BloodHound Enterprise.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-56.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=985531725636ffaa42148998e059681a" width="436" height="371" data-path="assets/image-2-56.png" />
</Frame>

9. Use the downloaded metadata.xml file and follow the instructions at [SAML in BloodHound Enterprise](/manage-bloodhound/auth/saml) to Create the SAML Configuration in BloodHound.

## Troubleshooting

Verify your attributes and claims use a proper schema in the claim name, and that you have a properly mapped claim for "user.mail" as in the example below. An indicator that this is necessary is when an authentication attempt returns the response: "*assertion does not meet requirements for user lookup*".

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2641-crowdstrike-integration/oIy7WEPaKrQdJo1n/assets/image-2-57.png?fit=max&auto=format&n=oIy7WEPaKrQdJo1n&q=85&s=cae9ea77f4a659f4897c00eeb5956b15" width="1075" height="988" data-path="assets/image-2-57.png" />
</Frame>
