qualys/jira-client-for-jira-integration

Qualys 与 Atlassian Jira 集成镜像

镜像概述和主要用途

该Docker镜像提供Qualys漏洞管理平台与Atlassian Jira工单系统的集成能力，旨在打通安全漏洞数据与IT运维流程。通过拉取Qualys检测到的主机及漏洞数据，自动在Jira中创建、更新和关闭可操作工单，实现漏洞响应流程的自动化与可视化，提升跨团队协作效率及漏洞修复速度。

核心功能和特性

跨团队协同与决策支持

• 共同可见性：实现IT团队与安全团队对漏洞状态的统一视图，消除信息孤岛。
• 漏洞上下文集成：在Jira工单中嵌入漏洞关键信息（如QID、资产标签、严重性等级等），辅助修复决策。

自动化工单全生命周期管理

• 自动化流程：基于Qualys扫描结果自动创建、更新和关闭Jira工单，减少手动操作。
• 灵活规则配置：支持按漏洞严重性阈值、资产组、资产标签、QID（Qualys漏洞ID）或QDS（Qualys检测签名）定义工单生成条件。

多环境适配与简化部署

• 多版本Jira支持：兼容Jira Cloud（云部署）和Jira Server/Data Center（本地部署）。
• 交钥匙解决方案：最小化配置即可启用核心功能，降低部署门槛。

多样化工单与报告能力

• 两种工单方案：
  • 每个漏洞检测生成独立工单；
  • 漏洞工单与易受***主机工单关联，形成层级化跟踪结构。
• 原生报告功能：利用Jira原生过滤器、仪表板及JQL（Jira查询语言）构建漏洞状态跟踪与响应效率分析报告。

使用场景和适用范围

适用团队与组织

• 安全运营团队（SecOps）：需将漏洞管理流程与工单系统整合，自动化响应流程。
• IT运维团队：需实时获取漏洞信息并跟踪修复进度，协同安全团队执行修复。
• 中大型企业：存在跨团队协作需求，需统一漏洞管理与IT工单流程的组织。

典型应用场景

• 漏洞响应自动化：当Qualys检测到高/严重级别漏洞时，自动在Jira创建工单并分配负责人。
• 跨团队协作：安全团队发现漏洞后，通过Jira工单直接推动IT团队执行修复，避免沟通延迟。
• 合规与审计：利用Jira仪表板生成漏洞修复进度报告，满足PCI DSS、ISO 27001等合规要求。

详细使用方法和配置说明

前置条件

• 环境要求：Docker Engine 19.03+，网络可访问Qualys API端点（如https://qualysapi.qualys.com）及Jira服务。
• 凭证准备：
  • Qualys账户：具备API访问权限及漏洞数据读取权限；
  • Jira账户：具备工单创建/更新权限及API访问凭证（云版需API令牌，本地版需密码）。

Docker部署示例

1. 快速部署（docker run）

bash
docker run -d \
  --name qualys-jira-integration \
  -e QUALYS_API_URL="https://qualysapi.qualys.com" \
  -e QUALYS_USERNAME="your_qualys_username" \
  -e QUALYS_PASSWORD="your_qualys_password" \
  -e JIRA_URL="https://your-jira-instance.atlassian.net" \
  -e JIRA_USER_EMAIL="jira_user@example.com" \
  -e JIRA_API_TOKEN="your_jira_api_token" \
  -e TICKET_RULES="severity:high,critical,asset_group:web_servers" \
  -e TICKET_SCHEME="per_detection" \
  -e SYNC_INTERVAL=60 \
  qualys/jira-integration:latest

2. 容器编排（docker-compose）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  qualys-jira-integration:
    image: qualys/jira-integration:latest
    container_name: qualys-jira-integration
    restart: always
    environment:
      - QUALYS_API_URL=https://qualysapi.qualys.com
      - QUALYS_USERNAME=secops@example.com
      - QUALYS_PASSWORD=P@ssw0rd123
      - JIRA_URL=https://your-jira.atlassian.net
      - JIRA_USER_EMAIL=jira-admin@example.com
      - JIRA_API_TOKEN=atlassian-token-abc123
      - TICKET_RULES=severity:high,asset_tag:production,QID:12345
      - TICKET_SCHEME=linked_tickets
      - LOG_LEVEL=info
      - SYNC_INTERVAL=30
    volumes:
      - ./config:/app/config  # 挂载自定义规则配置文件
      - ./logs:/app/logs      # 挂载日志目录

启动服务：docker-compose up -d

核心配置参数说明

注意事项

• 网络连通性：部署前需验证容器可访问Qualys API和Jira端点（可通过docker exec -it <容器名> curl <URL>测试）。
• 规则配置：TICKET_RULES条件需符合Qualys数据模型，具体字段及取值范围参考Qualys API文档。
• 复杂规则自定义：如需按资产标签分配工单负责人等高级规则，需挂载配置文件（如./config/rules.json），格式详见用户指南。

扩展信息

• 功能细节咨询：联系您的Qualys技术客户经理。
• 完整部署与配置步骤：参考Qualys-Jira集成用户指南。