Integration Guide

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.

// 00

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.

1

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.

2

Download the Raptoriods ID Agent

Obtain the lightweight MSI installer from your dashboard.

IAMSyncAgentSetup.msi

v1.4.2 • Windows x64 • .NET 8

Download Agent

Transfer this installer file to the Windows Server where the agent will run.

3

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 > Running
4

Verify the Connection

Confirm the agent is communicating with the cloud.

Primary-DC-Agent

v1.4.2

Online

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.

5

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.