Active Directory aģenta API
Uzdevumu rindas API, kuru vaicā uz vietas izvietotais Active Directory aģents, lai izveidotu un atspējotu AD kontus.
ClockEU nevar tieši sasniegt uzņēmuma pašu domēna kontrolleri — tas atrodas aiz ugunsmūra. Tā vietā aģents (neliels Windows pakalpojums, kas instalēts datorā šajā tīklā) vaicā šos divus galapunktus pa izejošu HTTPS, tāpēc nekad nav jāatver ieejošs ports.
Authentication
Izveidojiet aģenta pilnvaru no Iestatījumi → Active Directory, kas parādās vienreiz — ielīmējiet to aģenta iestatīšanas vednī.
POST /api/ad-agent-poll.php
Atgriež visus šim uzņēmumam gaidošos uzdevumus (create_user / disable_user) un atzīmē tos kā "sent", lai otrā vaicāšana pirms pirmās pabeigšanas nedod to pašu uzdevumu divreiz.
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
Ziņo par uzdevumu kā pabeigtu vai neizdevušos. Vienreizējā parole create_user uzdevumā tiek izdzēsta no datubāzes tajā brīdī, kad tas izdodas — vēlāk to vairs nav iespējams nolasīt.
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)
Lejupielādējiet gatavo aģentu (avota kodu + instalācijas instrukcijas) no Programmatūra.