Active Directory (On-Premise) Integration Guide
Connecting your on-premise Active Directory to Raptoriods ID enables secure, automated user provisioning and group management without opening inbound firewall ports.
Prerequisites
Server Access
Administrative access to a Windows Server (2016+) joined to your AD domain.
Network Requirements
Outbound internet access over Port 443 (HTTPS/WSS). No inbound rules required.
Service Account
Dedicated AD account with permissions to read/modify users and groups in target OUs.
Generate Agent Credentials in the Cloud
Register a new agent within your Raptoriods ID dashboard to create its secure 'birth certificate'.
- Log in to the **Raptoriods ID Admin Dashboard**.
- Navigate to **Integrations > Active Directory (On-Prem)**.
- Click **Generate New Agent** and give it a name (e.g., `Primary-DC-Agent`).
- Click **Generate Credentials**.
Save your Credentials
Copy and save the **Agent ID** and **API Key** immediately. For security purposes, the platform only stores a hashed version of the API Key and won't show it again.
Download the Raptoriods ID Agent
Obtain the lightweight MSI installer from your dashboard.
IAMSyncAgentSetup.msi
v1.4.2 • Windows x64 • .NET 8
Transfer this installer file to the Windows Server where the agent will run.
Install and Configure the Agent
Install the .NET 8-based background Windows Service on your local server.
- Double-click the `IAMSyncAgentSetup.msi` file to launch the wizard.
- When prompted, paste your **Agent ID** and **API Key**.
- Complete the installation. The installer will automatically start the **IAMSyncAgent** Windows Service.
services.msc > IAMSyncAgent > RunningVerify the Connection
Confirm the agent is communicating with the cloud.
Primary-DC-Agent
v1.4.2
In your dashboard under **Real-time Monitoring**, you should see the status change to **ONLINE**, accompanied by a live heartbeat pulse indicating an active WebSocket connection.
Post-Installation & Mapping
The agent is now ready to receive commands.
Attribute Mapping
The agent handles automated mapping of Raptoriods ID fields to your Active Directory schema (e.g., `givenName`, `sAMAccountName`).
Automated Placement
Joiner/Mover events automatically route users to correct OUs and assign security groups via the `memberOf` attribute.
Troubleshooting
Status remains 'OFFLINE'
Check your Windows Server's outbound firewall rules to ensure Port 443 is open. Verify that the IAMSyncAgent service is currently 'Running' in the Windows services.msc console.
Authentication Errors
If logs show authentication failures, delete the agent from the dashboard, generate a new one, and reinstall using the fresh credentials.