Connector Verification

⏱️10 minutes

After installation, run these verification steps to confirm everything is working.

Automated Verification Script

Download and run our verification script:


# Download script
Invoke-WebRequest -Uri "https://docs.adunlock.me/scripts/Test-ConnectorInstallation.ps1" `
    -OutFile "C:\ADConnector\Test-ConnectorInstallation.ps1"
 
# Run verification
cd C:\ADConnector
.\Test-ConnectorInstallation.ps1

✅Expected Result

All tests should show green checkmarks:


Testing AD Connector Installation...

✅ Config file found
✅ connector.pem found
✅ connector-key.pem found
✅ ca.pem found
✅ Gateway reachable (api.adunlock.me:443)
✅ Domain Controller reachable (dc01.company.local:636)
✅ Service running (ADConnector)
✅ Recent heartbeat in logs

==================================================
All tests passed! Connector is properly installed.
==================================================

Manual Verification Steps

1. Check Service Status


Get-Service ADConnector

✅Expected Result


Status   Name           DisplayName
------   ----           -----------
Running  ADConnector    AD Unlock Connector

2. Check Recent Logs


Get-Content C:\ADConnector\logs\connector.log -Tail 20

✅Expected Result

Look for these messages:


{"level":"info","message":"AD Connector starting"}
{"level":"info","message":"configuration loaded"}
{"level":"info","message":"LDAP connectivity verified"}
{"level":"info","message":"connected to gateway"}
{"level":"info","message":"heartbeat sent"}

3. Verify in Admin Portal

Go to admin.adunlock.me
Navigate to Connectors
Find your connector in the list

✅Expected Result

Status shows Online (green indicator)
“Last Seen” shows recent timestamp (within last minute)

4. Test AD Connectivity

In the Admin Portal:

Go to Settings → Active Directory
Click Test Connection

✅Expected Result


✅ Connection successful
✅ Bind successful
✅ Search successful (found X users in base DN)

Troubleshooting

🔧If Something Goes Wrong

Symptom	Cause	Solution
Service won't start	Missing config file or certificates	Run verification script to identify missing files
Gateway connection failed	Network/firewall issue	Test-NetConnection api.adunlock.me -Port 443
LDAP connectivity failed	DC unreachable or LDAPS not enabled	See AD Connection Errors in troubleshooting
Online in portal but AD test fails	Service account permissions	Re-run permissions script
Heartbeat not appearing	Certificate mismatch	Regenerate certificates in Admin Portal

Verification Checklist

All Verified?

Service is running
Logs show 'connected to gateway'
Logs show 'heartbeat sent' regularly
Portal shows connector as Online
AD Test Connection passes

Next Step

Once all verifications pass:

→ Production Setup

Or if you’re ready to test:

→ First User Test