Configure and Maintain Cloud Sync Agents and Policies
Introduction to Microsoft Entra Cloud Sync
Microsoft Entra Cloud Sync is a lightweight agent-based service used to provision and synchronize hybrid identities from on-premises environments to the cloud. It acts as a modern, cloud-managed alternative to traditional synchronization tools. This service simplifies administration because configuration policies live in the cloud, which reduces the local footprint and overhead on your on-premises servers.
Installing and Registering Cloud Sync Agents
To establish the connection between environments, you must install the lightweight provisioning agent on a domain-joined server in your local network. The installation process requires you to download the agent from the Azure portal, run the setup wizard, and register the agent with your tenant. Once registered, the agent establishes an outbound connection to Microsoft Entra ID, meaning you do not need to open inbound ports on your local firewall. This outbound-only design creates a secure communication boundary that protects your internal network while allowing continuous data flow.
Defining Synchronization Scope
After the agent is active, you define which objects migrate to the cloud by configuring scoping filters within the portal. You can restrict synchronization by targeting specific Organizational Units (OUs) or by applying custom attribute filtering to select specific users or groups. Choosing the right scope prevents unnecessary objects from cluttering your cloud directory and reduces sync processing times. If an object falls out of the scoped OUs or fails the attribute criteria, the system automatically stops syncing it, ensuring that only authorized identities exist in the cloud.
Scheduling and Processing Sync Cycles
Cloud Sync runs on a recurring schedule to ensure that local changes, such as password updates or new user creations, quickly reflect in the cloud. Unlike traditional sync tools that run heavy local cycles, Cloud Sync uses a highly frequent, cloud-orchestrated polling mechanism. This architecture offloads the scheduling engine to Azure, which pulls changes from the on-premises directory at regular intervals. Administrators can monitor these cycles to confirm that updates propagate smoothly without causing performance degradation on local domain controllers.
To keep the synchronization pipeline running smoothly, administrators must actively monitor system health. The Microsoft Entra Connect Health portal provides centralized visibility into the operational state of your agents and active sync processes. This portal displays real-time health alerts, performance metrics, and latency reports to help you detect synchronization delays early. By reviewing these metrics, you can identify resource bottlenecks on your host servers before they impact user access.
Troubleshooting Connectivity and Replication
When synchronization fails, troubleshooting requires a structured check of the communication path and agent logs. If an agent loses its connection, check outbound network access on ports 80 and 443, which are required for the agent to reach Azure endpoints. Next, review the local Windows Event Logs and the provisioning logs in Microsoft Entra ID to pinpoint why specific objects failed to sync. Resolving these identity mismatches or connectivity blocks promptly restores the seamless flow of data and ensures consistent access for hybrid users.