Policy Management API

Întreținut de: Aether365 Team Public țintă: Dezvoltatori Domeniu: Citirea stării politicilor de securitate și consolidarea politicilor de pe lista permisă

Policy Management raportează starea politicilor relevante pentru securitate ale unui chiriaș conectat: citită în timp real din Microsoft Graph, alături de un rezumat Conditional Access, și permite setarea unei politici de pe lista permisă la valoarea sa sigură printr-un singur apel.

Cerințe

Policy Management necesită dreptul Policy Management și o conexiune Microsoft 365 în modul AI Pilot (write-consent). Fără o conexiune AI Pilot, punctul final de citire returnează { "aiPilotConnected": false }. Comutarea unei politici este o scriere în Microsoft Graph și necesită write consent.

Obținerea stării politicilor

Returnează politicile de pe lista permisă cu valoarea lor curentă și ținta sigură, plus un rezumat Conditional Access.

GET /tenants/me/policies

Parametri de interogare

Parametru	Tip	Descriere
connectionId	string	Opțional. Conexiunea AI Pilot de citit; implicit cea mai veche

Exemplu de răspuns

{
  "success": true,
  "data": {
    "aiPilotConnected": true,
    "msTenantId": "00000000-0000-0000-0000-000000000000",
    "policies": [
      {
        "key": "security_defaults",
        "title": "Security Defaults enabled",
        "current": false,
        "secure": true,
        "compliant": false
      },
      { "key": "conditional_access_summary", "policies": 4, "enabled": 3 }
    ]
  }
}

---

Consolidarea unei politici

Setează o politică de pe lista permisă la valoarea sa sigură. Clientul furnizează doar key-ul politicii; calea Graph și corpul sigur provin dintr-o listă permisă pe partea de server, astfel încât o scriere Graph arbitrară nu este niciodată posibilă prin acest punct final. Modificarea este scrisă prin conexiunea AI Pilot și confirmată printr-o recitire.

POST /tenants/me/policies/toggle

Corpul cererii

Câmp	Tip	Descriere
key	string	Cheia politicii de pe lista permisă de consolidat
connectionId	string	Opțional. Conexiunea AI Pilot prin care se acționează

Exemplu de cerere

curl -X POST https://api.aether365.io/tenants/me/policies/toggle \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "key": "security_defaults" }'

Exemplu de răspuns

{
  "success": true,
  "data": { "key": "security_defaults", "applied": true, "verified": true, "needsReconsent": false }
}