Active Directory-agent-API
De taakwachtrij-API die de on-premises Active Directory-agent raadpleegt om AD-accounts aan te maken en uit te schakelen.
ClockEU kan de eigen domeincontroller van een bedrijf niet direct bereiken — die staat achter hun firewall. In plaats daarvan raadpleegt de agent (een kleine Windows-service die op een machine binnen dat netwerk is geïnstalleerd) periodiek deze twee endpoints via uitgaande HTTPS, zodat er nooit een inkomende poort hoeft te worden geopend.
Authentication
Genereer een agenttoken vanuit Instellingen → Active Directory, deze wordt eenmalig getoond — plak hem in de installatiewizard van de agent.
POST /api/ad-agent-poll.php
Geeft alle taken terug die voor dit bedrijf wachten (create_user / disable_user) en markeert ze als "verzonden", zodat een tweede aanroep vóór afronding van de eerste niet dezelfde taak nogmaals uitgeeft.
curl -X POST https://acme.clockeu.eu/api/ad-agent-poll.php \
-H "Authorization: Bearer <agent_token>" \
-H "Content-Type: application/json" \
-d '{"agent_name": "DC01"}'
{
"ok": true,
"jobs": [
{
"job_id": 42,
"type": "create_user",
"payload": {
"samAccountName": "j.smith",
"upn": "j.smith@corp.local",
"givenName": "Jane",
"surname": "Smith",
"displayName": "Jane Smith",
"email": "j.smith@corp.local",
"password": "T3mp-Pass!92x",
"ou": null
}
}
]
}
POST /api/ad-agent-result.php
Rapporteert dat een taak is voltooid of mislukt. Het eenmalige wachtwoord in een create_user-taak wordt uit de database gewist zodra dit slaagt — het kan daarna niet meer worden opgevraagd.
curl -X POST https://acme.clockeu.eu/api/ad-agent-result.php \
-H "Authorization: Bearer <agent_token>" \
-H "Content-Type: application/json" \
-d '{"job_id": 42, "ok": true, "account": "j.smith"}'
Example: a minimal agent loop
import time, requests
BASE = "https://acme.clockeu.eu"
HEADERS = {"Authorization": "Bearer <agent_token>"}
while True:
r = requests.post(f"{BASE}/api/ad-agent-poll.php", headers=HEADERS,
json={"agent_name": "DC01"}, timeout=30)
for job in r.json().get("jobs", []):
try:
account = create_or_disable_in_ad(job) # your code: LDAP / PowerShell
result = {"job_id": job["job_id"], "ok": True, "account": account}
except Exception as e:
result = {"job_id": job["job_id"], "ok": False, "error": str(e)}
requests.post(f"{BASE}/api/ad-agent-result.php", headers=HEADERS, json=result, timeout=30)
time.sleep(60)
Download de kant-en-klare agent (broncode + installatie-instructies) via Software.