tipo de recurso hostReputation
Espaço de nomes: microsoft.graph.security
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Observação
A Microsoft Graph API for Microsoft Defender Threat Intelligence requer uma licença ativa do Portal de Informações sobre Ameaças do Defender e uma licença de suplemento da API para o inquilino.
Representa a reputação de um anfitrião com base numa série de regras. Esta classificação ajuda os utilizadores a compreender rapidamente quaisquer ligações detetadas a infraestruturas maliciosas ou suspeitas ao validar a reputação de uma entidade conhecida ou desconhecida. A plataforma fornece informações rápidas sobre a atividade destas entidades (como carimbos de data/hora vistos pela primeira vez ou detalhes do sistema autónomo ) e uma lista de regras que afetam a classificação de reputação quando aplicável.
Os dados de reputação são importantes para compreender a fiabilidade de uma superfície de ataque e também são úteis para avaliar nomes de anfitrião ou endereços IP desconhecidos que aparecem nas investigações. Estas classificações detetam qualquer atividade maliciosa ou suspeita anterior que afetou a entidade ou outros indicadores conhecidos de comprometimento a considerar.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Obter reputação de anfitrião | microsoft.graph.security.hostReputation | Leia as propriedades e relações de um objeto microsoft.graph.security.hostReputation para um determinado microsoft.graph.security.host. |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
classificação | microsoft.graph.security.hostReputationClassification | A reputação calculada do anfitrião. Os valores possíveis são: unknown , neutral , suspicious , malicious , unknownFutureValue . |
id | Cadeia de caracteres | Um ID gerado pelo sistema para este anfitriãoReputation. |
regras | coleção microsoft.graph.security.hostReputationRule | Uma coleção de regras que foram utilizadas para calcular a classificação e a classificação. |
pontuação | Int32 | A classificação calculada (0-100) do anfitrião pedido. Um valor mais alto indica que este anfitrião é mais propenso a ser suspeito ou malicioso. |
Relações
Nenhum
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.security.hostReputation",
"classification": "String",
"id": "String (identifier)",
"rules": [
{
"@odata.type": "microsoft.graph.security.hostReputationRule"
}
],
"score": "Int32"
}