Policy Management API

Vzdržuje: ekipa Aether365 Občinstvo: razvijalci Obseg: branje stanja varnostnih pravilnikov in utrjevanje pravilnikov na seznamu dovoljenih

Policy Management poroča o stanju varnostno pomembnih pravilnikov povezanega najemnika - prebranih v živo iz Microsoft Graph - skupaj s povzetkom Conditional Access in omogoča, da pravilnik s seznama dovoljenih z enim klicem nastavite na njegovo varno vrednost.

Zahteve

Policy Management zahteva pravico Policy Management in povezavo Microsoft 365 v načinu AI Pilot (write-consent). Brez povezave AI Pilot končna točka za branje vrne { "aiPilotConnected": false }. Preklop pravilnika je pisanje v Microsoft Graph in zahteva soglasje za pisanje.

Pridobitev stanja pravilnikov

Vrne pravilnike s seznama dovoljenih z njihovo trenutno vrednostjo in varnim ciljem, skupaj s povzetkom Conditional Access.

GET /tenants/me/policies

Poizvedbeni parametri

Parameter	Tip	Opis
connectionId	string	Neobvezno. Povezava AI Pilot za branje; privzeto najstarejša

Primer odgovora

{
  "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 }
    ]
  }
}

---

Utrjevanje pravilnika

Nastavi pravilnik s seznama dovoljenih na njegovo varno vrednost. Odjemalec posreduje le key pravilnika; pot v Graph in varno telo izhajata iz seznama dovoljenih na strani strežnika, zato poljubno pisanje v Graph prek te končne točke nikoli ni mogoče. Sprememba se zapiše prek povezave AI Pilot in potrdi s ponovnim branjem.

POST /tenants/me/policies/toggle

Telo zahteve

Polje	Tip	Opis
key	string	Ključ pravilnika s seznama dovoljenih za utrjevanje
connectionId	string	Neobvezno. Povezava AI Pilot, prek katere se ukrepa

Primer zahteve

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" }'

Primer odgovora

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