Active Directory agento API

Užduočių eilės API, kurio vietinis Active Directory agentas klausia, kad sukurtų ir išjungtų AD paskyras.

ClockEU negali tiesiogiai pasiekti įmonės pačios domeno valdiklio — jis yra už užkardos. Vietoj to agentas (mažas Windows paslauga, įdiegta kompiuteryje šiame tinkle) periodiškai klausia šių dviejų galinių taškų per išeinantį HTTPS, todėl niekada nereikia atidaryti įeinančio prievado.

Authentication

Sugeneruokite agento žetoną skiltyje Nustatymai → Active Directory, jis parodomas vieną kartą — įklijuokite jį į agento sąrankos vedlį.

POST /api/ad-agent-poll.php

Grąžina visas šiai įmonei laukiančias užduotis (create_user / disable_user) ir pažymi jas kaip "sent", kad antra užklausa prieš pirmajai pasibaigiant neduotų tos pačios užduoties dukart.

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

Praneša apie užduotį kaip atliktą arba nepavykusią. Vienkartinis slaptažodis create_user užduotyje ištrinamas iš duomenų bazės tą akimirką, kai tai pavyksta — jo po to atgal perskaityti negalima.

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)

Atsisiųskite parengtą agentą (pirminį kodą + diegimo instrukcijas) iš Programinė įranga.