API de Entidades

Aplica-se a: Microsoft Cloud App Security

Importante

Os nomes dos produtos de proteção contra ameaças da Microsoft estão a mudar. Leia mais sobre esta e outras atualizações aqui. Vamos atualizar nomes em produtos e nos documentos num futuro próximo.

Nota

Esta API não está disponível para Office 365 Cloud App Security.

A API de Entidades fornece-lhe informações básicas sobre os utilizadores e contas utilizando as aplicações cloud da sua organização, permitindo-lhe compreender padrões de uso do serviço.

As seguintes listas listam os pedidos suportados:

Filtros

Para obter informações sobre como funcionam os filtros, consulte Filtros.

A tabela a seguir descreve os filtros suportados:

Filtro Tipo Operadores Descrição
tipo string eq, neq Filtrar entidades pelo seu tipo
isAdmin string eq Entidades filtradas que são administradores
entidade entidade pk eq, neq Filtrar entidades com entidades específicas. Se um utilizador for selecionado, também devolverá todas as suas contas. Exemplo: [{ "id": "entity-id", "saas": 11161, "inst": 0 }]
grupos de utilizadores string eq, neq Filtrar entidades pelos seus IDs de grupo associados
aplicação número inteiro eq, neq Entidades filtradas que utilizam serviços com o ID SaaS especificado, por exemplo: 11770
exemplo número inteiro eq, neq Filtrar entidades que utilizam serviços com as Appstances especificadas (ID SaaS e ID de instância), por exemplo: 11770, 1059065
isExternal boolean eq A filiação da entidade. Valores possíveis incluem:

verdadeiro: Externo
falso: Interno
nulo: Sem valor
domínio string eq, neq, isset, isnotset O domínio relacionado da entidade
organização string eq, neq, isset, isnotset Filtrar entidades com a unidade de organização especificada
status string eq, neq Filtrar entidades por estatuto. Valores possíveis incluem:

0: N/A
1: Encenado
2: Ativo
3: Suspenso
4: Eliminado
classificação número inteiro Lt, gt, isset, isnotset Filtrar entidades pela sua Pontuação Prioritária de Investigação

Se tiver algum problema, estamos aqui para ajudar. Para obter assistência ou suporte para o seu problema de produto, abra um bilhete de apoio.