API πράκτορα Active Directory
Το API ουράς εργασιών που ερωτά ο τοπικός πράκτορας Active Directory για τη δημιουργία και απενεργοποίηση λογαριασμών AD.
Το ClockEU δεν μπορεί να προσεγγίσει απευθείας τον δικό της ελεγκτή τομέα μιας εταιρείας — βρίσκεται πίσω από το firewall τους. Αντ' αυτού, ο πράκτορας (μια μικρή υπηρεσία Windows εγκατεστημένη σε έναν υπολογιστή εντός αυτού του δικτύου) ερωτά αυτά τα δύο τελικά σημεία μέσω εξερχόμενου HTTPS, ώστε να μην χρειάζεται ποτέ να ανοίξει μια εισερχόμενη θύρα.
Authentication
Δημιουργήστε ένα token πράκτορα από Ρυθμίσεις → Active Directory, το οποίο εμφανίζεται μόνο μία φορά — επικολλήστε το στον οδηγό ρύθμισης του πράκτορα.
POST /api/ad-agent-poll.php
Επιστρέφει όλες τις εργασίες που περιμένουν για αυτή την εταιρεία (create_user / disable_user) και τις επισημαίνει ως «στάλθηκαν», ώστε μια δεύτερη ερώτηση πριν ολοκληρωθεί η πρώτη να μην δώσει την ίδια εργασία δύο φορές.
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"}'
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)
Κατεβάστε τον έτοιμο πράκτορα (πηγαίος κώδικας + οδηγίες εγκατάστασης) από Λογισμικό.