akamai/firewall

Akamai防火墙规则与Site Shield CLI镜像文档

1. 镜像概述

本镜像包含Akamai官方提供的防火墙规则与Site Shield命令行工具(CLI)，基于https://github.com/akamai/cli-firewall%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E3%80%82%E8%AF%A5%E5%B7%A5%E5%85%B7%E6%97%A8%E5%9C%A8%E4%B8%BA%E7%94%A8%E6%88%B7%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%91%BD%E4%BB%A4%E8%A1%8C%E6%8E%A5%E5%8F%A3%EF%BC%8C%E7%94%A8%E4%BA%8E%E7%AE%A1%E7%90%86Akamai%E7%BD%91%E7%BB%9C%E4%B8%AD%E7%9A%84%E9%98%B2%E7%81%AB%E5%A2%99%E8%A7%84%E5%88%99%E9%85%8D%E7%BD%AE%E5%8F%8ASite Shield安全功能，支持安全规则的创建、修改、查询与删除等操作。

2. 核心功能与特性

• 防火墙规则管理：支持Akamai防火墙规则的创建、修改、删除及列表查询，可配置规则条件、行为及优先级
• Site Shield配置：提供Site Shield功能的管理接口，包括IP列表配置、状态查询及策略调整
• 批量操作支持：支持通过JSON文件批量导入/导出防火墙规则配置，简化大规模规则管理
• 状态监控：查询防火墙规则与Site Shield的当前状态、部署进度及生效情况
• Akamai API集成：无缝对接Akamai开放API，确保配置操作与Akamai平台实时同步

3. 使用场景与适用范围

• DevOps安全自动化：集成至CI/CD流程，实现安全规则的自动化部署与版本控制
• 安全运维管理：供安全运维人员通过命令行快速响应安全事件，调整防火墙策略
• 多环境配置同步：在开发、测试、生产环境间同步防火墙规则配置
• 批量规则更新：针对DDoS***等场景，批量更新防护规则以快速增强安全防护

4. 使用方法与配置说明

4.1 前提条件

• 拥有Akamai账户及API访问权限（需在Akamai Control Center创建API客户端，获取client_token、client_secret及access_token）
• 本地已安装Docker环境
• 准备包含API凭据的edgerc配置文件（格式参考Akamai API工具标准）

4.2 基本使用命令（Docker Run示例）

bash
# 挂载edgerc文件并列出所有防火墙规则
docker run --rm -v /本地路径/edgerc:/root/.edgerc akamai/cli-firewall firewall-rules list --section default

# 查看镜像版本信息
docker run --rm akamai/cli-firewall --version

4.3 常用命令示例

4.3.1 防火墙规则操作

bash
# 创建新防火墙规则（通过JSON文件定义规则）
docker run --rm -v /本地路径/edgerc:/root/.edgerc -v /本地路径/rules:/rules akamai/cli-firewall firewall-rules create --section default --rule-file /rules/new-rule.json

# 修改现有防火墙规则
docker run --rm -v /本地路径/edgerc:/root/.edgerc akamai/cli-firewall firewall-rules update --section default --rule-id 12345 --rule-file /rules/updated-rule.json

# 删除指定ID的防火墙规则
docker run --rm -v /本地路径/edgerc:/root/.edgerc akamai/cli-firewall firewall-rules delete --section default --rule-id 12345

4.3.2 Site Shield操作

bash
# 查看Site Shield当前配置
docker run --rm -v /本地路径/edgerc:/root/.edgerc akamai/cli-firewall site-shield show --section default

# 更新Site Shield IP列表
docker run --rm -v /本地路径/edgerc:/root/.edgerc -v /本地路径/ip-list.json:/ip-list.json akamai/cli-firewall site-shield update-ips --section default --ip-file /ip-list.json

4.4 配置参数说明

4.4.1 必要配置

• edgerc文件挂载：必须通过-v参数将本地edgerc文件挂载至容器内/root/.edgerc路径，文件格式示例：

  ini
  [default]
  client_token = akab-xxx
  client_secret = xxx
  access_token = akab-xxx
  host = akab-xxx.luna.akamaiapis.net
  

4.4.2 可选参数

• --section <section-name>：指定edgerc文件中的配置段名称（默认使用default）
• --rule-id <id>：防火墙规则唯一标识符，用于定位具体规则
• --rule-file <path>：本地JSON文件路径，包含防火墙规则的详细配置
• --ip-file <path>：本地JSON文件路径，包含Site Shield的IP列表配置

4.5 注意事项

• edgerc文件包含敏感API凭据，需确保文件权限设置为600（仅所有者可读写），避免信息泄露
• 执行规则删除或修改操作前，建议通过list命令备份当前规则配置
• 操作需对应的Akamai权限（如firewall-rules:write、site-shield:read等），权限不足将导致操作失败
• 大规模规则更新建议通过批量导入功能执行，减少API调用次数