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.