Policy Management API

Maintainer: Aether365 Team Destinatari: Sviluppatori Ambito: Leggere lo stato delle policy di sicurezza e rafforzare le policy nella lista consentita

Policy Management riporta lo stato delle policy rilevanti per la sicurezza di un tenant connesso - lette in tempo reale da Microsoft Graph - insieme a un riepilogo Conditional Access, e ti consente di impostare una policy della lista consentita al suo valore sicuro in una sola chiamata.

Requisiti

Policy Management richiede l'abilitazione Policy Management e una connessione Microsoft 365 in modalità AI Pilot (write-consent). Senza una connessione AI Pilot, l'endpoint di lettura restituisce { "aiPilotConnected": false }. Commutare una policy è una scrittura su Microsoft Graph e richiede il write-consent.

Ottenere lo stato delle policy

Restituisce le policy della lista consentita con il loro valore attuale e l'obiettivo sicuro, oltre a un riepilogo Conditional Access.

GET /tenants/me/policies

Parametri di query

Parametro	Tipo	Descrizione
connectionId	string	Opzionale. Connessione AI Pilot da leggere; di default la più vecchia

Esempio di risposta

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

---

Rafforzare una policy

Imposta una policy della lista consentita al suo valore sicuro. Il client fornisce solo la key della policy; il percorso Graph e il corpo sicuro provengono da una lista consentita lato server, così che non sia mai possibile una scrittura Graph arbitraria tramite questo endpoint. La modifica viene scritta tramite la connessione AI Pilot e confermata da una rilettura.

POST /tenants/me/policies/toggle

Corpo della richiesta

Campo	Tipo	Descrizione
key	string	La chiave della policy della lista consentita da rafforzare
connectionId	string	Opzionale. Connessione AI Pilot tramite cui agire

Esempio di richiesta

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

Esempio di risposta

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