《CISA 25-01网络安全审计法案》MCP服务器配置文档

目录

• 简介
• 安装指南
• 配置说明
• 工具使用说明
• API接口参考
• 错误处理
• 测试方法
• 安全注意事项
• 贡献指南
• 许可证协议

简介

本项目提供一个MCP服务器实现，用于支持《CISA 25-01网络安全审计法案》。该法案要求联邦 civilian executive departments and agencies 在其 IT 基础设施中实施特定的网络安全措施。本文档详细介绍了如何配置和使用此MCP服务器。

安装指南

克隆仓库

git clone https://github.com/DynamicEndpoints/BOD-25-01-CSA-MCP.git
cd cisa-m365

安装依赖

npm install

构建服务器

npm run build

配置说明

创建Azure AD应用

1. 登录 Azure Portal
2. 进入 Azure Active Directory
3. 注册一个新的应用程序
4. 添加所需的API权限（如 "Directory.ReadWrite.All", "User.ReadWrite" 等）
5. 创建一个应用程序密钥

配置环境变量

复制示例文件并编辑：

cp .env.example .env

修改 .env 文件内容：

TENANT_ID=your-tenant-id
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret

配置MCP设置

创建或更新 MCP 配置文件：

{
  "mcpServers": {
    "cisa-m365": {
      "command": "node",
      "args": ["path/to/cisa-m365/build/index.js"],
      "env": {
        "TENANT_ID": "your-tenant-id",
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

工具使用说明

可用工具列表

block_legacy_auth

阻止 legacy 认证方式。

{}

block_high_risk_users

阻止高风险用户登录。

{}

enforce_phishing_resistant_mfa

强制启用反钓鱼 MFA 功能。

{}

configure_global_admins

配置 Global Administrator 角色分配。

{
  "userIds": ["user1-id", "user2-id"]
}

get_policy_status

获取所有安全策略的当前状态。

{}

示例用法

在 Node.js 中使用：

// 阻止 legacy 认证方式
const result = await client.callTool('block_legacy_auth', {});

// 获取策略状态
const status = await client.callTool('get_policy_status', {});

API 接口参考

政策设置接口

interface PolicySettings {
  老认证: {
    禁止: boolean;
    符合要求: boolean;
  };
  高风险用户: {
    禁止: boolean;
    符合要求: boolean;
  };
  mfa: {
    反钓鱼MFA: boolean;
    替代方式已启用: boolean;
    符合要求: boolean;
  };
  应用程序: {
    注册受限: boolean;
    同意受限: boolean;
    符合要求: boolean;
  };
  密码策略: {
    禁止使用弱密码: boolean;
    符合要求: boolean;
  };
}

错误处理

错误代码示例

{
  "error": {
    "code": "INVALID_SYNTAX",
    "message": "配置文件语法错误"
  }
}

常见问题解答

• Q: 如何排查MCP服务器启动失败的问题？
  • A: 检查日志文件，确认环境变量是否正确设置。

测试方法

单元测试

npm test

集成测试

1. 启动 MCP 服务。
2. 使用测试工具发送请求并验证响应。

安全注意事项

• 确保所有敏感信息（如应用程序密钥）不以明文形式存储或传输。
• 定期更新依赖库，防范已知安全漏洞。
• 配置适当的安全策略和访问控制措施。

贡献指南

1. Fork 项目仓库。
2. 创建功能分支并提交代码。
3. 提交 Pull Request 并参与代码审查。

许可证协议

本项目遵循 MIT 协议，具体内容请参考 LICENSE 文件。