API de Gestão de Políticas

Mantido por: Aether365 Team Público-alvo: Programadores Âmbito: Ler o estado das políticas de segurança e reforçar políticas em lista de permissões

A Gestão de Políticas reporta o estado das políticas relevantes para a segurança de um tenant ligado - lidas em tempo real do Microsoft Graph - juntamente com um resumo de Conditional Access, e permite-lhe definir uma política em lista de permissões para o seu valor seguro numa única chamada.

Requisitos

A Gestão de Políticas requer o direito de utilização Policy Management e uma ligação Microsoft 365 em modo AI Pilot (write-consent). Sem uma ligação AI Pilot, o endpoint de leitura devolve { "aiPilotConnected": false }. Alternar uma política é uma escrita no Microsoft Graph e requer write consent.

Obter o Estado das Políticas

Devolve as políticas em lista de permissões com o seu valor atual e alvo seguro, mais um resumo de Conditional Access.

GET /tenants/me/policies

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
connectionId	string	Opcional. Ligação AI Pilot a ler; por omissão, usa a mais antiga

Exemplo de Resposta

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

---

Reforçar uma Política

Define uma política em lista de permissões para o seu valor seguro. O cliente fornece apenas a key da política; o caminho do Graph e o corpo seguro vêm de uma lista de permissões do lado do servidor, por isso uma escrita arbitrária no Graph nunca é possível através deste endpoint. A alteração é escrita através da ligação do AI Pilot e confirmada por uma releitura.

POST /tenants/me/policies/toggle

Corpo do Pedido

Campo	Tipo	Descrição
key	string	A chave da política em lista de permissões a reforçar
connectionId	string	Opcional. Ligação AI Pilot através da qual atuar

Exemplo de Pedido

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

Exemplo de Resposta

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