Policy Management API

Hazırlayan: Aether365 Ekibi Hedef Kitle: Geliştiriciler Kapsam: Güvenlik politikası duruşunu oku ve izin listesindeki politikaları sıkılaştır

Policy Management, bağlı bir tenant'ın güvenlikle ilgili politikalarının durumunu (Microsoft Graph'tan canlı olarak okunan) bir Conditional Access özetiyle birlikte raporlar ve izin listesindeki bir politikayı tek bir çağrıyla güvenli değerine ayarlamanıza olanak tanır.

Gereksinimler

Policy Management, Policy Management hakkını ve AI Pilot (yazma onayı) modunda bir Microsoft 365 bağlantısını gerektirir. Bir AI Pilot bağlantısı yoksa okuma endpoint'i { "aiPilotConnected": false } döndürür. Bir politikayı değiştirmek bir Microsoft Graph yazma işlemidir ve yazma onayı gerektirir.

Politika Duruşunu Getir

İzin listesindeki politikaları mevcut değerleri ve güvenli hedefleriyle birlikte, ayrıca bir Conditional Access özetiyle döndürür.

GET /tenants/me/policies

Sorgu Parametreleri

Parametre	Tür	Açıklama
connectionId	string	İsteğe bağlı. Okunacak AI Pilot bağlantısı; varsayılan en eski olandır

Örnek Yanıt

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

---

Bir Politikayı Sıkılaştır

İzin listesindeki bir politikayı güvenli değerine ayarlar. İstemci yalnızca politika key değerini sağlar; Graph yolu ve güvenli gövde sunucu tarafındaki bir izin listesinden gelir, bu yüzden bu endpoint üzerinden keyfi bir Graph yazma işlemi asla mümkün değildir. Değişiklik AI Pilot bağlantısı üzerinden yazılır ve yeniden okuma ile doğrulanır.

POST /tenants/me/policies/toggle

İstek Gövdesi

Alan	Tür	Açıklama
key	string	Sıkılaştırılacak izin listesindeki politika anahtarı
connectionId	string	İsteğe bağlı. İşlemin yapılacağı AI Pilot bağlantısı

Örnek İstek

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

Örnek Yanıt

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