analyzing-cobalt-strike-beacon-configuration について
PE ファイル、shellcode、メモリダンプから Cobalt Strike Beacon の設定を抽出・解析するセキュリティ分析スキルです。インシデント対応担当者が C2 設定、通信プロファイル、水印を特定し、検知やインフラの関連付けに活用できます。
主な機能
- 01Beacon 設定の抽出
- 02C2 アドレスとプロトコルの解析
- 03Malleable C2 プロファイルの確認
- 04水印と通信間隔の取得
- 05設定とネットワーク通信の照合
活用シーン
- 01Cobalt Strike インシデントの調査
- 02関連する攻撃インフラの特定
- 03YARA とネットワーク検知ルールの作成
- 04Beacon 設定と観測した通信間隔の比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mukul975/ anthropic-cybersecurity-skills --skill analyzing-cobalt-strike-beacon-configurationインストール後、Claude Code で/analyzing-cobalt-strike-beacon-configurationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEassets/template.mdreferences/api-reference.mdstandards.mdworkflows.mdscripts/agent.pyprocess.py詳細
Cobalt Strike Beacon の設定の分析
概要
Cobalt Strike は、脅威アクターが侵害後の活動に広く悪用している商用の敵対者シミュレーションツールです。Beacon ペイロードには、C2 サーバーのアドレス、通信プロトコル、スリープ間隔、ジッター値、Malleable C2 プロファイル設定、ウォーターマーク識別子、暗号化キーを明らかにする設定データが埋め込まれています。この設定を PE ファイル、シェルコード、またはメモリダンプから抽出することは、インシデント対応者が攻撃者のインフラストラクチャを特定し、キャンペーンを帰属させるうえで重要です。Beacon の設定は単一バイト(バージョン 3 では 0x69、バージョン 4 では 0x2e)で XOR エンコードされ、.data セクション内に Type-Length-Value(TLV)形式で保存されています。
使用する場面
- Cobalt Strike Beacon の設定を分析する必要があるセキュリティインシデントを調査するとき
- この分野の検出ルールや脅威ハンティングクエリを作成するとき
- SOC アナリストがこの種の分析に関する体系的な手順を必要とするとき
- 関連する攻撃手法に対するセキュリティ監視の網羅性を検証するとき
前提条件
dissect.cobaltstrike、pefile、yara-pythonを含む Python 3.9 以降- SentinelOne CobaltStrikeParser(
parse_beacon_config.py) - 手動での検査に使う 16 進エディター(010 Editor、HxD)
- PE ファイル形式と XOR エンコードに関する知識
- メモリダンプ取得ツール(Volatility3、WinDbg)
- C2 トラフィックの照合に使うネットワーク分析ツール(Wireshark)
主な概念
Beacon 設定の構造
Cobalt Strike Beacon は、PE の .data セクション内にある TLV(Type-Length-Value)エントリーの塊として設定を保存します。スタグレス Beacon では、Beacon コード全体が 4 バイトのキーで XOR されます。設定の塊自体には、1 バイトの XOR キーが使われます。各 TLV エントリーには、2 バイトの型識別子(例:BeaconType の 0x0001、C2Server の 0x0008)、2 バイトの長さ、可変長のデータが含まれます。
Malleable C2 プロファイル
Beacon の設定には、URI パス、ヘッダー、メタデータのエンコード(Base64、NetBIOS)、データ変換など、HTTP リクエスト/レスポンスの変換方法を指定する Malleable C2 プロファイルがエンコードされています。これらの設定を分析すると、Beacon が正規の Web トラフィックに紛れ込むために、どのようにトラフィックを偽装するかがわかります。
ウォーターマークとライセンスの識別
Cobalt Strike の各ライセンスは、生成された Beacon に固有のウォーターマーク(4 バイト整数)を埋め込みます。ウォーターマークを抽出すると、複数の Beacon を同じオペレーターまたはクラックされたライセンスに関連付けられる場合があります。脅威インテリジェンスプロバイダーが管理する既知のウォーターマークデータベースでは、ウォーターマークを特定の脅威アクターや流出したライセンスキーに対応付けています。
ワークフロー
ステップ 1:CobaltStrikeParser を使用した設定の抽出
#!/usr/bin/env python3
"""Extract Cobalt Strike beacon config from PE or memory dump."""
import sys
import json
# Using SentinelOne's CobaltStrikeParser
# pip install dissect.cobaltstrike
from dissect.cobaltstrike.beacon import BeaconConfig
def extract_beacon_config(filepath):
"""Parse beacon configuration from file."""
configs = list(BeaconConfig.from_path(filepath))
if not configs:
print(f"[-] No beacon configuration found in {filepath}")
return None
for i, config in enumerate(configs):
print(f"\n[+] Beacon Configuration #{i+1}")
print(f"{'='*60}")
settings = config.as_dict()
# Critical fields for incident response
critical_fields = [
"SETTING_C2_REQUEST",
"SETTING_C2_RECOVER",
"SETTING_PUBKEY",
"SETTING_DOMAINS",
"SETTING_BEACONTYPE",
"SETTING_PORT",
"SETTING_SLEEPTIME",
"SETTING_JITTER",
"SETTING_MAXGET",
"SETTING_SPAWNTO_X86",
"SETTING_SPAWNTO_X64",
"SETTING_PIPENAME",
"SETTING_WATERMARK",
"SETTING_C2_VERB_GET",
"SETTING_C2_VERB_POST",
"SETTING_USERAGENT",
"SETTING_PROTOCOL",
]
for field in critical_fields:
value = settings.get(field, "N/A")
print(f" {field}: {value}")
return settings
return None
def extract_c2_indicators(config):
"""Extract actionable C2 indicators from beacon config."""
indicators = {
"c2_domains": [],
"c2_ips": [],
"c2_urls": [],
"user_agent": "",
"named_pipes": [],
"spawn_processes": [],
"watermark": "",
}
if not config:
return indicators
# Extract C2 domains
domains = config.get("SETTING_DOMAINS", "")
if domains:
for domain in str(domains).split(","):
domain = domain.strip().rstrip("/")
if domain:
indicators["c2_domains"].append(domain)
# Extract user agent
indicators["user_agent"] = str(config.get("SETTING_USERAGENT", ""))
# Extract named pipes
pipe = config.get("SETTING_PIPENAME", "")
if pipe:
indicators["named_pipes"].append(str(pipe))
# Extract spawn-to processes
for arch in ["SETTING_SPAWNTO_X86", "SETTING_SPAWNTO_X64"]:
proc = config.get(arch, "")
if proc:
indicators["spawn_processes"].append(str(proc))
# Extract watermark
indicators["watermark"] = str(config.get("SETTING_WATERMARK", ""))
return indicators
if __name__ == "__main__":
if len(sys.argv) < 2:
print(f"Usage: {sys.argv[0]} <beacon_file_or_dump>")
sys.exit(1)
config = extract_beacon_config(sys.argv[1])
if config:
indicators = extract_c2_indicators(config)
print(f"\n[+] Extracted C2 Indicators:")
print(json.dumps(indicators, indent=2))
ステップ 2:Beacon 設定の XOR 復号を手動で実行
import struct
def find_and_decrypt_config(data):
"""Manually locate and decrypt beacon configuration."""
# Cobalt Strike 4.x uses 0x2e as XOR key
xor_keys = [0x2e, 0x69] # v4, v3
for xor_key in xor_keys:
# Search for the config magic bytes after XOR
# Config starts with 0x0001 (BeaconType) XOR'd with key
magic = bytes([0x00 ^ xor_key, 0x01 ^ xor_key,
0x00 ^ xor_key, 0x02 ^ xor_key])
offset = data.find(magic)
if offset == -1:
continue
print(f"[+] Found config at offset 0x{offset:x} (XOR key: 0x{xor_key:02x})")
# Decrypt the config blob (typically 4096 bytes)
config_size = 4096
encrypted = data[offset:offset + config_size]
decrypted = bytes([b ^ xor_key for b in encrypted])
# Parse TLV entries
entries = parse_tlv(decrypted)
return entries
return None
def parse_tlv(data):
"""Parse Type-Length-Value configuration entries."""
entries = {}
offset = 0
# TLV field type mapping
field_names = {
0x0001: "BeaconType",
0x0002: "Port",
0x0003: "SleepTime",
0x0004: "MaxGetSize",
0x0005: "Jitter",
0x0006: "MaxDNS",
0x0007: "Deprecated_PublicKey",
0x0008: "C2Server",
0x0009: "UserAgent",
0x000a: "PostURI",
0x000b: "Malleable_C2_Instructions",
0x000c: "Deprecated_HttpGet_Metadata",
0x000d: "SpawnTo_x86",
0x000e: "SpawnTo_x64",
0x000f: "CryptoScheme",
0x001a: "Watermark",
0x001d: "C2_HostHeader",
0x0024: "PipeName",
0x0025: "Year",
0x0026: "Month",
0x0027: "Day",
0x0036: "ProxyHostname",
}
while offset + 6 <= len(data):
entry_type = struct.unpack(">H", data[offset:offset+2])[0]
entry_len_type = struct.unpack(">H", data[offset+2:offset+4])[0]
entry_len = struct.unpack(">H", data[offset+4:offset+6])[0]
if entry_type == 0:
break
value_start = offset + 6
value_end = value_start + entry_len
value_data = data[value_start:value_end]
field_name = field_names.get(entry_type, f"Unknown_0x{entry_type:04x}")
if entry_len_type == 1: # Short
value = struct.unpack(">H", value_data[:2])[0]
elif entry_len_type == 2: # Int
value = struct.unpack(">I", value_data[:4])[0]
elif entry_len_type == 3: # String/Blob
value = value_data.rstrip(b'\x00').decode('utf-8', errors='replace')
else:
value = value_data.hex()
entries[field_name] = value
print(f" {field_name}: {value}")
offset = value_end
return entries
ステップ 3:Beacon 検出用 YARA ルール
import yara
cobalt_strike_rule = """
rule CobaltStrike_Beacon_Config {
meta:
description = "Detects Cobalt Strike beacon configuration"
author = "Malware Analysis Team"
date = "2025-01-01"
strings:
// XOR'd config marker for CS 4.x (key 0x2e)
$config_v4 = { 2e 2f 2e 2c }
// XOR'd config marker for CS 3.x (key 0x69)
$config_v3 = { 69 68 69 6b }
// Common beacon strings
$str_pipe = "\\\\.\\pipe\\" ascii wide
$str_beacon = "beacon" ascii nocase
$str_sleeptime = "sleeptime" ascii nocase
// Reflective loader pattern
$reflective = { 4D 5A 41 52 55 48 89 E5 }
condition:
($config_v4 or $config_v3) or
(2 of ($str_*) and $reflective)
}
"""
def scan_for_beacons(filepath):
"""Scan file with YARA rules for Cobalt Strike beacons."""
rules = yara.compile(source=cobalt_strike_rule)
matches = rules.match(filepath)
for match in matches:
print(f"[+] YARA Match: {match.rule}")
for string_match in match.strings:
offset = string_match.instances[0].offset
print(f" String: {string_match.identifier} at offset 0x{offset:x}")
return matches
ステップ 4:ネットワークトラフィックの照合
from dissect.cobaltstrike.c2 import HttpC2Config
def analyze_c2_profile(beacon_config):
"""Analyze malleable C2 profile from beacon configuration."""
print("\n[+] Malleable C2 Profile Analysis")
print("=" * 60)
# HTTP GET configuration
get_verb = beacon_config.get("SETTING_C2_VERB_GET", "GET")
get_uri = beacon_config.get("SETTING_C2_REQUEST", "")
print(f"\n HTTP GET Request:")
print(f" Verb: {get_verb}")
print(f" URI: {get_uri}")
# HTTP POST configuration
post_verb = beacon_config.get("SETTING_C2_VERB_POST", "POST")
post_uri = beacon_config.get("SETTING_C2_POSTREQ", "")
print(f"\n HTTP POST Request:")
print(f" Verb: {post_verb}")
print(f" URI: {post_uri}")
# User Agent
ua = beacon_config.get("SETTING_USERAGENT", "")
print(f"\n User-Agent: {ua}")
# Host header
host = beacon_config.get("SETTING_C2_HOSTHEADER", "")
print(f" Host Header: {host}")
# Sleep and jitter for traffic pattern
sleep_ms = beacon_config.get("SETTING_SLEEPTIME", 60000)
jitter = beacon_config.get("SETTING_JITTER", 0)
print(f"\n Sleep Time: {sleep_ms}ms")
print(f" Jitter: {jitter}%")
# Generate Suricata/Snort signatures
print(f"\n[+] Suggested Network Signatures:")
if ua:
print(f' alert http any any -> any any (msg:"CS Beacon UA"; '
f'content:"{ua}"; http_user_agent; sid:1000001; rev:1;)')
if get_uri:
print(f' alert http any any -> any any (msg:"CS Beacon URI"; '
f'content:"{get_uri}"; http_uri; sid:1000002; rev:1;)')
検証基準
- PE ファイルまたはメモリダンプから Beacon の設定を正常に抽出できている
- C2 サーバーのドメイン/IP がポートおよびプロトコルとともに正しく特定されている
- Malleable C2 プロファイルのパラメーターがデコードされ、HTTP 変換が示されている
- 帰属分析との照合に使うウォーターマーク値が抽出されている
- スリープ時間とジッター値が、観測されたネットワーク上の Beacon 間隔と一致している
- YARA ルールがパック済みサンプルとアンパック済みサンプルの両方で Beacon を検出する
- 抽出した C2 プロファイルからネットワークシグネチャが生成されている