Policy Management API

Maintained by: Zespół Aether365 Audience: Programiści Scope: Odczyt stanu zasad bezpieczeństwa i wzmacnianie zasad z listy dozwolonych

Policy Management raportuje stan zasad istotnych dla bezpieczeństwa połączonego najemcy: odczytywany na żywo z Microsoft Graph, wraz z podsumowaniem Conditional Access, i pozwala jednym wywołaniem ustawić zasadę z listy dozwolonych na jej bezpieczną wartość.

Wymagania

Policy Management wymaga uprawnienia Policy Management oraz połączenia Microsoft 365 w trybie AI Pilot (write-consent). Bez połączenia AI Pilot punkt końcowy odczytu zwraca { "aiPilotConnected": false }. Przełączenie zasady to zapis Microsoft Graph i wymaga zgody na zapis.

Pobierz stan zasad

Zwraca zasady z listy dozwolonych wraz z ich bieżącą wartością i bezpiecznym celem, a także podsumowanie Conditional Access.

GET /tenants/me/policies

Parametry zapytania

Parametr	Typ	Opis
connectionId	string	Opcjonalny. Połączenie AI Pilot do odczytu; domyślnie najstarsze

Przykładowa odpowiedź

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

---

Wzmocnij zasadę

Ustawia zasadę z listy dozwolonych na jej bezpieczną wartość. Klient podaje wyłącznie key zasady; ścieżka Graph i bezpieczna treść pochodzą z listy dozwolonych po stronie serwera, więc dowolny zapis Graph nigdy nie jest możliwy przez ten punkt końcowy. Zmiana jest zapisywana przez połączenie AI Pilot i potwierdzana ponownym odczytem.

POST /tenants/me/policies/toggle

Treść żądania

Pole	Typ	Opis
key	string	Klucz zasady z listy dozwolonych do wzmocnienia
connectionId	string	Opcjonalny. Połączenie AI Pilot, przez które działać

Przykładowe żądanie

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

Przykładowa odpowiedź

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