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

# Overview

> Connect Microsoft Entra ID to Ravenna to automate user provisioning, group management, MFA resets, and SSO application access provisioning.

Connect Microsoft Entra ID (formerly Azure Active Directory) to automate identity and access management across your organization.

Sync Entra ID users, groups, and SSO applications into Ravenna, then use workflow actions to create users, suspend and restore accounts, manage group memberships, and automate access provisioning.

## What you can do

<CardGroup cols={2}>
  <Card title="User lifecycle automation" icon="user-plus">
    Create new users, suspend accounts during investigations, and restore access when approved
  </Card>

  <Card title="Group membership management" icon="layers">
    List all groups, add users to groups during onboarding, and remove users during offboarding
  </Card>

  <Card title="Password and MFA management" icon="key">
    Reset passwords and clear MFA registrations through helpdesk or self-service workflows
  </Card>

  <Card title="User profile sync" icon="user-circle">
    Sync user profiles and manager relationships for org hierarchy, approval routing, and workflow conditions
  </Card>
</CardGroup>

## User profile data

Ravenna syncs Microsoft Entra ID user profiles for org hierarchy, approval workflows, and workflow interpolation.

### Available fields

| Field            | Description                                                       |
| ---------------- | ----------------------------------------------------------------- |
| `jobTitle`       | Job title                                                         |
| `department`     | Department name                                                   |
| `companyName`    | Company name                                                      |
| `officeLocation` | Office location                                                   |
| `mobilePhone`    | Mobile phone number                                               |
| `businessPhones` | Business phone numbers                                            |
| `city`           | City                                                              |
| `state`          | State or region                                                   |
| `country`        | Country                                                           |
| `managerId`      | Manager's Entra user ID (used to establish manager relationships) |

<Note>
  Ravenna automatically syncs manager relationships from Entra. When a user has a manager assigned, Ravenna matches the manager to a Ravenna user and displays the relationship on user profiles.
</Note>

### Using profile data in workflows

Access these fields through the user's Entra ID metadata when building workflow conditions or actions:

* Route approval requests based on department or company
* Apply different access policies by job title
* Include contact information in notifications
* Build location-based access rules using city, state, or country

<Callout icon="link" color="#6B7280">
  Learn more about [Microsoft Entra ID workflows](/integrations/microsoft-entra/workflows)
</Callout>