fileHashEvidence resource type

Namespace: microsoft.graph.security

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a file hash value that is reported in a security detection alert, usually in relation to a file entity instance.

Inherits from alertEvidence.

Properties

Property	Type	Description
algorithm	microsoft.graph.security.fileHashAlgorithm	The hash algorithm type. Possible values are: unknown, md5, sha1, sha256, sha256ac, unknownFutureValue.
createdDateTime	DateTimeOffset	The date and time when the evidence was created and added to the alert. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024 is 2024-01-01T00:00:00Z. Inherited from alertEvidence.
detailedRoles	String collection	Detailed description of the entity role or roles in an alert. Values are free-form. Inherited from alertEvidence.
remediationStatus	microsoft.graph.security.evidenceRemediationStatus	Status of the remediation action taken. The possible values are: none, remediated, prevented, blocked, notFound, unknownFutureValue, active, pendingApproval, declined, unremediated, running, partiallyRemediated. Use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: active, pendingApproval, declined, unremediated, running, partiallyRemediated. Inherited from alertEvidence.
remediationStatusDetails	String	Details about the remediation status. Inherited from alertEvidence.
roles	microsoft.graph.security.evidenceRole collection	The role or roles that an evidence entity represents in an alert, for example, an IP address that is associated with an attacker has the evidence role Attacker. Inherited from alertEvidence.
tags	String collection	Array of custom tags associated with an evidence instance, for example, to denote a group of devices and high-value assets. Inherited from alertEvidence.
value	String	The hash value.
verdict	microsoft.graph.security.evidenceVerdict	The decision reached by automated investigation. The possible values are: unknown, suspicious, malicious, noThreatsFound, unknownFutureValue. Inherited from alertEvidence.

fileHashAlgorithm values

Member	Description
unknown	Unknown hash algorithm that is used mostly for forward compatibility.
md5	MD5 hash type.
sha1	SHA1 hash type.
sha256	SHA256 hash type.
sha256ac	SHA256 authenticode hash type.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.security.fileHashEvidence",
  "createdDateTime": "String (timestamp)",
  "verdict": "String",
  "remediationStatus": "String",
  "remediationStatusDetails": "String",
  "roles": [
    "String"
  ],
  "detailedRoles": [
    "String"
  ],
  "tags": [
    "String"
  ],
  "algorithm": "String",
  "value": "String"
}