Policy Management API

Ylläpitäjä: Aether365 Team Kohderyhmä: Kehittäjät Laajuus: Tietoturvakäytäntöjen tilan lukeminen ja sallittujen käytäntöjen koventaminen

Policy Management raportoi yhdistetyn vuokralaisen tietoturvan kannalta olennaisten käytäntöjen tilan - luettuna reaaliaikaisesti Microsoft Graphista - Conditional Access -yhteenvedon ohella, ja antaa sinun asettaa sallitun käytännön sen turvalliseen arvoon yhdellä kutsulla.

Vaatimukset

Policy Management edellyttää Policy Management -käyttöoikeutta sekä Microsoft 365 -yhteyttä AI Pilot (kirjoitussuostumus) -tilassa. Ilman AI Pilot -yhteyttä lukupäätepiste palauttaa { "aiPilotConnected": false }. Käytännön muuttaminen on Microsoft Graph -kirjoitus ja vaatii kirjoitussuostumuksen.

Hae käytäntöjen tila

Palauttaa sallitut käytännöt nykyisine arvoineen ja turvallisine tavoitteineen sekä Conditional Access -yhteenvedon.

GET /tenants/me/policies

Kyselyparametrit

Parametri	Tyyppi	Kuvaus
connectionId	string	Valinnainen. Luettava AI Pilot -yhteys; oletuksena vanhin niistä

Esimerkkivastaus

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

---

Koventa käytäntö

Asettaa sallitun käytännön sen turvalliseen arvoon. Asiakas toimittaa vain käytännön key-arvon; Graph-polku ja turvallinen runko tulevat palvelinpuolen sallittujen listasta, joten mielivaltainen Graph-kirjoitus ei ole koskaan mahdollinen tämän päätepisteen kautta. Muutos kirjoitetaan AI Pilot -yhteyden kautta ja vahvistetaan uudelleenluvulla.

POST /tenants/me/policies/toggle

Pyynnön runko

Kenttä	Tyyppi	Kuvaus
key	string	Kovennettavan sallitun käytännön avain
connectionId	string	Valinnainen. AI Pilot -yhteys, jonka kautta toimitaan

Esimerkkipyyntö

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

Esimerkkivastaus

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