Policy Management API

Vedlikeholdt av: Aether365 Team Målgruppe: Utviklere Omfang: Lese sikkerhetspolicyens tilstand og herde policyer på tillatelseslisten

Policy Management rapporterer tilstanden til en tilkoblet leietakers sikkerhetsrelevante policyer - lest direkte fra Microsoft Graph - sammen med et Conditional Access-sammendrag, og lar deg sette en policy på tillatelseslisten til sin sikre verdi i ett enkelt kall.

Krav

Policy Management krever rettigheten Policy Management og en Microsoft 365-tilkobling i AI Pilot-modus (write-consent). Uten en AI Pilot-tilkobling returnerer lese-endepunktet { "aiPilotConnected": false }. Å veksle en policy er en Microsoft Graph-skriving og krever write consent.

Hente policytilstand

Returnerer policyene på tillatelseslisten med gjeldende verdi og sikkert mål, pluss et Conditional Access-sammendrag.

GET /tenants/me/policies

Spørreparametere

Parameter	Type	Beskrivelse
connectionId	string	Valgfritt. AI Pilot-tilkobling å lese; bruker den eldste som standard

Eksempelrespons

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

---

Herde en policy

Setter en policy på tillatelseslisten til sin sikre verdi. Klienten oppgir bare policyens key; Graph-stien og den sikre kroppen kommer fra en tillatelsesliste på serversiden, så en vilkårlig Graph-skriving er aldri mulig gjennom dette endepunktet. Endringen skrives gjennom AI Pilot-tilkoblingen og bekreftes ved en ny lesing.

POST /tenants/me/policies/toggle

Forespørselskropp

Felt	Type	Beskrivelse
key	string	Policynøkkelen på tillatelseslisten som skal herdes
connectionId	string	Valgfritt. AI Pilot-tilkobling å handle gjennom

Eksempelforespørsel

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

Eksempelrespons

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