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

# Troubleshoot Active Directory Sync

> Diagnose and resolve GoGuardian Active Directory sync failures, application errors, and expired token issues.

Use this article to resolve issues with the GoGuardian Active Directory (AD) Sync application not completing, returning errors, or showing an expired token.

## Confirm the AD Sync Application Is Running

The AD Sync application must be running on your Domain Controller for syncs to complete. Open the application on the Domain Controller and select **Sync Now**. Verify that the sync succeeds both in the application and in Org Management at [Data Sources > OU Settings > Active Directory](https://manage.goguardian.com/integrations/ou-settings).

If the sync still fails or returns errors, continue with the steps below.

<img src="https://mintcdn.com/goguardian/0bgzbAKaC0N8qUzX/images/screenshots/troubleshoot-active-directory-sync/step-01.png?fit=max&auto=format&n=0bgzbAKaC0N8qUzX&q=85&s=7e7cb67cb4629dba17ff3d73b637508d" alt="GoGuardian Active Directory Sync Tool used for syncing Active Directory with GoGuardian" width="1094" height="764" data-path="images/screenshots/troubleshoot-active-directory-sync/step-01.png" />

## Allow GoGuardian in Your Firewall or Proxy

If the sync application is not running or returns no errors but fails silently, your firewall or proxy may be blocking GoGuardian traffic. Confirm that GoGuardian IP addresses, ports, and domains are permitted through your firewall or proxy.

<Note>
  The full list of required IP addresses, ports, and domains is available from GoGuardian Support. To request it, contact [support@goguardian.com](mailto:support@goguardian.com).
</Note>

## Verify .NET Framework 4.5

The AD Sync application requires .NET Framework version 4.5 or later on the Domain Controller.

To check the installed version:

1. Select **Start** > **Run**, then enter `regedit` to open Registry Editor.
2. Navigate to: `Computer > HKEY_LOCAL_MACHINE > SOFTWARE > Microsoft > NET Framework Setup > NDP > v4 > Full`.
3. Select **Full** and look for the **Release** value.

If the `Full` key or `Release` value is missing, .NET 4.5 is not installed. Install it by following the [applicable Microsoft guide](https://learn.microsoft.com/en-us/dotnet/framework/install/).

<img src="https://mintcdn.com/goguardian/0bgzbAKaC0N8qUzX/images/screenshots/troubleshoot-active-directory-sync/step-02.png?fit=max&auto=format&n=0bgzbAKaC0N8qUzX&q=85&s=6d94bcac846c2c5fe16d82d22a6f5101" alt="Windows Registry Editor page used to check the .Net version for troubleshooting" width="2030" height="446" data-path="images/screenshots/troubleshoot-active-directory-sync/step-02.png" />

## Install the Latest Version of the AD Sync Application

If the Domain Controller meets the requirements above, install the latest version of the AD Sync application.

1. In Org Management, go to **Data Sources** > **OU Settings** > **Active Directory** > **Download Application**.
2. Save the file to the Domain Controller.
3. Double-click the downloaded file and follow the on-screen instructions to complete the installation.

<img src="https://mintcdn.com/goguardian/0bgzbAKaC0N8qUzX/images/screenshots/troubleshoot-active-directory-sync/step-03.png?fit=max&auto=format&n=0bgzbAKaC0N8qUzX&q=85&s=b7778ed004a99c4b756be50f0c391f03" alt="Active Directory OU Import Tool highlighting the &#x22;Download Application&#x22; button for downloading the Sync Application" width="3104" height="1630" data-path="images/screenshots/troubleshoot-active-directory-sync/step-03.png" />

## Delete the Integration and Generate a New Token

If the application returns "Your token is invalid or has expired!" or continues to behave unexpectedly, delete the integration to generate a fresh token.

1. Go to [manage.goguardian.com](https://manage.goguardian.com/) and select **Data Sources** > **Integrations**.

2. Under **Active Directory**, select **Delete** > **Delete Integration**.

3. Refresh the page and confirm the integration syncs with the new token.

<img src="https://mintcdn.com/goguardian/0bgzbAKaC0N8qUzX/images/screenshots/troubleshoot-active-directory-sync/step-04.png?fit=max&auto=format&n=0bgzbAKaC0N8qUzX&q=85&s=42b6a9635eac97c5f9783629898e2fc9" alt="Active Directory Integrations page error demonstrating a &#x22;integration sync has failed&#x22; message" width="1838" height="1724" data-path="images/screenshots/troubleshoot-active-directory-sync/step-04.png" />

If the AD Sync application still shows unexpected behavior after following all steps above, contact [support@goguardian.com](mailto:support@goguardian.com) with the status messages from the application and your Windows Server version.

## Resources

<CardGroup cols={2}>
  <Card title="Understand Active Directory Sync" href="/products/org-management/active-directory">
    Review how Active Directory OU sync works and when to use it.
  </Card>

  <Card title="Set Up Active Directory Sync" href="/products/org-management/setup-active-directory">
    Re-run the initial setup if you need to reconfigure the integration from scratch.
  </Card>
</CardGroup>
