Policy Management API

Поддържа се от: Aether365 Team Аудитория: Разработчици Обхват: Четене на състоянието на политиките за сигурност и подсилване на политики от списъка с разрешени

Policy Management докладва състоянието на политиките, релевантни за сигурността, на свързан наемател: четено на живо от Microsoft Graph, заедно с обобщение на Conditional Access, и позволява задаването на политика от списъка с разрешени на нейната сигурна стойност с едно извикване.

Изисквания

Policy Management изисква правото Policy Management и връзка с Microsoft 365 в режим AI Pilot (write-consent). Без връзка AI Pilot крайната точка за четене връща { "aiPilotConnected": false }. Превключването на политика е запис в Microsoft Graph и изисква write consent.

Получаване на състоянието на политиките

Връща политиките от списъка с разрешени с текущата им стойност и сигурната цел, плюс обобщение на Conditional Access.

GET /tenants/me/policies

Параметри на заявката

Параметър	Тип	Описание
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 }
    ]
  }
}

---

Подсилване на политика

Задава политика от списъка с разрешени на нейната сигурна стойност. Клиентът предоставя само key на политиката; пътят в Graph и сигурното тяло идват от списък с разрешени от страна на сървъра, така че произволен запис в Graph никога не е възможен през тази крайна точка. Промяната се записва чрез връзката AI Pilot и се потвърждава чрез повторно четене.

POST /tenants/me/policies/toggle

Тяло на заявката

Поле	Тип	Описание
key	string	Ключът на политиката от списъка с разрешени за подсилване
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 }
}