Policy Management API

Maintained by: Ομάδα Aether365 Audience: Προγραμματιστές Scope: Ανάγνωση της κατάστασης πολιτικών ασφαλείας και θωράκιση πολιτικών από λίστα επιτρεπόμενων

Το Policy Management αναφέρει την κατάσταση των πολιτικών ασφαλείας ενός συνδεδεμένου tenant - διαβασμένες ζωντανά από το Microsoft Graph - μαζί με μια σύνοψη Conditional Access, και σας επιτρέπει να θέσετε μια πολιτική από τη λίστα επιτρεπόμενων στην ασφαλή τιμή της με μία κλήση.

Προϋποθέσεις

Το Policy Management απαιτεί το δικαίωμα Policy Management και μια σύνδεση Microsoft 365 σε AI Pilot (write-consent) mode. Χωρίς σύνδεση AI Pilot, το endpoint ανάγνωσης επιστρέφει { "aiPilotConnected": false }. Η εναλλαγή μιας πολιτικής είναι μια εγγραφή στο Microsoft Graph και απαιτεί write consent.

Λήψη Κατάστασης Πολιτικών

Επιστρέφει τις πολιτικές της λίστας επιτρεπόμενων με την τρέχουσα τιμή και τον ασφαλή στόχο τους, καθώς και μια σύνοψη Conditional Access.

GET /tenants/me/policies

Παράμετροι Ερωτήματος

Parameter	Type	Περιγραφή
connectionId	string	Προαιρετικό. Σύνδεση AI Pilot προς ανάγνωση. Προεπιλογή η παλαιότερη

Παράδειγμα Απάντησης

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

---

Θωράκιση Πολιτικής

Θέτει μια πολιτική από τη λίστα επιτρεπόμενων στην ασφαλή τιμή της. Ο client παρέχει μόνο το key της πολιτικής. Η διαδρομή Graph και το ασφαλές σώμα προέρχονται από μια λίστα επιτρεπόμενων στην πλευρά του διακομιστή, ώστε μια αυθαίρετη εγγραφή στο Graph να μην είναι ποτέ δυνατή μέσω αυτού του endpoint. Η αλλαγή γράφεται μέσω της σύνδεσης AI Pilot και επιβεβαιώνεται με νέα ανάγνωση.

POST /tenants/me/policies/toggle

Σώμα Αιτήματος

Field	Type	Περιγραφή
key	string	Το key της πολιτικής από τη λίστα επιτρεπόμενων προς θωράκιση
connectionId	string	Προαιρετικό. Σύνδεση AI Pilot μέσω της οποίας θα ενεργήσετε

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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