Lendo um relatório de validação
Após a conclusão da validação, é possível exportar o relatório ou lê-lo on-line.
Procedimento
- Para fazer o download do relatório no formato JSON, clique no ícone de download (
) na parte superior direito da página. - Para ler o relatório online, clique no ícone do documento (
) na parte superior direito da página.As tabelas a seguir descrevem as etapas de validação e fornecem resoluções para corrigir erros.Tabela 1. Arquivo .zip de extensão Nome da regra Descrição Verificar extensão do arquivo .zip Verifica se o arquivo extensão .zip pode ser extraído e contém arquivos necessários. Existência de XML de exportação de conteúdo Verifica se o arquivo extensão .zip contém XML de Conteúdo. Se não, o processo de verificação é interrompido. Existência de manifest de extensão Verifica se o arquivo extensão .zip contém manifest.txt. Se não, o processo de verificação é interrompido. Tabela 2. Manifest de extensão (manifest.txt) Nome da regra Descrição Carregar manifest de extensão Verifica se o manifest.txt (as informações da extensão) está em formato JSON. Se não, o processo de verificação é interrompido. É possível fazer download do arquivo manifest.txt do portal de envio do X-Force App Exchange e os campos relacionados são gerados automaticamente. O formato da versão de extensão é válido Verifica se a versão da extensão (campo versão no manifest.txt) está em formato sequencial de três dígitos, conforme MAJOR.MINOR.PATCH. A versão mínima QRadar é válida Verifica se a versão suportada do QRadar (min_qradar_version definido em manifest.txt) é válida. Ele pode ser formatado em uma sequência de três dígitos (2019.14.6) ou quatro dígitos (2019.14.6.20201205215722). É possível efetuar login no QRadar usando SSH e usar /opt/qradar/bin/myver para localizar sua versão do QRadar em seu ambiente de desenvolvimento. A extensão deve suportar o idioma inglês Verifica se o doc.extension_manifest.supported_language_set (uma matriz) contém pelo menos 'en-US'. Este campo é gerado pelo portal de envio do App Exchange do X-Force. O tamanho do pacote de extensão é válido Verifica o doc.extension_manifest.package_size no arquivo manifest.txt. Este campo é gerado pelo portal de envio do App Exchange do X-Force. Verificando em outros campos Verifica se os campos obrigatórios (nome, descrição, autor e e-mail do autor) são definidos no arquivo manifest.txt. Esses campos são gerados pelo portal de envio do App Exchange do X-Force. Tabela 3. Assinatura de extensão Nome da regra Descrição Os artefatos de assinatura são colocados no diretório META-INF Verifica se a extensão é assinada. Para obter mais informações, consulte Como obter seu arquivo .zip de extensão pronto para validação. Tabela 4. XML de conteúdo Nome da regra Descrição Carregar XML de exportação de conteúdo Verifica se o XML de conteúdo pode ser carregado com sucesso. As informações do aplicativo são válidas Verifica se algum aplicativo é exportado neste XML de conteúdo. Se sim, verifique se as informações desse aplicativo estão corretas. O número da versão do QRadar está em formato válido Verifica se o <qradarversion>...</qradarversion> contém uma versão válida do QRadar com o formato correto Esse campo é gerado automaticamente por QRadar Para obter mais informações, consulte Exportação de itens de conteúdo customizado de diferentes tipos. Verificação de integridade de propriedade de evento customizado Verifica se alguma propriedade customizada neste Content XML está em conflito com as extensões publicadas. Se a extensão contiver propriedades que tenham o mesmo nome de outras extensões publicadas, ela não poderá ser instalada corretamente. Para corrigir ou evitar uma propriedade customizada em conflito, é possível instalar o IBM QRadar Dicionário de Propriedades Customizadas em seu QRadar Console e selecionar a propriedade na UI do console para exportar seu XML de conteúdo. Verificação de integridade de procura customizada Verifica se algum atributo de busca está faltando devido à modificação manual. Verificação de integridade de regra customizada Verifica se algum atributo de regra está ausente devido à modificação manual. Tabela 5. Arquivo .zip do aplicativo Nome da regra Descrição Extração de arquivo .zip Verifica se o arquivo .zip do aplicativo pode ser extraído com sucesso. Aplicativo de carregamento manifest.json Verifica se o arquivo manifest.json está em um formato JSON válido. O formato de versão do aplicativo é válido Verifica se a versão do aplicativo (campoversão em manifest.json) é uma sequência de três dígitos como MAJOR.MINOR.PATCH. Suportado por App Framework V2 Verifica se o aplicativo usa a nova imagem base que é fornecida pelo App Framework V2. Para obter mais informações, consulte QRadar: como migrar aplicativos da estrutura de app v1 para V2.. Verificar variáveis de ambiente Verifica se o valor de environment_variables no arquivo manifest.json está em um formato válido. Para obter mais informações, consulte Estrutura do aplicativo QRadar - Tipos de objetos de manifest - Variáveis de ambiente.. Verificar nomes de serviços e portas Verifica se o valor de environment_variables no arquivo manifest.json está em um formato válido. Para obter mais informações, consulte Estrutura do aplicativo QRadar - Tipos de objeto de manifest - Tipo de serviço. Nota: Se a extensão não contém apps, a verificação de regra no arquivo Application.zip é ignorada.Tabela 6. Scripts de instalação Nome da regra Descrição A estrutura da pasta é válida Verifica se o arquivo .zip do app contém pastas obrigatórias. Dependência de pacotes Python deve ser resolvida sem acesso à Internet Verifica se a dependência de pacotes Python pode ser resolvida localmente. É um requisito para que o aplicativo possa ser instalado com sucesso sem acesso à Internet. O script de instalação não deve acessar Internet Verifica se os scripts init em container/run e container/build não contêm comandos para acessar a Internet. Verificar pacotes de substituição Verifica se o arquivo .zip do aplicativo instala suas próprias versões do OpenSSH e SQLite3. Esses pacotes já são fornecidos no ambiente de tempo de execução do App Framework V2. Não deve usar sudo no script inicial Verifica se o comando sudo é usado nos scripts init nos diretórios container/run e container/build. Não deve usar encdec.py e qpylib customizados Verifica se o arquivo .zip do aplicativo contém a biblioteca qpylib integrada na página inicial. A biblioteca qpylib já é fornecida no ambiente de tempo de execução do App Framework V2. Nota: Se a extensão não contém apps, a verificação de regra nos scripts de instalação é ignorada.Tabela 7. Extensão e aplicativo na verificação Nome da regra Descrição O conteúdo pode ser instalado na versão mínima suportada do QRadar Verifica se o XML de conteúdo pode ser instalado na versão mínima suportada do QRadar definida no campo min_qradar_version, que de manifest.txt. Exemplos:
- min_qradar_version é configurado como "7.3.2" e o XML de conteúdo é exportado a partir do Fix Pack 5 da 7.3.2 (7.3.2 20191022133252).
- min_qradar_version é configurado como "7.3.2" e o XML do conteúdo é exportado do 7.3.1 GA (7.3.1. 20171206222136).
- min_qradar_version é configurado como "2019.14.0" (7.3.3 GA) e o XML do conteúdo é exportado do Fix Pack 6 da 7.3.3 (2019.14.6.20201205215722)
Observação:- É possível efetuar login no console do QRadar por meio de SSH usando /opt/qradar/bin/myver para ver sua versão interna do QRadar (quatro dígitos).
- min_qradar_version in manifext.txt está em uma sequência de três dígitos (2019.14.6) ou quatro dígitos (2019.14.6.20201205215722).
Verifique a versão exportada do QRadar no conteúdo em que o XML fornece o App Framework V2 O App Framework V2 é fornecido em QRadar 7.3.3 Fix Pack 6 +, 7.4.1 Fix Pack 2 + ou QRadar 7.4.2+ (não suportado em 7.4.0.x). Se sua extensão contiver pelo menos um aplicativo que é executado no App Framework V2, essa regra verificará se o XML de conteúdo é exportado na lista da versão do QRadar suportada. Verifique a versão mínima suportada do QRadar em manifest.txt fornece o App Framework V2 Se a sua extensão contém pelo menos um aplicativo executado no App Framework V2, esta regra verifica se a sua versão mínima suportada (min_qradar_version em manifest.txt) fornece o App Framework V2. Tabela 8. Verificação de segurança Nome da regra Descrição Verificação de segurança para códigos Python O app IBM QRadar Pré-Validação usa o Bandit para localizar problemas de segurança comuns no código Python
Não é incomum que o Bandit, ou quaisquer outras ferramentas automatizadas, gerem resultados falsos positivos. Analise o relatório para determinar a validade dos resultados.