Policy Management API

Haldaja: Aether365 tiim Sihtrühm: Arendajad Ulatus: Turvapoliitikate seisu lugemine ja lubatud poliitikate karmistamine

Policy Management raporteerib seotud halduskeskkonna turvaseisukohast oluliste poliitikate olekut - loetuna otse Microsoft Graphist - koos Conditional Access kokkuvõttega ning võimaldab seada lubatud poliitika ühe päringuga selle turvalisele väärtusele.

Nõuded

Policy Management nõuab Policy Management õigust ja AI Pilot (kirjutusnõusoleku) režiimis Microsoft 365 ühendust. AI Pilot ühenduse puudumisel tagastab lugemise lõpp-punkt { "aiPilotConnected": false }. Poliitika ümberlülitamine on Microsoft Graphi kirjutus ja vajab kirjutusnõusolekut.

Poliitikate seisu pärimine

Tagastab lubatud poliitikad koos praeguse väärtuse ja turvalise sihtväärtusega ning lisaks Conditional Access kokkuvõtte.

GET /tenants/me/policies

Pärimisparameetrid

Parameeter	Tüüp	Kirjeldus
connectionId	string	Valikuline. Loetav AI Pilot ühendus; vaikimisi vanim

Näidisvastus

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

---

Poliitika karmistamine

Seab lubatud poliitika selle turvalisele väärtusele. Klient annab ette ainult poliitika võtme key; Graphi tee ja turvaline keha pärinevad serveripoolsest lubatute loendist, nii et meelevaldne Graphi kirjutus pole selle lõpp-punkti kaudu kunagi võimalik. Muudatus kirjutatakse AI Pilot ühenduse kaudu ja kinnitatakse korduslugemisega.

POST /tenants/me/policies/toggle

Päringu keha

Väli	Tüüp	Kirjeldus
key	string	Karmistatava lubatud poliitika võti
connectionId	string	Valikuline. AI Pilot ühendus, mille kaudu tegutseda

Näidispäring

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

Näidisvastus

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