Policy Management API

Maintenu par : Aether365 Team Public : Développeurs Périmètre : Lire la posture des politiques de sécurité et durcir les politiques de la liste d'autorisation

Policy Management rapporte l'état des politiques de sécurité d'un tenant connecté - lues en direct depuis Microsoft Graph - aux côtés d'un résumé Conditional Access, et vous permet de fixer une politique de la liste d'autorisation à sa valeur sécurisée en un seul appel.

Prérequis

Policy Management nécessite l'autorisation Policy Management et une connexion Microsoft 365 en mode AI Pilot (write-consent). Sans connexion AI Pilot, l'endpoint de lecture renvoie { "aiPilotConnected": false }. Basculer une politique est une écriture Microsoft Graph et nécessite le write-consent.

Récupérer la posture des politiques

Renvoie les politiques de la liste d'autorisation avec leur valeur actuelle et leur cible sécurisée, ainsi qu'un résumé Conditional Access.

GET /tenants/me/policies

Paramètres de requête

Paramètre	Type	Description
connectionId	string	Optionnel. Connexion AI Pilot à lire ; par défaut la plus ancienne

Exemple de réponse

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

---

Durcir une politique

Fixe une politique de la liste d'autorisation à sa valeur sécurisée. Le client ne fournit que la key de la politique ; le chemin Graph et le corps sécurisé proviennent d'une liste d'autorisation côté serveur, de sorte qu'une écriture Graph arbitraire n'est jamais possible via cet endpoint. Le changement est écrit via la connexion AI Pilot et confirmé par une relecture.

POST /tenants/me/policies/toggle

Corps de la requête

Champ	Type	Description
key	string	La clé de politique de la liste d'autorisation à durcir
connectionId	string	Optionnel. Connexion AI Pilot par laquelle agir

Exemple de requête

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

Exemple de réponse

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