Policy Management API

Onderhouden door: Aether365 Team Doelgroep: Ontwikkelaars Scope: De status van beveiligingsbeleid lezen en beleid op de allowlist verharden

Policy Management rapporteert de status van het beveiligingsrelevante beleid van een verbonden tenant - live gelezen uit Microsoft Graph - samen met een Conditional Access-overzicht, en laat je een beleid op de allowlist in één aanroep op zijn veilige waarde zetten.

Vereisten

Policy Management vereist de Policy Management-rechten en een Microsoft 365-verbinding in AI Pilot-modus (write-consent). Zonder een AI Pilot-verbinding geeft het lees-endpoint { "aiPilotConnected": false } terug. Een beleid omschakelen is een Microsoft Graph-write en vereist write consent.

Beleidsstatus opvragen

Geeft het beleid op de allowlist terug met de huidige waarde en het veilige doel, plus een Conditional Access-overzicht.

GET /tenants/me/policies

Queryparameters

Parameter	Type	Beschrijving
connectionId	string	Optioneel. Te lezen AI Pilot-verbinding; standaard de oudste

Voorbeeldresponse

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

---

Een beleid verharden

Zet een beleid op de allowlist op zijn veilige waarde. De client levert alleen de beleids-key; het Graph-pad en de veilige body komen uit een server-side allowlist, zodat een willekeurige Graph-write nooit mogelijk is via dit endpoint. De wijziging wordt via de AI Pilot-verbinding geschreven en bevestigd door een herlezing.

POST /tenants/me/policies/toggle

Verzoekbody

Veld	Type	Beschrijving
key	string	De te verharden beleids-key op de allowlist
connectionId	string	Optioneel. AI Pilot-verbinding om via te handelen

Voorbeeldverzoek

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

Voorbeeldresponse

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