Policy Management API

Spravuje: Aether365 Team Cieľová skupina: Vývojári Rozsah: Čítanie stavu bezpečnostných politík a spevnenie politík na zozname povolených

Policy Management hlási stav bezpečnostne relevantných politík pripojeného tenanta: čítaný naživo z Microsoft Graph, spolu so súhrnom Conditional Access, a umožňuje nastaviť politiku zo zoznamu povolených na jej bezpečnú hodnotu jedným volaním.

Požiadavky

Policy Management vyžaduje oprávnenie Policy Management a pripojenie Microsoft 365 v režime AI Pilot (write-consent). Bez pripojenia AI Pilot koncový bod na čítanie vráti { "aiPilotConnected": false }. Prepnutie politiky je zápis do Microsoft Graph a vyžaduje write consent.

Získanie stavu politík

Vráti politiky zo zoznamu povolených s ich aktuálnou hodnotou a bezpečným cieľom, plus súhrn Conditional Access.

GET /tenants/me/policies

Parametre dotazu

Parameter	Typ	Popis
connectionId	string	Voliteľné. Pripojenie AI Pilot na čítanie; predvolene najstaršie

Príklad odpovede

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

---

Spevnenie politiky

Nastaví politiku zo zoznamu povolených na jej bezpečnú hodnotu. Klient dodáva iba key politiky; cesta Graph a bezpečné telo pochádzajú zo zoznamu povolených na strane servera, takže cez tento koncový bod nikdy nie je možný ľubovoľný zápis do Graph. Zmena sa zapíše cez pripojenie AI Pilot a potvrdí opätovným prečítaním.

POST /tenants/me/policies/toggle

Telo požiadavky

Pole	Typ	Popis
key	string	Kľúč politiky zo zoznamu povolených na spevnenie
connectionId	string	Voliteľné. Pripojenie AI Pilot, cez ktoré sa má konať

Príklad požiadavky

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

Príklad odpovede

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