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

# SAML: ADFS Configuration

> This document provides instructions for creating an application within ADFS 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-2731-onprem-architecture/cSg9r7u_qWc5sQQj/assets/enterprise-AND-community-edition-pill-tag.svg?fit=max&auto=format&n=cSg9r7u_qWc5sQQj&q=85&s=332ab7c1e25fb10fd9f92afff92c688b" 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 Application

1. In the AD FS management console, right-click on Relaying Party Trust and click “Add Relaying Party Trust”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-25.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=f0e02a4a9687b04b6a9492e07caae3f4" width="936" height="478" data-path="assets/image-2-25.png" />
</Frame>

2. Choose “Claims aware” and click “Start”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-26.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=07f092f81b5fc8f17df427b94d8f1c4d" width="936" height="762" data-path="assets/image-2-26.png" />
</Frame>

3. Insert the metadata URL based on your chosen name and click “Next.”

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-27.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=dc816c25a6ab1f5311f720a5ae82c1f4" width="936" height="762" data-path="assets/image-2-27.png" />
</Frame>

4. Enter the preferred display name and click “Next.”

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-28.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=f88656b0becda91c186d9ac9be0b33d5" width="936" height="762" data-path="assets/image-2-28.png" />
</Frame>

5. Choose the desired Access Control Policy. (Note that access and permissions are configured within BloodHound Enterprise).

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-29.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=1191d842fe87087ef3fd9ed851261e11" width="936" height="762" data-path="assets/image-2-29.png" />
</Frame>

6. Review the information presented and click “Next”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-30.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=d2bf8cb4e6073a4a839e98675d1adca6" width="936" height="762" data-path="assets/image-2-30.png" />
</Frame>

7. Leave the “Configure claims issuance policy for this application” box checked and click “Close”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-31.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=c0bea2760f38e7a8beac5bfcf53458ea" width="936" height="762" data-path="assets/image-2-31.png" />
</Frame>

## Complete SAML Integration Configuration

1. On the “Edit Claim Issuance Policy” dialog box, click “Add Rule…”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-32.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=63381d40adf85f88c67e6184ab5c9373" width="936" height="1046" data-path="assets/image-2-32.png" />
</Frame>

2. Choose “Send LDAP Attributes as Claims” and click “Next.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-33.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=c967a7032451f1d53a4f6b0018751f09" width="936" height="762" data-path="assets/image-2-33.png" />
</Frame>

3. Fill out the following and click “Finish”.

   LDAP Attribute: E-Mail-Addresses
   Outgoing Claim Type : E-Mail Address

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-34.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=ad8d48afe7620fbcbf668023b5799392" width="936" height="762" data-path="assets/image-2-34.png" />
</Frame>

4. Click “Add Rule” to add another claim rule.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-35.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=c1420154387c7726e7e568021b6d40ce" width="936" height="1046" data-path="assets/image-2-35.png" />
</Frame>

5. Choose “Transform and Incoming Claim” and click “Next”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-36.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=500bb9bc042bf6099f0c892703d623b5" width="936" height="762" data-path="assets/image-2-36.png" />
</Frame>

6. Fill out the following and click “Finish”.

   Incoming claim type: E-Mail Address
   Outgoing claim type: Name ID
   Outgoing name ID format: Email
   Choose “Pass through all claim values”

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-37.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=5d3a3a4cc5faa44dae9f4db5ee62a003" width="936" height="762" data-path="assets/image-2-37.png" />
</Frame>

7. Click “Apply”.

<Frame>
  <img src="https://mintcdn.com/specterops-bp-2731-onprem-architecture/psiLGLOesT9IGqHQ/assets/image-2-38.png?fit=max&auto=format&n=psiLGLOesT9IGqHQ&q=85&s=44ad16bc137a36687f2626e47fdeaf07" width="936" height="1046" data-path="assets/image-2-38.png" />
</Frame>

8. Download the metadata file provided by your ADFS environment. By default, this is hosted at: [https://YOURDOMAIN/federationmetadata/2007-06/federationmetadata.xml](https://YOURDOMAIN/federationmetadata/2007-06/federationmetadata.xml)
9. Follow the instructions at [SAML in BloodHound Enterprise](/manage-bloodhound/auth/saml) to create the SAML provider in BloodHound Enterprise.
