Policy Management API

Uztur: Aether365 Team Auditorija: Izstrādātāji Tvērums: Drošības politiku stāvokļa lasīšana un atļauto politiku nostiprināšana

Policy Management ziņo par pieslēgta nomnieka ar drošību saistīto politiku stāvokli - nolasītu tiešraidē no Microsoft Graph - kopā ar Conditional Access kopsavilkumu, un ļauj vienā izsaukumā iestatīt atļautu politiku tās drošajā vērtībā.

Prasības

Policy Management nepieciešams Policy Management tiesību piešķīrums un Microsoft 365 savienojums AI Pilot (rakstīšanas piekrišanas) režīmā. Bez AI Pilot savienojuma lasīšanas galapunkts atgriež { "aiPilotConnected": false }. Politikas pārslēgšana ir Microsoft Graph rakstīšana, un tai nepieciešama rakstīšanas piekrišana.

Politiku stāvokļa iegūšana

Atgriež atļautās politikas ar to pašreizējo vērtību un drošo mērķi, kā arī Conditional Access kopsavilkumu.

GET /tenants/me/policies

Vaicājuma parametri

Parametrs	Tips	Apraksts
connectionId	string	Neobligāts. AI Pilot savienojums, ko lasīt; pēc noklusējuma vecākais

Atbildes piemērs

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

---

Politikas nostiprināšana

Iestata atļautu politiku tās drošajā vērtībā. Klients norāda tikai politikas key; Graph ceļš un drošais pamatteksts nāk no servera puses atļauto saraksta, tāpēc patvaļīga Graph rakstīšana caur šo galapunktu nekad nav iespējama. Izmaiņa tiek ierakstīta caur AI Pilot savienojumu un apstiprināta ar atkārtotu nolasīšanu.

POST /tenants/me/policies/toggle

Pieprasījuma pamatteksts

Lauks	Tips	Apraksts
key	string	Nostiprināmā atļautā politikas atslēga
connectionId	string	Neobligāts. AI Pilot savienojums, caur kuru darboties

Pieprasījuma piemērs

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

Atbildes piemērs

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