> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Entra

> Connect Microsoft Entra to Langdock to search your organization's user directory from your conversations

## Overview

Microsoft Entra (formerly Azure Active Directory) is Microsoft's identity and access management service. Once connected, you can use Langdock to search users in your organization's directory directly from your conversations.

<Info>
  **Authentication:** OAuth
  **Category:** Identity & Access Management
  **Availability:** All workspace plans
</Info>

## Prerequisites

* A Microsoft 365 or Azure AD account
* Admin consent may be required to allow directory read access for your organization — check with your Microsoft 365 admin if the authorization fails

## Setup

<Steps>
  <Step title="Navigate to Integrations in Langdock">
    Go to [Integrations](https://app.langdock.com/integrations) and find **Microsoft Entra** in the list.
  </Step>

  <Step title="Connect via OAuth">
    Click **Connect** to start the OAuth flow. You will be redirected to Microsoft to authorize Langdock.
  </Step>

  <Step title="Grant permissions">
    Sign in with your Microsoft account and approve the requested permissions. If your organization requires admin consent, a Microsoft 365 admin will need to approve the application first.
  </Step>

  <Step title="Start using Microsoft Entra in Langdock">
    Tag the integration with `@` in any agent to search your organization's directory.
  </Step>
</Steps>

<Info>
  **Admin consent:** If you see an error saying admin approval is required, your Microsoft 365 admin needs to grant consent for Langdock to access directory data. They can do this in **Azure Portal → Enterprise Applications → \[Langdock] → Permissions → Grant admin consent**.
</Info>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="User Lookup" icon="user-magnifying-glass">
    Find employees by name, email, or partial match across your organization's directory
  </Card>

  <Card title="Contact Discovery" icon="address-book">
    Quickly look up contact details, job titles, and department information for colleagues
  </Card>
</CardGroup>

## Troubleshooting

| Issue                      | Solution                                                                                |
| -------------------------- | --------------------------------------------------------------------------------------- |
| **Admin consent required** | Ask your Microsoft 365 admin to grant consent in Azure Portal → Enterprise Applications |
| **Authorization failed**   | Ensure you're signing in with a Microsoft account that belongs to the correct tenant    |
| **No results returned**    | Try a broader search term; guest users are excluded by default                          |