Canarytokens 安装与配置指南

Canarytokens 安装与配置指南

canarytokens Canarytokens helps track activity and actions on your network. 项目地址: https://gitcode.com/gh_mirrors/ca/canarytokens

1. 项目基础介绍

Canarytokens 是一个由 Thinkst Applied Research 开发的开源项目，用于在网络中追踪活动和行为。该项目可以帮助监控和记录网络中的异常行为，通过设置“诱饵”或者“哨兵”来警告管理员可能的攻击或不当行为。

该项目主要使用以下编程语言开发：

• Python
• HTML
• Vue
• TypeScript
• CSS

2. 关键技术和框架

Canarytokens 使用了以下关键技术和框架：

• Python：后端服务的主要编程语言。
• Vue：前端用户界面的构建框架。
• HTML/CSS：用于构建和样式化前端界面。
• TypeScript：为前端提供类型安全的JavaScript开发体验。

3. 安装和配置准备工作

在开始安装之前，请确保您的系统已经安装以下依赖：

• Python 3.x
• Docker（推荐使用Docker安装）
• Git

以下是详细的安装步骤：

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/thinkst/canarytokens.git
   

2. 进入项目目录：

   cd canarytokens
   

3. 构建Docker容器（推荐使用Docker安装）：

   docker-compose up -d
   

   如果您没有使用Docker，则需要安装Python依赖项并手动配置项目，步骤如下：

   a. 安装Python依赖：

   pip install -r requirements.txt
   

   b. 配置环境变量，创建一个 .env 文件并添加必要的环境变量，例如：

   CANARY_DOMAINS=mytesttokensdomain.com
   CANARY_NXDOMAINS=pdf.demo.canarytokens.net
   ...
   

4. 运行项目：

   • 对于Docker：

     docker-compose exec web python manage.py runserver 0.0.0.0:8000
     

   • 对于非Docker：

     python manage.py runserver 0.0.0.0:8000
     

5. 访问项目：

   使用浏览器访问 http://localhost:8000，您应该能够看到Canarytokens的管理界面。

配置说明

Canarytokens 的配置文件分为两个主要部分：frontend.env 和 switchboard.env。这些文件包含了项目运行所需的各种配置信息，包括但不限于：

• 域名设置
• 邮件服务提供商配置
• SMTP服务器配置
• 安全和监控设置

确保按照项目文档中的说明正确配置这些文件，以便项目能够顺利运行。

以上步骤为Canarytokens的基本安装和配置过程，具体细节可能根据系统环境和个人需求有所不同，请参考项目官方文档进行相应的调整。

canarytokens Canarytokens helps track activity and actions on your network. 项目地址: https://gitcode.com/gh_mirrors/ca/canarytokens