Policy Management API

Супровiд: Aether365 Team Аудиторiя: Розробники Сфера: Зчитування стану полiтик безпеки та посилення полiтик зi списку дозволених

Policy Management повiдомляє про стан полiтик безпеки пiдключеного tenant'а - зчитаних наживо з Microsoft Graph - разом зi зведенням Conditional Access i дозволяє встановити полiтику зi списку дозволених у її безпечне значення одним викликом.

Вимоги

Policy Management потребує права Policy Management i пiдключення Microsoft 365 у режимi AI Pilot (write-consent). Без пiдключення AI Pilot endpoint читання повертає { "aiPilotConnected": false }. Перемикання полiтики є записом у Microsoft Graph i потребує write consent.

Отримання стану полiтик

Повертає полiтики зi списку дозволених з їхнiм поточним значенням i безпечною цiллю, а також зведення Conditional Access.

GET /tenants/me/policies

Параметри запиту

Параметр	Тип	Опис
connectionId	string	Необов'язковий. Пiдключення AI Pilot для зчитування; за замовчуванням найстарiше

Приклад вiдповiдi

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

---

Посилення полiтики

Встановлює полiтику зi списку дозволених у її безпечне значення. Клiєнт надає лише key полiтики; шлях Graph i безпечне тiло беруться зi списку дозволених на сторонi сервера, тож довiльний запис у Graph через цей endpoint неможливий. Змiна записується через пiдключення AI Pilot i пiдтверджується повторним зчитуванням.

POST /tenants/me/policies/toggle

Тiло запиту

Поле	Тип	Опис
key	string	Ключ полiтики зi списку дозволених для посилення
connectionId	string	Необов'язковий. Пiдключення AI Pilot, через яке дiяти

Приклад запиту

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

Приклад вiдповiдi

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