'对外 TCP SYN 扫描', 'outbound_tcp_port_scan' => '对外 TCP 端口扫描', 'outbound_udp_fanout' => '对外 UDP 扇出', 'inbound_tcp_syn_attack' => '入站 TCP SYN 攻击', 'inbound_tcp_port_scan' => '入站 TCP 端口扫描', 'inbound_udp_flood' => '入站 UDP Flood', ]; private const EVIDENCE_LABELS = [ 'tcp_active_flows' => 'TCP 活跃 Flow', 'tcp_new_flows' => 'TCP 新建 Flow', 'tcp_syn_flows' => 'TCP SYN Flow', 'tcp_unreplied_flows' => 'TCP 未应答 Flow', 'udp_active_flows' => 'UDP 活跃 Flow', 'udp_new_flows' => 'UDP 新建 Flow', 'unique_remote_ips' => '唯一远端 IP 数', 'unique_remote_ports' => '唯一远端端口数', 'unique_local_ports' => '唯一本地端口数', 'max_remote_ports_per_remote_ip' => '单远端 IP 最大端口数', 'max_remote_ips_per_remote_port' => '单远端端口最大 IP 数', 'max_local_ports_per_remote_ip' => '单远端 IP 最大本地端口数', 'max_remote_ips_per_local_port' => '单本地端口最大远端 IP 数', ]; public function format(object $event): string { $eventId = self::positiveInteger(self::value($event, 'id'), 'event id'); $instanceId = self::positiveInteger( self::value($event, 'instance_id'), 'instance id' ); $userId = self::positiveInteger(self::value($event, 'user_id'), 'user id'); $hostId = self::positiveInteger(self::value($event, 'host_id'), 'host id'); $policyRevision = self::positiveInteger( self::value($event, 'policy_revision'), 'policy revision' ); $occurredAt = self::positiveInteger( self::value($event, 'occurred_at'), 'occurred at' ); $rule = (string) self::value($event, 'rule_code'); $direction = (string) self::value($event, 'direction'); $family = (string) self::value($event, 'ip_family'); $type = (string) self::value($event, 'transition_type'); $from = (string) self::value($event, 'from_severity'); $to = (string) self::value($event, 'to_severity'); $reason = (string) self::value($event, 'resolution_reason'); if (!isset(self::RULE_LABELS[$rule]) || !in_array($direction, ['inbound', 'outbound'], true) || !in_array($family, ['ipv4', 'ipv6', 'mixed'], true) || !self::validTransition($type, $from, $to, $reason)) { throw new \InvalidArgumentException( 'Invalid abuse alert transition snapshot' ); } $evidence = self::decodeEvidence(self::value($event, 'evidence_json')); $resolved = $type === 'resolved'; $title = $resolved ? '✅ 网络风险已恢复' : ($to === 'high' ? '🔴 网络滥用高风险告警' : '🟠 网络异常告警'); $transition = [ 'opened' => '新触发', 'escalated' => '风险升级', 'resolved' => $reason === 'policy_replaced' ? '策略更新后关闭' : '已恢复', ][$type]; $directionLabel = $direction === 'inbound' ? '入站受攻击' : '出站可疑行为'; $severity = $resolved ? ($from === 'high' ? '高风险已解除' : '可疑状态已解除') : ($to === 'high' ? '高风险' : '可疑'); $evidenceParts = []; foreach ($evidence as $key => $count) { $evidenceParts[] = self::EVIDENCE_LABELS[$key] . ' ' . number_format($count, 0, '.', ','); } $lines = [ $title, '', '实例:#' . $instanceId, '用户:#' . $userId, '宿主机:#' . $hostId, '发生时间:' . gmdate('Y-m-d H:i:s', $occurredAt) . ' UTC', '告警:#' . $eventId, '策略:r' . $policyRevision, '', ($resolved ? '✅ ' : ($to === 'high' ? '🔴 ' : '🟠 ')) . $transition . ' · ' . self::RULE_LABELS[$rule], '方向:' . $directionLabel . ' · ' . strtoupper($family) . ' · ' . $severity, '证据:' . ($evidenceParts === [] ? '未记录聚合计数' : implode(';', $evidenceParts)), '', '后台:' . self::adminUrl( (string) Config::get('baseUrl', ''), $instanceId ), '说明:仅包含聚合元数据,不包含通信正文或远端地址明细。', ]; $message = implode("\n", $lines); if (mb_strlen($message, 'UTF-8') > 4096) { throw new \LogicException('Abuse alert message exceeded Telegram limit'); } return $message; } private static function validTransition( string $type, string $from, string $to, string $reason ): bool { return ($type === 'opened' && $from === 'none' && in_array($to, ['suspicious', 'high'], true) && $reason === '') || ($type === 'escalated' && $from === 'suspicious' && $to === 'high' && $reason === '') || ($type === 'resolved' && in_array($from, ['suspicious', 'high'], true) && $to === 'none' && in_array($reason, [ 'evidence_clear', 'policy_replaced', ], true)); } /** @return array */ private static function decodeEvidence(mixed $json): array { if (!is_string($json) || $json === '' || strlen($json) > 16384) { throw new \InvalidArgumentException('Invalid abuse alert evidence'); } try { $value = json_decode($json, true, 8, JSON_THROW_ON_ERROR); } catch (\JsonException $error) { throw new \InvalidArgumentException( 'Invalid abuse alert evidence', 0, $error ); } if (!is_array($value) || array_is_list($value)) { throw new \InvalidArgumentException('Invalid abuse alert evidence'); } $normalized = []; foreach ($value as $key => $count) { if (!is_string($key) || !isset(self::EVIDENCE_LABELS[$key]) || !is_int($count) || $count < 0) { throw new \InvalidArgumentException('Invalid abuse alert evidence'); } $normalized[$key] = $count; } ksort($normalized, SORT_STRING); return $normalized; } private static function adminUrl(string $baseUrl, int $instanceId): string { $baseUrl = rtrim(trim($baseUrl), '/'); $parts = parse_url($baseUrl); if ($baseUrl === '' || !is_array($parts) || !in_array($parts['scheme'] ?? '', ['http', 'https'], true) || empty($parts['host']) || isset($parts['user']) || isset($parts['pass']) || isset($parts['query']) || isset($parts['fragment']) || preg_match('/[\x00-\x20\x7f]/', $baseUrl) === 1) { throw new \InvalidArgumentException('Invalid administrator base URL'); } return $baseUrl . '/admin/abuse-monitoring?query=' . $instanceId; } private static function positiveInteger(mixed $value, string $label): int { if ((!is_int($value) && !is_string($value)) || preg_match('/^[1-9][0-9]*$/D', (string) $value) !== 1 || strlen((string) $value) > strlen((string) PHP_INT_MAX) || (strlen((string) $value) === strlen((string) PHP_INT_MAX) && strcmp((string) $value, (string) PHP_INT_MAX) > 0)) { throw new \InvalidArgumentException('Invalid abuse alert ' . $label); } return (int) $value; } private static function value(object $row, string $key): mixed { return $row->{$key} ?? null; } }