---
title: Malware Report
slug: homologacao-atmosphere/malware-report
description: Learn about a powerful malware report API that retrieves detailed information about a file's hash. Discover how to use different formats like md5, sha1, and sha256 as the required parameter. Explore the integration of X-Force Auth module parameters and ga
docTags: 
createdAt: 2022-08-01T17:42:32.000Z
---

## Resumo

- Retorna um relatório de malware para o hash de um arquivo fornecido, por exemplo, md5, sha1 e sha256.

## Parâmetros

| **Parâmetro** | **Requerido** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários**                                                                          |
| ------------- | ------------- | -------- | ---------------------------- | ---------------------------------------------------------------------------------------- |
| filehash      | Sim           | string   |                              | O hash do arquivo a ser analisado.<br /><br />Exemplo: 474B9CCF5AB9D72CA8A333889BBB34F0. |

Utiliza parâmetros do módulo [](https://docs.simonops.com/homologacao-atmosphere/shell)[](/yara)X-Force Auth.

## Exemplos

```yaml
# Realiza a verificação do hash especificado.
xforce_malware:
  api_key: api_key_
  api_password: api_password_hash
  filehash: 474B9CCF5AB9D72CA8A333889BBB34F0
register: result
```

## Valores retornados

| **Chave** | **Tipo**             | **Retornado quando** | **Descrição**                      |
| --------- | -------------------- | -------------------- | ---------------------------------- |
| malware   | dict                 | Sucesso              | Informações do malware encontrado. |
| tags      | lista de dicionários | Sucesso              | Lista de tags do malware.          |