Policy Management API

Spravuje: Aether365 Team Cílová skupina: Vývojáři Rozsah: Čtení stavu bezpečnostních zásad a zpevnění zásad ze seznamu povolených

Policy Management hlásí stav bezpečnostně relevantních zásad připojeného tenanta, čtený živě z Microsoft Graph, společně se souhrnem Conditional Access, a umožňuje nastavit zásadu ze seznamu povolených na její bezpečnou hodnotu jedním voláním.

Požadavky

Policy Management vyžaduje oprávnění Policy Management a připojení k Microsoft 365 v režimu AI Pilot (write-consent). Bez připojení AI Pilot vrátí čtecí endpoint { "aiPilotConnected": false }. Přepnutí zásady je zápis do Microsoft Graph a vyžaduje write consent.

Načtení stavu zásad

Vrací zásady ze seznamu povolených s jejich aktuální hodnotou a bezpečným cílem, plus souhrn Conditional Access.

GET /tenants/me/policies

Parametry dotazu

Parametr	Typ	Popis
connectionId	string	Volitelné. Připojení AI Pilot ke čtení; výchozí je to nejstarší

Příklad odpovědi

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

---

Zpevnění zásady

Nastaví zásadu ze seznamu povolených na její bezpečnou hodnotu. Klient zadává pouze key zásady; cesta v Graphu i bezpečné tělo pocházejí ze serverového seznamu povolených, takže přes tento endpoint nikdy nelze provést libovolný zápis do Graphu. Změna se zapíše přes připojení AI Pilot a potvrdí se opětovným přečtením.

POST /tenants/me/policies/toggle

Tělo požadavku

Pole	Typ	Popis
key	string	Klíč zásady ze seznamu povolených, kterou zpevnit
connectionId	string	Volitelné. Připojení AI Pilot, přes které se má jednat

Příklad požadavku

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

Příklad odpovědi

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