# Configure Directory Sync

Directory Sync allows you to connect **Google Workspace** or **Microsoft 365** so WatchDog Security can identify users from your directory and help streamline onboarding. This is useful when you want to reduce manual user creation and manage onboarding from a connected identity provider.

<div style="
  background: rgba(128,128,128,0.08);
  border: 2px solid rgba(128,128,128,0.25);
  border-radius: 10px;
  padding: 20px 20px 0px 20px;
">
  <div style="font-weight:700; margin-bottom:20px;">Who can use this feature?</div>

  <table style="border-collapse:collapse;">
    <tr>
      <td style="vertical-align:top; padding:0 8px 10px 0;">
        <Icon icon="material-filled-person" color="#d760f9"/>
      </td>
      <td style="vertical-align:top; padding:0 0 10px 0;">
        All <span style="color:#d760f9; font-weight:600;">Account Owners</span> and <span style="color:#d760f9; font-weight:600;">Security Admins</span>
      </td>
    </tr>

    <tr>
      <td style="vertical-align:top; padding:0 8px 0 0;">
        <Icon icon="material-filled-flag" color="#d760f9"/>
      </td>
      <td style="vertical-align:top; padding:0;">
        Available on the <span style="color:#d760f9; font-weight:600;">Free</span>, <span style="color:#d760f9; font-weight:600;">Core</span> and <span style="color:#d760f9; font-weight:600;">Business</span> plans
      </td>
    </tr>
  </table>
</div>

## Sync Directories

<Steps>
<Step title="Sign in to WatchDog Security">
  Sign in to the [**WatchDog Security Platform**](app.watchdogsecurity.io).
</Step>

<Step title="Open User Management">
  Navigate to **Management** > **Users** from the main navigation menu.
</Step>

<Step title="Click Add User">
  Click the **Add User** button in the top right.
</Step>

<Step title="Open Directory Sync">
  Click **Directory Sync** from the **Add Users** panel.
</Step>

<Step title="Select Provider">
  Choose **Google Workspace** or **Microsoft 365**.
    <CardGroup cols={3}>
    <Card title="Microsoft 365" href="/connecting-microsoft-365-to-watchdog-security-2028379m0" icon="ph-bold-microsoft-outlook-logo">
    </Card>
    <Card title="Google Workspace" href="/connecting-google-workspace-to-watchdog-security-2026548m0" icon="ph-bold-google-logo">
    </Card>
    </CardGroup>
</Step>

<Step title="Authenticate Account">
  Sign in with a privileged account to start the sync process.
</Step>

<Step title="Review Users">
  Review the users identified by the sync flow.
</Step>

<Step title="Apply Onboarding">
  Set the default role and click **Onboard Users**.
</Step>
</Steps>

## What Happens Next

<TipInfo>Users from your connected directory are identified for onboarding.</TipInfo>
<TipInfo>Selected users are added to your tenant with the chosen default role.</TipInfo>
<TipInfo>New users may receive an invitation email based on your onboarding flow.</TipInfo>

## Troubleshooting

<AccordionGroup>

<Accordion title="Directory Sync Is Not Available" defaultOpen>
If sync cannot be started:

- Ensure **Google Workspace** or **Microsoft 365** is connected in the **Integrations Page**
- Confirm the integration was authorized successfully
- Retry the flow using a privileged directory account
</Accordion>

<Accordion title="No Users Found">
If no users are available for onboarding:

- New users may take up to **24 hours** to appear
- Confirm the users exist in your connected directory
- Check **Directory Sync settings** to see whether they were excluded
</Accordion>

<Accordion title="Users Are Excluded From Sync">
If expected users do not appear:

- Review the **Excluded Users** list in **Directory Sync settings**
- Remove excluded users if they should be available for onboarding
- Run the review again after updating the settings
</Accordion>

</AccordionGroup>