Policy Management API

Vedligeholdes af: Aether365 Team Målgruppe: Udviklere Omfang: Læs sikkerhedspolitikkernes tilstand og hærd whitelistede politikker

Policy Management rapporterer tilstanden af en forbundet tenants sikkerhedsrelevante politikker - læst live fra Microsoft Graph - sammen med et Conditional Access-resumé, og lader dig sætte en whitelistet politik til dens sikre værdi i ét kald.

Krav

Policy Management kræver Policy Management-rettigheden og en Microsoft 365-forbindelse i AI Pilot (write-consent)-tilstand. Uden en AI Pilot-forbindelse returnerer læse-endpointet { "aiPilotConnected": false }. At slå en politik til er en Microsoft Graph-skrivning og kræver write consent.

Hent politiktilstand

Returnerer de whitelistede politikker med deres aktuelle værdi og sikre mål, plus et Conditional Access-resumé.

GET /tenants/me/policies

Forespørgselsparametre

Parameter	Type	Beskrivelse
connectionId	string	Valgfri. AI Pilot-forbindelse, der skal læses; falder tilbage til den ældste

Eksempel på svar

{
  "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ærd en politik

Sætter en whitelistet politik til dens sikre værdi. Klienten angiver kun politikkens key; Graph-stien og det sikre indhold kommer fra en allow-list på serversiden, så en vilkårlig Graph-skrivning er aldrig mulig gennem dette endpoint. Ændringen skrives gennem AI Pilot-forbindelsen og bekræftes ved fornyet læsning.

POST /tenants/me/policies/toggle

Forespørgselsindhold

Felt	Type	Beskrivelse
key	string	Nøglen på den whitelistede politik, der skal hærdes
connectionId	string	Valgfri. AI Pilot-forbindelse, der skal handles igennem

Eksempel på forespørgsel

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

Eksempel på svar

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