intelowlproject/intelowl_ng

⚠️ 此仓库已归档。IntelOwl已使用React.js开发新GUI，代码仅存在于https://github.com/intelowlproject/IntelOwl/tree/dev-v4/frontend中。

IntelOwl-ng

镜像概述和主要用途

IntelOwl-ng是https://github.com/intelowlproject/intelowl的官方Web客户端。Intel Owl是一个可扩展的API，通过查询多种外部或内部可用的分析器和服务，收集关于特定文件或可观察对象（IP、域名、URL、哈希）的威胁情报数据。

该客户端基于https://github.com/angular/angular构建，以https://github.com/akveo/ngx-admin为基础框架，提供直观的图形界面，方便用户与Intel Owl后端交互。

演示

在线演示（托管于Firebase，最后更新对应IntelOwl v3.0.0版本）

核心功能和特性

• 作业数据可视化仪表板：

  • 作业表格视图，支持筛选、排序和搜索
  • 基于状态、可观察对象分类、文件MIME类型和是否为样本的饼图可视化
  • 点击饼图切片可按所选分类筛选作业列表
  • 图表"另存为PNG"功能

• 作业结果查看：支持嵌套列表或格式化JSON两种展示方式

• 分析器配置管理：

  • https://github.com/intelowlproject/IntelOwl/blob/master/configuration/analyzer_config.json的表格视图，支持筛选、排序和搜索
  • 树状图视图展示分析器配置

• 新分析请求提交：

  • 简洁易用的表单界面
  • 自动处理输入验证和警告提示
  • 支持指定标签对分析进行分组

使用场景和适用范围

适用于需要通过图形界面管理和使用Intel Owl威胁情报分析平台的场景，包括：

• 安全分析师进行威胁情报数据可视化与分析
• 安全运营团队监控和管理分析作业
• 研究人员配置和提交新的威胁情报分析请求

Docker镜像说明

IntelOwl-ng的Docker镜像（https://hub.docker.com/r/intelowlproject/intelowl_ng）是一个数据专用镜像。即基于scratch镜像，仅包含最终生产构建产物，无法直接作为容器启动。

镜像特点

• 超轻量级：未压缩约7MB
• 用途：通过Docker多阶段构建将构建产物注入其他基础容器（如nginx）

注意：无需自行构建或启动此Docker镜像，应始终使用Intel Owl主仓库提供的docker-compose文件。官方使用示例可参考https://github.com/intelowlproject/IntelOwl/blob/develop/Dockerfile_nginx。

安装与使用方法

开发环境要求

开发服务器依赖proxy.config.json中的代理配置与后端服务器通信，因此需要Intel Owl后端运行在默认地址http://localhost:80。如需修改后端URL，可调整proxy.config.json中的target参数。

克隆仓库

bash
$ git clone https://github.com/intelowlproject/intelowl-ng
$ cd intelowl-ng/

本地构建

依赖项

• https://github.com/nodejs/node：v12.18.0（最新LTS版本）
• 包管理工具：https://github.com/yarnpkg/yarn v1.22.4 或 https://github.com/npm/npm

安装依赖包

bash
intelowl-ng$ yarn install
# 或
intelowl-ng$ npm install

启动开发服务器

bash
intelowl-ng$ npm start
# 或
intelowl-ng$ yarn start

服务器启动后，访问http://localhost:4200/。应用会在修改源代码后自动重载，可通过Ctrl-C手动关闭。

开发指南

项目结构

dist/                        编译产物目录
e2e/                         端到端测试目录
src/                         项目源代码
|- app/                      应用组件
|  |- @core/                 核心模块（单例服务和一次性组件）
|     |- models/models.ts    各种接口定义
|     |- services/           可注入服务
|  |- @theme/                可复用主题模块、组件、指令、管道
|     |- styles/             ngx-admin主题和全局SCSS变量
|  |- pages/                 应用主要模块和组件
|  |- app.component.*        应用根组件（外壳）
|  |- app.module.ts          应用根模块定义
|  |- app-routing.module.ts  应用路由配置
|- assets/                   应用资源（图片等）
|- environments/             不同构建环境的配置值
|- index.html                HTML入口文件
|- main.ts                   应用入口文件
|- polyfills.ts              Angular所需的polyfills
+- test.ts                   单元测试入口文件
README.md                    项目文档和编码指南
Dockerfile                   多阶段Dockerfile

使用的库

• https://angular.io - v10.x
• https://akveo.github.io/nebular/5.1.0/ - v6.2.x
• https://github.com/akveo/ngx-admin
• RxJS - v6.6.x
• https://akveo.github.io/eva-icons/
• https://getbootstrap.com/docs/4.5/getting-started/introduction/
• https://akveo.github.io/ng2-smart-table/#/

代码脚手架

使用Angular CLI生成新组件：

bash
ng generate component component-name

也可生成指令、管道、服务、类或模块：

bash
ng generate directive/pipe/service/class/module

构建项目

bash
ng build
# 或
yarn build

构建产物将存储在dist/目录。使用--prod标志进行生产构建：

bash
ng build --prod
# 或
yarn build --prod

进一步帮助

如需Angular CLI帮助，可运行：

bash
ng --help

或查阅Angular-CLI README文档。

贡献指南

1. 基于包含最新更改的develop分支创建新分支：

bash
$ git checkout -b myfeature develop

2. 提交更改前运行以下命令：

bash
$ yarn prettier:write
$ yarn lint

修复所有 linting 问题。

3. 提交PR前，请阅读https://intelowl.readthedocs.io/en/latest/Contribute.html#create-a-pull-request。