> For the complete documentation index, see [llms.txt](https://docs.aohwv.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aohwv.dev/core-concepts/how-aohsync-works.md).

# How AOH Sync Works

AOH Sync reads identity data from your connected Source Systems, builds a normalized view of your workforce, and continuously keeps Active Directory and Microsoft Entra ID in sync — without manual intervention.

## The three-stage flow

Every sync follows the same path:

```
Source Systems  ──►  AOH Sync  ──►  Microsoft's provisioning service
 (HR, directory,       (reads,           │   (provisions, updates, deprovisions)
  REST, CSV)           resolves,         │
                       enriches)         ├──►  Microsoft Entra ID  (cloud-only users)
                                         │
                                         └──►  Provisioning agent  ──►  Active Directory  (hybrid users)
                                                                              │  Entra Connect Sync
                                                                              │  or Cloud Sync
                                                                              ▼
                                                                      Microsoft Entra ID
```

**Stage 1 — Ingest.** AOH Sync reads data from each connected Source System via a Connector. Connectors support HR platforms, database-backed systems, API-connected systems, and CSV or SFTP file feeds. Each Connector runs on a configurable schedule (or on demand) and fetches only the records that have changed since the last run.

**Stage 2 — Resolve.** Incoming records from all your sources are merged into a single, normalized Identity for each real person. If the same person exists in both your HR system and a secondary directory, AOH Sync matches them by a configurable join key and combines their attributes into one Identity. When two sources supply the same attribute, a priority order you control decides which value wins.

**Stage 3 — Provision.** AOH Sync compares each Identity's current state against your target, Active Directory or Microsoft Entra ID. It creates, updates, or disables accounts to match — using only the permissions you granted during setup. For hybrid users, AOH Sync writes to Active Directory, and Entra Connect Sync or Cloud Sync carries the change to Entra ID. No data is written to a target that wasn't first reviewed through your attribute mappings.

{% hint style="info" %}
AOH Sync runs entirely inside your subscription. When it provisions accounts, it sends identity data to your own Microsoft tenant. [Where Your Data Lives](https://docs.aohwv.dev/trust-security-and-data-handling/data-residency.md) lists the outbound connections.
{% endhint %}

## Sync vs. provisioning

These two terms describe different directions of data movement:

* **Sync** pulls data *in*. AOH Sync reads from your Source and Target Systems and updates its Identity graph to reflect reality. For Entra ID, this uses delta queries so only changes come over.
* **Provisioning** pushes data *out*. AOH Sync writes the resolved Identity picture to a Target System so that access matches intent.

Both can run on a schedule or be triggered manually.

## What triggers a sync

| Trigger             | When it runs                                                                                                |
| ------------------- | ----------------------------------------------------------------------------------------------------------- |
| Scheduled full sync | On the schedule you configure per Connector                                                                 |
| Incremental sync    | After a full sync, picks up changes since the last run                                                      |
| Delta sync          | Near-real-time; detects only the specific attributes that changed within a record — the most efficient mode |
| Manual trigger      | On demand from the Connectors screen or via the API                                                         |

For a deeper explanation of each sync mode, see [Sync Types](https://docs.aohwv.dev/core-concepts/sync-types.md).

## Long-running work

Full syncs and provisioning runs operate in the background. The interface returns immediately when you trigger one; you can track progress and results from the Connectors sync history or the Status & Logs screen.

## Related

* [Source & Target Systems](https://docs.aohwv.dev/core-concepts/source-and-target-systems.md)
* [Identities, Accounts & Users](https://docs.aohwv.dev/core-concepts/identities-accounts-users.md)
* [Sync Types](https://docs.aohwv.dev/core-concepts/sync-types.md)
* [Provisioning & Deprovisioning Lifecycle](https://docs.aohwv.dev/core-concepts/provisioning-lifecycle.md)
* [What is AOH Sync?](https://docs.aohwv.dev/readme/what-is-aohsync.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.aohwv.dev/core-concepts/how-aohsync-works.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
