API de l'agent Active Directory

L'API de file d'attente de tâches que l'agent Active Directory sur site interroge pour créer et désactiver des comptes AD.

ClockEU ne peut pas atteindre directement le contrôleur de domaine propre d'une entreprise — il se trouve derrière son pare-feu. À la place, l'agent (un petit service Windows installé sur une machine à l'intérieur de ce réseau) interroge ces deux points d'accès via HTTPS sortant, de sorte qu'aucun port entrant n'a jamais besoin d'être ouvert.

Authentication

Générez un jeton d'agent depuis Paramètres → Active Directory, affiché une seule fois — collez-le dans l'assistant de configuration de l'agent.

POST /api/ad-agent-poll.php

Renvoie les tâches en attente pour cette entreprise (create_user / disable_user) et les marque « sent » afin qu'une deuxième interrogation avant que celle-ci ne se termine ne distribue pas la même tâche deux fois.

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

Signale qu'une tâche est terminée ou a échoué. Le mot de passe à usage unique d'une tâche create_user est effacé de la base de données dès que cette opération réussit ; il ne peut plus être relu par la suite.

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)

Téléchargez l'agent prêt à l'emploi (code source + instructions d'installation) depuis Logiciels.