huaweicloud/huaweicloud-skills

huawei-cloud-hss-query

- Query and manage Huawei Cloud HSS (Host Security Service) for daily security inspection and incident response.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/huaweicloud/huaweicloud-skills --skill huawei-cloud-hss-query

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Huawei Cloud HSS Host Security Skill

Overview

This skill provides AI Agent capabilities for Huawei Cloud HSS (Host Security Service / 主机安全服务), covering daily security inspection, risk diagnosis, and alert handling. It supports querying host assets, vulnerabilities, security baselines, intrusion alerts (trojans, brute-force attacks), and login audit logs, plus updating alert handling status — all via hcloud CLI.

Scope boundaries:

  • ✅ Query: host assets, vulnerabilities, baselines, intrusion alerts, login audit logs
  • ✅ Diagnose: risk scoring, high-risk vulnerability analysis, abnormal login analysis
  • ✅ Manage: update alert handling status (mark as handled, ignored, etc.)
  • ❌ Does NOT create or delete host resources
  • ❌ Does NOT execute isolation, antivirus, or other high-risk actions
  • ❌ Does NOT perform real-time blocking or kill processes

Prerequisites

  1. hcloud CLI installed and authenticated with valid AK/SK credentials.
  • Installation guide: see references/cli-installation-guide.md
  • Verify: hcloud configure list shows a valid profile
  1. HSS agent deployed on target ECS instances (HSS must be enabled in the console)
  2. IAM permissions: HSS read permissions for query operations, HSS write permissions for alert handling.
  • See references/iam-policies.md for least-privilege policy
  1. Region: HSS is region-specific. Use --cli-region to specify the target region (e.g., {your-region})

Workflow

1. Identify target → region, project_id, optional host_id filter
2. Query phase → list assets / vulnerabilities / baselines / alerts / login logs
3. Diagnose phase → risk score, high-risk items, abnormal login patterns
4. Handle phase → update alert handling status (requires user confirmation)
5. Output → structured JSON risk list + readable summary report

Core Commands

1. Host Assets (主机资产)

List all protected hosts with agent status, OS type, and risk flags:

bash
hcloud HSS ListHostStatus --cli-region={region} --project_id={project_id} \
  [--host_id={host_id}] [--host_name={host_name}] [--os_type={linux|windows}] \
  [--agent_status={installed|not_installed|online|offline}] \
  [--has_vul=true] [--has_intrusion=true] [--has_baseline=true] \
  [--asset_value={important|common|test}] [--limit=10] [--offset=0]

Show host statistics (total hosts, protected count, risk distribution):

bash
hcloud HSS ShowHostsStatistics --cli-region={region} --project_id={project_id}

Query risk status for specific hosts:

bash
hcloud HSS ListHostsRisk --cli-region={region} --project_id={project_id} \
  --host_id_list.1={host_id_1} [--host_id_list.2={host_id_2}]

2. Vulnerabilities (漏洞)

List all vulnerabilities with filtering by type, status, severity:

bash
hcloud HSS ListVulnerabilities --cli-region={region} --project_id={project_id} \
  [--vul_id={vul_id}] [--vul_name={vul_name}] [--cve_id={cve_id}] \
  [--type={linux_vul|windows_vul|web_cms|app_vul|urgent_vul}] \
  [--status={vul_status}] [--handle_status={handle_status}] \
  [--repair_priority={critical|high|medium|low}] \
  [--asset_value={important|common|test}] [--limit=10] [--offset=0]

List vulnerabilities on a specific host:

bash
hcloud HSS ListHostVuls --cli-region={region} --project_id={project_id} \
  --host_id={host_id} [--type={linux_vul|windows_vul|web_cms|app_vul|urgent_vul}] \
  [--limit=10] [--offset=0]

List hosts affected by a specific vulnerability:

bash
hcloud HSS ListVulHosts --cli-region={region} --project_id={project_id} \
  --type={linux_vul|windows_vul|web_cms|app_vul|urgent_vul} --vul_id={vul_id} \
  [--limit=10] [--offset=0]

Show vulnerability details (choose by type):

bash
# Linux vulnerability
hcloud HSS ShowLinuxVulDetail --cli-region={region} --project_id={project_id} \
  --vul_id={vul_id} --limit=10 --offset=0

# Windows vulnerability
hcloud HSS ShowWindowsVulDetail --cli-region={region} --project_id={project_id} \
  --vul_id={vul_id} --limit=10 --offset=0

# Web-CMS vulnerability
hcloud HSS ShowCmsVulDetail --cli-region={region} --project_id={project_id} \
  --vul_id={vul_id} --limit=10 --offset=0

Show vulnerability statistics:

bash
hcloud HSS ShowVulStatics --cli-region={region} --project_id={project_id}

3. Security Baselines (安全基线)

Show baseline check overview (last check time, check stats, pass rate, top risks):

bash
hcloud HSS ShowBaselineOverview --cli-region={region} --project_id={project_id}

Show baseline statistics:

bash
hcloud HSS ShowBaselineStatistic --cli-region={region} --project_id={project_id}

List hosts affected by a specific baseline check rule:

bash
hcloud HSS ListHostCheckRules --cli-region={region} --project_id={project_id} \
  --check_name={check_name} --standard={cn_standard|hw_standard} --host_id={host_id} \
  [--check_rule_name={rule_name}] [--limit=10] [--offset=0]
⚠️ --standard 为必填参数。

Show security check report for a specific host:

bash
hcloud HSS ShowSecurityCheckHostReport --cli-region={region} --project_id={project_id} \
  --host_id={host_id} --scan_time={scan_time_ms}
⚠️ --scan_time 为必填参数(毫秒级时间戳)。

Show risk configuration detail:

bash
hcloud HSS ShowRiskConfigDetail --cli-region={region} --project_id={project_id} \
  --check_name={check_name} --standard={cn_standard|hw_standard} \
  [--host_id={host_id}]
⚠️ --standard 为必填参数(cn_standard=等保合规标准,hw_standard=云安全实践标准)。

4. Intrusion Alerts — Trojan & Malware (木马/恶意软件告警)

Query alert event history with filtering by event type, severity, handling status:

bash
hcloud HSS ListEventHandleHistory --cli-region={region} --project_id={project_id} \
  [--event_type={event_type}] [--event_class_ids.1={event_class_id}] \
  [--severity={critical|high|medium|low}] [--handle_status={handled|unhandled}] \
  [--host_ip={ip}] [--host_name={name}] [--attack_tag={tag}] \
  [--asset_value={important|common|test}] [--limit=10] [--offset=0]

Common event_class_ids for malware:

eventclassidDescription
av_1002Virus (病毒)
av_1003Worm (蠕虫)
av_1004Trojan (木马)
av_1005Botnet (僵尸网络)
av_1006Backdoor (后门)
av_1010Rootkit
av_1011Ransomware (勒索软件)
av_1015Webshell
av_1016Mining software (挖矿软件)

List host protection history:

bash
hcloud HSS ListHostProtectHistoryInfo --cli-region={region} --project_id={project_id} \
  --start_time={start_time_ms} --end_time={end_time_ms} [--limit=10] [--offset=0] \
  [--host_id={host_id}] [--file_path={path}]
⚠️ `--start_time` / `--end_time` 为必填参数(毫秒级时间戳,相差不超过 30 天);--host_id 可选。

List antivirus-protected hosts:

bash
# List antivirus-protected hosts (scan_type: quick/full; start_type: now/period)
hcloud HSS ListAntiVirusHost --cli-region={region} --project_id={project_id} \
  --limit=10 --offset=0 --scan_type={quick|full} --start_type={now|period} \
  [--host_id={host_id}] [--policy_id={policy_id}]
⚠️ `--limit` / `--offset` / `--scan_type` / `--start_type` 为必填参数。 --scan_type 枚举:quick(快速扫描)/ full(全盘扫描);--start_type 枚举:now(立即启动)/ period(周期启动)。其他值(如 all/manual/auto)会被 API 静默忽略并返回空结果。

5. Intrusion Alerts — Brute Force (暴力破解告警)

Query brute-force attack events (login0001 = attempt, login0002 = success):

bash
hcloud HSS ListEventHandleHistory --cli-region={region} --project_id={project_id} \
  --event_class_ids.1=login_0001 --event_class_ids.2=login_0002 \
  [--severity={critical|high|medium|low}] [--handle_status={handled|unhandled}] \
  [--host_ip={ip}] [--limit=10] [--offset=0]

List weak password detection results:

bash
hcloud HSS ListWeakPasswordUsers --cli-region={region} --project_id={project_id} \
  [--host_id={host_id}] [--limit=10] [--offset=0]

6. Login Audit Logs (登录审计日志)

Query common login IPs:

bash
hcloud HSS ListLoginCommonIp --cli-region={region} --project_id={project_id} \
  [--ip_addr={ip}]

Query common login locations:

bash
hcloud HSS ListLoginCommonLocation --cli-region={region} --project_id={project_id} \
  [--area_code={area_code}]
⚠️ 这两个操作仅支持 --ip_addr / --area_code 过滤器(实测 --host_id/--limit/--offset 不支持),不可加分页参数。

7. Risk Diagnosis (风险诊断)

Query overall risk score:

bash
hcloud HSS ShowRiskScore --cli-region={region} --project_id={project_id}

Query risk status for specific hosts:

bash
hcloud HSS ListHostsRisk --cli-region={region} --project_id={project_id} \
  --host_id_list.1={host_id_1}

8. Update Alert Handling Status (告警处置) — ⚠️ Mutating, Requires Confirmation

Handle alert events (mark as handled, ignored, etc.):

bash
hcloud HSS ChangeEvent --cli-region={region} --project_id={project_id} \
  --operate_event_list.1.event_class_id={event_class_id} \
  --operate_event_list.1.event_id={event_id} \
  --operate_event_list.1.event_type={event_type} \
  --operate_event_list.1.occur_time={occur_time_ms} \
  --operate_type={operate_type}
⚠️ --operate_type 是顶层参数(不属于 operateeventlist 数组内);数组中 event_class_id/event_id/event_type/occur_time 均必填。

operate_type values for ChangeEvent:

  • mark_as_handled — Mark as handled (标记已处理)
  • ignore — Ignore (忽略)
  • add_to_alarm_whitelist — Add to alarm whitelist (加入告警白名单)
  • add_to_login_whitelist — Add to login whitelist (加入登录白名单)
  • unhandle — Restore to unhandled (恢复未处理)
  • do_not_ignore — Cancel ignore (取消忽略)
  • remove_from_alarm_whitelist — Remove from alarm whitelist (删除告警白名单)
  • remove_from_login_whitelist — Remove from login whitelist (删除登录白名单)
⚠️ ⛔ isolate_and_kill(隔离查杀)、do_not_isolate_or_kill 虽为 API 支持值,但本技能明确不执行隔离/杀毒等高危动作,AI 不得使用。

Update vulnerability handling status:

bash
hcloud HSS ChangeVulStatus --cli-region={region} --project_id={project_id} \
  --operate_type={ignore|not_ignore|immediate_repair|manual_repair|verify|add_to_whitelist} \
  --data_list.1.vul_id={vul_id} --host_data_list.1.host_id={host_id}
⚠️ 漏洞与主机通过 --data_list.[N].vul_id + --host_data_list.[N].host_id 关联传递(没有顶层 `--vul_id`/`--host_id` 参数)。

⚠️ Both ChangeEvent and ChangeVulStatus are mutating operations. Always prompt the user for confirmation before executing.

Parameter Confirmation

ParameterRequiredDescriptionExample
--cli-regionYesTarget region{your-region}
--project_idYesProject ID (auto-detected if omitted)Auto from CLI profile
--host_idNoFilter by host IDxxxxxxxx-xxxx-xxxx
--severityNoRisk severity filtercritical, high, medium, low
--typeNoVulnerability typelinux_vul, windows_vul, web_cms
--repair_priorityNoVulnerability repair prioritycritical, high, medium, low
--handle_statusNoAlert handling status filterhandled, unhandled
--event_class_ids.NNoEvent class ID filter (indexed)av_1004 (trojan)
--limitNoPage size (default 10)10
--offsetNoPage offset (default 0)0
--enterprise_project_idNoEnterprise project filter0 for default
--asset_valueNoAsset importance filterimportant, common, test

Output Format

All commands return JSON by default. For inspection reports, the skill aggregates multiple query results into a structured risk summary:

json
{
  "inspection_time": "2026-08-28T10:00:00Z",
  "region": "{region}",
  "host_summary": { "total": 10, "protected": 8, "at_risk": 3 },
  "vulnerabilities": { "critical": 2, "high": 5, "medium": 12, "low": 8 },
  "baselines": { "pass_rate": "85%", "failed_rules": 7 },
  "alerts": { "unhandled_trojan": 1, "unhandled_brute_force": 3 },
  "risk_score": 72,
  "recommendations": ["Fix 2 critical vulnerabilities on host xxx", "Handle 1 unhandled trojan alert"]
}

Reference Documents

  • references/cli-installation-guide.md — hcloud CLI installation and authentication
  • references/iam-policies.md — Least-privilege IAM policies for HSS
  • references/verification-method.md — Verification and testing methods
  • references/dataflow-diagram.md — Data flow diagram
  • references/acceptance-criteria.md — Acceptance criteria
  • references/hss-event-class-reference.md — HSS event class ID reference

KooCLI Command Format Standard

bash
hcloud HSS ListHostStatus --cli-region={region} --project_id={project_id} [--key=value ...]
FeatureDescriptionExample
Service nameHSS (exact KooCLI service name)HSS
Operation namePascalCaseListHostStatus, ShowVulStatics, ChangeEvent
Region parameter--cli-region=<value>--cli-region={region}
Simple parameter--key=value--host_id=xxx
Indexed parameter--key.1=value1--host_id_list.1=xxx

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
huaweicloud
Comunidad

huawei-cloud-devbridge-tunnel

Create and manage DevBridge development tunnels on Huawei Cloud to securely expose local development services to remote devices. Based on DevBridge CLI v0.2.x and API Key authentication. Use this skill when the user wants to: (1) install and configure the DevBridge CLI, (2) create/list/update/delete tunnels, (3) manage tunnel ports and protocols, (4) host local services through tunnels, (5) connect to remote tunnels from another device, (6) manage authentication and API Keys. Trigger: user menti

Instalaciones / 1h
3
GitHub Stars
59
Actualizado
20 nov
huaweicloud
Comunidad

huawei-cloud-find-skills

Invoke this skill to search, list, query, discover, browse, find and install any Huawei Cloud (华为云) agent skill. Triggers include: "华为云", "华为云有什么skill", "华为云相关skill", "华为云agent skill 市场", "华为云skill类目", "explore Huawei Cloud skills", "show Huawei Cloud skill categories", "does a Huawei Cloud skill exist for...", "which Huawei Cloud skills exist", "搜索华为云技能", "查询华为云skill列表", "有没有管理ECS/OBS/RDS的skill", "帮我找 XX 华为云skill", "介绍 XX Skill 内容", "华为云 XX Skill 具体做什么", "安装华为云Skill".

Instalaciones / 1h
3
GitHub Stars
59
Actualizado
20 nov
huaweicloud
Comunidad

huawei-cloud-terraform-installer

Installs Terraform CLI cross-platform with Huawei Cloud mirror support. Use this skill whenever the user mentions installing Terraform, setting up Terraform environment, or when IaC tasks detect missing Terraform. Trigger: install terraform, setup terraform, terraform environment, huaweicloud provider.

Instalaciones / 1h
6
GitHub Stars
59
Actualizado
7 nov
huaweicloud
Comunidad

huawei-cloud-billing-scout

Huawei Cloud BSS billing (not AWS/Azure/other clouds; refuses pricing quotes, real-name review, and any non-billing scope): balance, spend, attribution, reconciliation, coupons, stored-value cards, enterprise/partner billing. One-page briefing via hcloud. Use when the request is about Huawei Cloud billing. Triggers include: 华为云余额, 华为云欠费, 华为云本月花费, 华为云扣费原因, 华为云账单对账, 华为云资源包, 华为云优惠券, 华为云企业主账号, 华为云伙伴账务, 华为云服务编码, Huawei Cloud balance / bill / spend / reconciliation / coupon / stored-value card / BSS b

Instalaciones / 1h
5
GitHub Stars
59
Actualizado
7 nov