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)

Κατεβάστε τον έτοιμο πράκτορα (πηγαίος κώδικας + οδηγίες εγκατάστασης) από Λογισμικό.