Policy Management API

Underhålls av: Aether365 Team Målgrupp: Utvecklare Omfattning: Läsa säkerhetspolicyns status och härda policyer på tillåtelselistan

Policy Management rapporterar statusen för en ansluten tenants säkerhetsrelevanta policyer - lästa direkt från Microsoft Graph - tillsammans med en Conditional Access-sammanfattning, och låter dig sätta en policy på tillåtelselistan till dess säkra värde i ett enda anrop.

Krav

Policy Management kräver behörigheten Policy Management och en Microsoft 365-anslutning i AI Pilot-läge (write-consent). Utan en AI Pilot-anslutning returnerar läs-endpointen { "aiPilotConnected": false }. Att växla en policy är en Microsoft Graph-skrivning och kräver write consent.

Hämta policystatus

Returnerar policyerna på tillåtelselistan med deras nuvarande värde och säkra mål, plus en Conditional Access-sammanfattning.

GET /tenants/me/policies

Frågeparametrar

Parameter	Typ	Beskrivning
connectionId	string	Valfritt. AI Pilot-anslutning att läsa; standard är den äldsta

Exempelsvar

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

---

Härda en policy

Sätter en policy på tillåtelselistan till dess säkra värde. Klienten anger endast policyns key; Graph-sökvägen och den säkra kroppen kommer från en tillåtelselista på serversidan, så en godtycklig Graph-skrivning är aldrig möjlig genom denna endpoint. Ändringen skrivs genom AI Pilot-anslutningen och bekräftas av en omläsning.

POST /tenants/me/policies/toggle

Begärandekropp

Fält	Typ	Beskrivning
key	string	Policynyckeln på tillåtelselistan att härda
connectionId	string	Valfritt. AI Pilot-anslutning att agera genom

Exempelbegäran

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

Exempelsvar

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