Active Directory ügynök API

A feladatsor API, amelyet a helyszíni Active Directory ügynök lekérdez az AD fiókok létrehozásához és letiltásához.

A ClockEU nem tudja közvetlenül elérni egy vállalat saját tartományvezérlőjét — az a tűzfalukon belül van. Ezért az ügynök (egy kis Windows szolgáltatás, amelyet az adott hálózaton belüli gépre telepítenek) ezt a két végpontot kérdezi le kimenő HTTPS-en keresztül, így soha nem kell bejövő portot megnyitni.

Authentication

Hozzon létre egy ügynöktokent a Beállítások → Active Directory menüben, amely csak egyszer jelenik meg — illessze be az ügynök beállítási varázslójába.

POST /api/ad-agent-poll.php

Visszaadja az erre a vállalatra váró összes feladatot (create_user / disable_user), és „elküldve” jelöléssel ellátja őket, hogy egy második lekérdezés az első befejezése előtt ne adja ki ugyanazt a feladatot kétszer.

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

Jelenti, hogy egy feladat sikeres volt vagy sikertelen. A create_user feladatban szereplő egyszeri jelszót a siker pillanatában törli az adatbázisból — ezt később már nem lehet visszaolvasni.

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)

Töltse le a kész ügynököt (forráskód + telepítési utasítások) innen: Szoftver.