Policy Management API

Autorius: Aether365 komanda Auditorija: Kūrėjai Apimtis: Skaityti saugumo politikų būklę ir sustiprinti leistinų politikų sąraše esančias politikas

Policy Management praneša prijungtos organizacijos su saugumu susijusių politikų būseną - skaitomą tiesiogiai iš Microsoft Graph - kartu su Conditional Access santrauka ir leidžia vienu iškvietimu nustatyti leistinų sąraše esančią politiką į jos saugią reikšmę.

Reikalavimai

Policy Management reikia Policy Management teisės ir Microsoft 365 ryšio AI Pilot (rašymo sutikimo) režimu. Be AI Pilot ryšio skaitymo galutinis taškas grąžina { "aiPilotConnected": false }. Politikos perjungimas yra Microsoft Graph rašymas ir jam reikia rašymo sutikimo.

Politikų būklės gavimas

Grąžina leistinų sąraše esančias politikas su jų esama reikšme ir saugiu tikslu, kartu su Conditional Access santrauka.

GET /tenants/me/policies

Užklausos parametrai

Parametras	Tipas	Aprašymas
connectionId	string	Neprivaloma. Skaitomas AI Pilot ryšys; numatytasis - seniausias

Atsakymo pavyzdys

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

---

Politikos sustiprinimas

Nustato leistinų sąraše esančią politiką į jos saugią reikšmę. Klientas pateikia tik politikos key; Graph kelias ir saugus turinys ateina iš serverio pusės leistinų sąrašo, todėl per šį galutinį tašką niekada neįmanomas savavališkas Graph rašymas. Pakeitimas įrašomas per AI Pilot ryšį ir patvirtinamas pakartotiniu nuskaitymu.

POST /tenants/me/policies/toggle

Užklausos turinys

Laukas	Tipas	Aprašymas
key	string	Sustiprintinas leistinų sąraše esantis politikos raktas
connectionId	string	Neprivaloma. AI Pilot ryšys, per kurį veikti

Užklausos pavyzdys

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

Atsakymo pavyzdys

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