API агента Active Directory
API черги завдань, який опитує локальний агент Active Directory для створення й вимкнення облікових записів AD.
ClockEU не може напряму звернутися до власного контролера домену компанії — він за їхнім файрволом. Натомість агент (невелика служба Windows, встановлена на машині всередині цієї мережі) опитує ці два ендпоінти через вихідний HTTPS, тож жоден вхідний порт відкривати не потрібно.
Автентифікація
Згенеруйте токен агента в Налаштування → Active Directory — він показується один раз, вставте його в майстер налаштування агента.
POST /api/ad-agent-poll.php
Повертає завдання, що очікують цю компанію (create_user / disable_user), і позначає їх «sent», щоб повторний опит до завершення цього не видав те саме завдання двічі.
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
Повідомляє про виконання або помилку завдання. Одноразовий пароль у завданні create_user видаляється з бази даних одразу після успішного підтвердження — прочитати його повторно вже неможливо.
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"}'
Приклад: мінімальний цикл агента
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)
Завантажте готового агента (вихідний код + інструкції зі встановлення) на сторінці Застосунки.