fraudmarc-ce 的安装和配置教程

1. 项目基础介绍和主要编程语言

Fraudmarc CE（Community Edition）是一个开源的DMARC报告分析工具，专为政府机构设计，但也适用于企业和个人用户。它可以帮助用户分析和理解DMARC聚合报告，从而更好地管理电子邮件安全和认证。该项目使用TypeScript和Go作为主要的编程语言，同时也使用了HTML、SCSS、CSS和JavaScript等辅助性语言。

2. 项目使用的关键技术和框架

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

• AWS Services: 包括Amazon S3、Amazon CloudFront、AWS Lambda、Amazon API Gateway、Amazon RDS、AWS Cognito等，以构建一个完全托管的服务。
• AWS CDK (Cloud Development Kit): 用于定义和部署AWS基础设施。
• Angular: 用于构建用户界面的前端框架。
• TypeScript: 强类型JavaScript超集，用于前端开发。
• Go: 用于后端服务的开发，因其性能和并发处理能力而受到青睐。
• Docker: 可以用于本地开发环境，以简化依赖管理。

3. 项目安装和配置的准备工作和详细步骤

准备工作

在开始安装之前，请确保您已经完成了以下准备工作：

• 安装了最新版本的Node.js和npm。
• 安装了AWS CLI并配置了相应的AWS访问密钥。
• 确保您的AWS账户中启用了所需的IAM权限和服务。
• 准备了一个用于Fraudmarc CE的子域名，并在DNS中添加了相应的记录。

安装步骤

以下是将Fraudmarc CE部署到AWS的详细步骤：

1. 克隆仓库

   git clone https://github.com/Fraudmarc/fraudmarc-ce.git
   cd fraudmarc-ce
   

2. 安装依赖

   npm install
   

3. 配置环境变量 在项目根目录下创建一个.env文件，并添加以下内容（替换为您的实际信息）：

   REACT_APP_API_URL=https://your-api-url
   AWS_REGION=your-aws-region
   AWS_ACCESS_KEY_ID=your-access-key-id
   AWS_SECRET_ACCESS_KEY=your-secret-access-key
   

4. 构建前端

   npm run build
   

5. 部署前端到S3 使用AWS CLI将构建的前端文件上传到S3桶：

   aws s3 cp dist/ s3://your-bucket-name/ --recursive
   

6. 部署后端 使用AWS CDK或CloudFormation模板来部署后端服务，包括Lambda函数、API Gateway、RDS数据库等。

7. 配置Cognito 在AWS Cognito中设置用户池和身份提供者，以便进行用户认证。

8. 更新DNS记录 在DNS提供商处更新子域名的CNAME记录，指向您的CloudFront分发。

9. 启动服务 使用AWS CLI或AWS Management Console启动所有服务，并确保它们正常运行。

10. 访问应用 在浏览器中访问您的子域名，使用Cognito提供的登录界面进行登录，开始使用Fraudmarc CE。

请注意，上述步骤是一个简化的安装流程，具体部署细节可能会根据项目版本和AWS服务的更新而变化。建议参考项目的官方文档和AWS的官方文档以获得最新和最详细的安装指导。