Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Host Security Service/ Referência de API/ Descrição da API/ Gerenciamento de vulnerabilidades/ Consulta de informações de vulnerabilidade sobre um servidor

Atualizado em 2024-09-14 GMT+08:00

Ver PDF

Consulta de informações de vulnerabilidade sobre um servidor

Função

Esta API é usada para consultar as informações de vulnerabilidade sobre um servidor.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

GET /v5/{project_id}/vulnerability/host/{host_id}

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto do locatário. Mínimo: 1 Máximo: 256
host_id	Sim	String	ID do servidor. Mínimo: 1 Máximo: 128

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
enterprise_project_id	Não	String	ID do projeto empresarial. Para consultar todos os projetos empresariais, defina este parâmetro como all_granted_eps. Padrão: 0 Mínimo: 0 Máximo: 256
type	Não	String	Tipo de vulnerabilidade. O valor padrão é linux_vul. As opções são as seguintes: linux_vul: vulnerabilidade do Linux windows_vul: vulnerabilidade do Windows -web_cms: vulnerabilidade de Web-CMS app_vul: vulnerabilidade da aplicação urgent_vul: vulnerabilidade de emergência Mínimo: 0 Máximo: 64
vul_name	Não	String	Nome de vulnerabilidade Mínimo: 0 Máximo: 256
limit	Não	Integer	Número de registros exibidos em cada página. Mínimo: 0 Máximo: 200 Padrão: 10
offset	Não	Integer	Deslocamento, que especifica a posição inicial do registro a ser retornado. O valor deve ser um número não menor que 0. O valor padrão é 0. Mínimo: 0 Máximo: 2000000 Padrão: 0
handle_status	Não	String	Status de manipulação. As opções são as seguintes: -unhandled -handled Mínimo: 1 Máximo: 32
status	Não	String	Status da vulnerabilidade. As opções são as seguintes: vul_status_unfix: não corrigido vul_status_ignored: ignorado vul_status_verified: verificação em andamento vul_status_fixing: a correção está em andamento. vul_status_fixed: a correção foi bem sucedida. vul_status_reboot: o problema foi corrigido e aguarda a reinicialização. vul_status_failed: o problema não foi corrigido. vul_status_fix_after_reboot: reinicie o servidor e tente novamente. Mínimo: 1 Máximo: 32
repair_priority	Não	String	Prioridade de correção. As opções são as seguintes: Critical High Medium Low Mínimo: 1 Máximo: 10

Parâmetros de solicitação

**Tabela 3** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token. Mínimo: 1 Máximo: 32768

Parâmetros de resposta

Código de status: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
total_num	Long	Total Mínimo: 0 Máximo: 2147483647
data_list	Array of HostVulInfo objects	Lista de vulnerabilidades em um servidor Comprimento da matriz: 0–2147483647

**Tabela 5** HostVulInfo
Parâmetro	Tipo	Descrição
vul_name	String	Nome de vulnerabilidade Mínimo: 0 Máximo: 256
vul_id	String	ID de vulnerabilidade Mínimo: 0 Máximo: 64
label_list	Array of strings	Lista de tags de vulnerabilidade Mínimo: 0 Máximo: 65534 Comprimento da matriz: 0–2147483647
repair_necessity	String	Urgência de reparo. As opções são as seguintes: immediate_repair: o problema deve ser corrigido o mais rápido possível. delay_repair: o problema pode ser corrigido mais tarde. not_needed_repair: o problema não precisa ser corrigido. Mínimo: 0 Máximo: 64
scan_time	Long	Hora da última verificação Mínimo: 0 Máximo: 9223372036854775807
type	String	Tipo de vulnerabilidade. As opções são as seguintes: -linux_vul: vulnerabilidade do Linux -windows_vul: vulnerabilidade do Windows -web_cms: vulnerabilidade de Web-CMS -app_vul: vulnerabilidade de aplicação Mínimo: 0 Máximo: 128
app_list	Array of app_list objects	Lista de softwares afetados pela vulnerabilidade no servidor Comprimento da matriz: 0–2147483647
severity_level	String	Nível de risco. Critical: a pontuação de CVSS da vulnerabilidade é maior ou igual a 9, correspondendo ao nível de alto risco no console. High: a pontuação de CVSS da vulnerabilidade é maior ou igual a 7 e menor que 9, correspondendo ao nível de risco médio no console. Medium: a pontuação de CVSS da vulnerabilidade é maior ou igual a 4 e menor que 7, correspondendo ao nível de risco médio no console. Low: a pontuação de CVSS da vulnerabilidade é menor que 4, correspondendo ao nível de risco baixo no console. Mínimo: 1 Máximo: 128
solution_detail	String	Solução Mínimo: 0 Máximo: 65534
url	String	URL Mínimo: 0 Máximo: 2083
description	String	Descrição da vulnerabilidade Mínimo: 0 Máximo: 65534
repair_cmd	String	Comando de reparo Mínimo: 1 Máximo: 256
status	String	Status da vulnerabilidade vul_status_unfix: não corrigido vul_status_ignored: ignorado vul_status_verified: verificação em andamento vul_status_fixing: a correção está em andamento. vul_status_fixed: a correção foi bem sucedida. vul_status_reboot: o problema foi corrigido e aguarda a reinicialização. vul_status_failed: o problema não foi corrigido. vul_status_fix_after_reboot: reinicie o servidor e tente novamente. Mínimo: 1 Máximo: 128
repair_success_num	Integer	Total de vezes que a vulnerabilidade é corrigida pelo HSS em toda a rede Mínimo: 0 Máximo: 1000000
cve_list	Array of cve_list objects	Lista de CVE Comprimento da matriz: 1–10000
is_affect_business	Boolean	Se os serviços são afetados
first_scan_time	Long	Hora da primeira verificação Mínimo: 0 Máximo: 9223372036854775807
app_name	String	Software Mínimo: 0 Máximo: 256
app_version	String	Versão Mínimo: 0 Máximo: 256
app_path	String	Caminho do software Mínimo: 0 Máximo: 512
version	String	Cota do ECS Mínimo: 0 Máximo: 128
support_restore	Boolean	Indica se os dados podem ser revertidos para o backup criado quando a vulnerabilidade foi corrigida.
disabled_operate_types	Array of disabled_operate_types objects	Lista de tipos de operação de vulnerabilidades que não podem ser executadas. Comprimento da matriz: 1–10000
repair_priority	String	Prioridade de correção. As opções são as seguintes: Critical High Medium Low Mínimo: 1 Máximo: 10

**Tabela 6** app_list
Parâmetro	Tipo	Descrição
app_name	String	Software Mínimo: 0 Máximo: 256
app_version	String	Versão do software Mínimo: 0 Máximo: 256
upgrade_version	String	Versão para a qual o software com vulnerabilidade precisa ser atualizado Mínimo: 0 Máximo: 256
app_path	String	Caminho do software de aplicação (este campo está disponível apenas para vulnerabilidades de aplicação). Mínimo: 1 Máximo: 512

**Tabela 7** cve_list
Parâmetro	Tipo	Descrição
cve_id	String	ID de CVE Mínimo: 1 Máximo: 32
cvss	Float	Pontuação de CVSS Mínimo: 0 Máximo: 10

**Tabela 8** disabled_operate_types
Parâmetro	Tipo	Descrição
operate_type	String	Tipo de operação. ignore not_ignore: cancelar a ignoração immediate_repair: corrigir manual_repair verify add_to_whitelist Mínimo: 1 Máximo: 64
reason	String	Indica o motivo pelo qual a operação não pode ser executada. Mínimo: 0 Máximo: 512

Exemplo de solicitações

Consultar as 10 primeiras vulnerabilidades no servidor cujo ID é xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

GET https://{endpoint}/v5/2b31ed520xxxxxxebedb6e57xxxxxxxx/vulnerability/host/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx?offset=0&limit=10

Exemplo de respostas

Código de status: 200

Lista de vulnerabilidades em um servidor

{
  "data_list" : [ {
    "app_list" : [ {
      "app_name" : "Apache Log4j API(Apache Log4j API)",
      "app_version" : "2.8.2",
      "upgrade_version" : "2.8.3",
      "app_path" : "/CloudResetPwdUpdateAgent/lib/log4j-api-2.8.2.jar"
    }, {
      "app_name" : "Apache Log4j Core(Apache Log4j Core)",
      "app_version" : "2.8.2",
      "upgrade_version" : "2.8.3",
      "app_path" : "/CloudResetPwdUpdateAgent/lib/log4j-api-2.8.2.jar"
    } ],
    "app_name" : "Apache Log4j API(Apache Log4j API)",
    "app_path" : "/CloudResetPwdUpdateAgent/lib/log4j-api-2.8.2.jar",
    "app_version" : "2.8.2",
    "cve_list" : [ {
      "cve_id" : "CVE-2021-45046",
      "cvss" : 9
    } ],
    "description" : "It was found that the fix for address CVE-2021-44228 in Apache Log4j 2.15.0 was incomplete in some non-default configurations. This could allow attackers with control over Thread Context Map (MDC) input data when the logging configuration uses a non-default Pattern Layout with either a Context Lookup (for example, $${ctx:loginId}) or a Thread Context Map pattern (%X, %mdc, or %MDC) to craft malicious input data using a JNDI Lookup pattern, leading to information leakage and remote code execution in some environments. Log4j 2.16.0 (Java 8) and 2.12.2 (Java 7) fix this issue by removing support for the message search mode and disabling the JNDI function by default.",
    "first_scan_time" : 1688956612533,
    "is_affect_business" : true,
    "label_list" : [ ],
    "repair_necessity" : "Critical",
    "scan_time" : 1690469489713,
    "severity_level" : "Critical",
    "repair_cmd" : "yum update tcpdump",
    "solution_detail" : "The official fixing suggestions for this vulnerability have been released. You can visit the following website and fix the vulnerability accordingly:\nhttps://logging.apache.org/log4j/2.x/security.html\nFor details about the patch for this vulnerability, visit the following website:\nhttps://www.oracle.com/security-alerts/cpujan2022.html\nFor details about unofficial fixing suggestions for this vulnerability, visit the following website:\nhttp://www.openwall.com/lists/oss-security/2021/12/14/4\nhttps://www.intel.com/content/www/us/en/security-center/advisory/intel-sa-00646.html\nhttps://tools.cisco.com/security/center/content/CiscoSecurityAdvisory/cisco-sa-apache-log4j-qRuKNEbd\nhttp://www.openwall.com/lists/oss-security/2021/12/15/3\nhttps://cert-portal.siemens.com/productcert/pdf/ssa-661247.pdf\nhttps://www.kb.cert.org/vuls/id/930724\nhttps://cert-portal.siemens.com/productcert/pdf/ssa-714170.pdf\nhttps://www.debian.org/security/2021/dsa-5022\nhttps://www.oracle.com/security-alerts/alert-cve-2021-44228.html\nhttps://psirt.global.sonicwall.com/vuln-detail/SNWLID-2021-0032\nhttp://www.openwall.com/lists/oss-security/2021/12/18/1\nhttps://cert-portal.siemens.com/productcert/pdf/ssa-397453.pdf\nhttps://cert-portal.siemens.com/productcert/pdf/ssa-479842.pdf\nhttps://lists.fedoraproject.org/archives/list/package-announce@lists.fedoraproject.org/message/EOKPQGV24RRBBI4TBZUDQMM4MEH7MXCY/\nhttps://lists.fedoraproject.org/archives/list/package-announce@lists.fedoraproject.org/message/SIG7FZULMNK2XF6FZRU4VWYDQXNMUGAJ/\nThe vulnerability exploitation/POC of this vulnerability has been exposed. You can verify the vulnerability by referring to the following links:\nhttps://github.com/X1pe0/Log4J-Scan-Win\nhttps://github.com/cckuailong/Log4j_CVE-2021-45046\nhttps://github.com/BobTheShoplifter/CVE-2021-45046-Info\nhttps://github.com/tejas-nagchandi/CVE-2021-45046\nhttps://github.com/pravin-pp/log4j2-CVE-2021-45046\nhttps://github.com/mergebase/log4j-samples\nhttps://github.com/lukepasek/log4jjndilookupremove\nhttps://github.com/ludy-dev/cve-2021-45046\nhttps://github.com/lijiejie/log4j2_vul_local_scanner\nhttps://github.com/CaptanMoss/Log4Shell-Sandbox-Signature\nhttps://github.com/taise-hub/log4j-poc",
    "status" : "vul_status_unfix",
    "type" : "app_vul",
    "url" : "[\"https://www.oracle.com/security-alerts/cpujan2022.html\"]",
    "version" : "hss.version.wtp",
    "vul_id" : "HCVD-APP-CVE-2021-45046",
    "vul_name" : "CVE-2021-45046",
    "repair_success_num" : 3,
    "support_restore" : true,
    "disabled_operate_types" : [ {
      "operate_type" : "immediate_repair",
      "reason" : "The kernel vulnerability of CCE container node cannot be automatically fixed."
    } ]
  } ],
  "total_num" : 31
}

Código de amostra do SDK

O código de amostra do SDK é o seguinte.

Java

    
     
       
       
         package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.hss.v5.region.HssRegion;
import com.huaweicloud.sdk.hss.v5.*;
import com.huaweicloud.sdk.hss.v5.model.*;


public class ListHostVulsSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        HssClient client = HssClient.newBuilder()
                .withCredential(auth)
                .withRegion(HssRegion.valueOf("<YOUR REGION>"))
                .build();
        ListHostVulsRequest request = new ListHostVulsRequest();
        request.withEnterpriseProjectId("<enterprise_project_id>");
        request.withType("<type>");
        request.withVulName("<vul_name>");
        request.withLimit(<limit>);
        request.withOffset(<offset>);
        request.withHandleStatus("<handle_status>");
        request.withStatus("<status>");
        request.withRepairPriority("<repair_priority>");
        try {
            ListHostVulsResponse response = client.listHostVuls(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

        

      

    
   

Python

    
     
       
       
         # coding: utf-8

from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkhss.v5.region.hss_region import HssRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkhss.v5 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = __import__('os').getenv("CLOUD_SDK_AK")
    sk = __import__('os').getenv("CLOUD_SDK_SK")

    credentials = BasicCredentials(ak, sk) \

    client = HssClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(HssRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListHostVulsRequest()
        request.enterprise_project_id = "<enterprise_project_id>"
        request.type = "<type>"
        request.vul_name = "<vul_name>"
        request.limit = <limit>
        request.offset = <offset>
        request.handle_status = "<handle_status>"
        request.status = "<status>"
        request.repair_priority = "<repair_priority>"
        response = client.list_host_vuls(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

        

      

    
   

Go

    
     
       
       
         package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    hss "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/hss/v5"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/hss/v5/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/hss/v5/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := hss.NewHssClient(
        hss.HssClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListHostVulsRequest{}
	enterpriseProjectIdRequest:= "<enterprise_project_id>"
	request.EnterpriseProjectId = &enterpriseProjectIdRequest
	typeRequest:= "<type>"
	request.Type = &typeRequest
	vulNameRequest:= "<vul_name>"
	request.VulName = &vulNameRequest
	limitRequest:= int32(<limit>)
	request.Limit = &limitRequest
	offsetRequest:= int32(<offset>)
	request.Offset = &offsetRequest
	handleStatusRequest:= "<handle_status>"
	request.HandleStatus = &handleStatusRequest
	statusRequest:= "<status>"
	request.Status = &statusRequest
	repairPriorityRequest:= "<repair_priority>"
	request.RepairPriority = &repairPriorityRequest
	response, err := client.ListHostVuls(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

        

      

    
   

Mais

Para obter o código de amostra do SDK de mais linguagens de programação, consulte a guia Código de amostra no API Explorer. O código de amostra do SDK pode ser gerado automaticamente.