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

# Microsoft Entra

> Generate workspaces from your directory and organise activity by team.

## Why Connect Entra?

Connecting Microsoft Entra lets Velatir mirror how your organisation is actually structured. Instead of building and maintaining workspaces by hand, Velatir generates them from your directory and keeps them in step as people join, move, and change teams.

The same directory structure also organises activity by team, which powers the department and group breakdowns in [Insights](/insights/overview).

<Note>
  Connecting Entra is optional. You can always create and manage workspaces manually instead. See [Organisations & workspaces](/platform/organizations-and-workspaces).
</Note>

## Generate Workspaces From Your Directory

When you set up your organisation, choose **Generate workspaces with Microsoft Entra** and pick which directory properties define your structure.

<Steps>
  <Step title="Choose the top-level property" icon="building">
    Pick the Entra user property that defines your top-level workspaces, for example **Department**. Velatir creates one workspace per value.
  </Step>

  <Step title="Optionally nest a second level" icon="layout-grid">
    Add a second property, such as **Office** or **Group**, to nest workspaces beneath the first. You can nest up to two levels.
  </Step>

  <Step title="People are placed automatically" icon="users-round">
    Everyone is assigned to the right workspace based on their directory details, and moved automatically when those details change.
  </Step>
</Steps>

## Properties You Can Use

| Property       | Typical use                                               |
| -------------- | --------------------------------------------------------- |
| **Department** | Top-level workspaces such as Engineering, Sales, or Legal |
| **Office**     | Nested workspaces by location                             |
| **Group**      | Nested workspaces by team or function                     |

## Activity by Team in Insights

Once Entra is connected, activity is organised by your directory structure: department, office, and group. You can filter and break usage down by these across the platform, so you see where AI is being adopted without singling out individuals.

<CardGroup cols={2}>
  <Card title="Organised by your structure" icon="building-2">
    Activity is grouped by department, office, and group, so the picture always matches how your organisation is set up.
  </Card>

  <Card title="Team insights" icon="chart-line">
    Insights break usage down by department, office, and group, and show where adoption concentrates.
  </Card>
</CardGroup>

## Mapping Device Activity to Teams

So activity captured on a device lands in the right workspace, Velatir matches it to your directory structure using the organisational context the desktop client attaches to each trace.

***

<CardGroup cols={2}>
  <Card title="Organisations & workspaces" icon="building" href="/platform/organizations-and-workspaces">
    How your account is structured.
  </Card>

  <Card title="Insights overview" icon="chart-line" href="/insights/overview">
    See activity broken down by department, office, and group.
  </Card>
</CardGroup>