Active Directory agendi API
Tööjärjekorra API, mida kohapealne Active Directory agent küsib, et luua ja keelata AD kontosid.
ClockEU ei saa pääseda otse ettevõtte omale domeenikontrollerile — see on tulemüüri taga. Selle asemel agent (väike Windowsi teenus, mis on paigaldatud masinasse selles võrgus) küsib neid kahte lõpp-punkti väljuva HTTPS-i teel, nii et sissetulevat porti ei tule kunagi avada.
Authentication
Looge agendi žetoon menüüst Seaded → Active Directory, näidatakse üks kord — kleepige see agendi seadistusviisardisse.
POST /api/ad-agent-poll.php
Tagastab kõik selle ettevõtte jaoks ootel tööülesanded (create_user / disable_user) ja märgib need olekusse "sent", nii et teine päring enne seda, kui esimene lõpeb, ei annaks sama ülesannet kaks korda.
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
Teatab tööülesande valmis või ebaõnnestunud olekust. Ühekordne parool create_user ülesandes kustutatakse andmebaasist hetkel, kui see õnnestub — hiljem ei saa seda enam tagasi lugeda.
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)
Laadige alla valmis agent (lähtekood + paigaldusjuhised) aadressilt Tarkvara.