Policy Management API

Karbantartja: Aether365 Team Célközönség: Fejlesztők Hatókör: Biztonsági szabályzatok állapotának olvasása és engedélyezett szabályzatok megerősítése

A Policy Management egy összekapcsolt bérlő biztonság szempontjából lényeges szabályzatainak állapotát jelenti: élőben olvasva a Microsoft Graphból, egy Conditional Access összefoglaló mellett, és lehetővé teszi egy engedélyezett szabályzat biztonságos értékre állítását egyetlen hívással.

Követelmények

A Policy Management Policy Management jogosultságot és egy AI Pilot (write-consent) módban lévő Microsoft 365 kapcsolatot igényel. AI Pilot kapcsolat nélkül az olvasási végpont { "aiPilotConnected": false } választ ad. Egy szabályzat átkapcsolása Microsoft Graph írás, és write consent szükséges hozzá.

Szabályzatállapot lekérése

Visszaadja az engedélyezett szabályzatokat az aktuális értékükkel és biztonságos célértékükkel, valamint egy Conditional Access összefoglalót.

GET /tenants/me/policies

Lekérdezési paraméterek

Paraméter	Típus	Leírás
connectionId	string	Opcionális. Az olvasandó AI Pilot kapcsolat; alapértelmezetten a legrégebbi

Példa válasz

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

---

Szabályzat megerősítése

Egy engedélyezett szabályzatot a biztonságos értékére állít. A kliens csak a szabályzat key értékét adja meg; a Graph útvonal és a biztonságos törzs egy szerveroldali engedélyezési listából származik, így ezen a végponton keresztül soha nem lehetséges tetszőleges Graph írás. A módosítás az AI Pilot kapcsolaton keresztül kerül kiírásra, és újraolvasással kerül megerősítésre.

POST /tenants/me/policies/toggle

Kérés törzse

Mező	Típus	Leírás
key	string	A megerősítendő engedélyezett szabályzat kulcsa
connectionId	string	Opcionális. Az AI Pilot kapcsolat, amelyen keresztül a művelet történik

Példa kérés

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élda válasz

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