You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
virt/web/app/Services/TicketTelegramNotifier.php

174 lines
7.4 KiB
PHP

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<?php
namespace App\Services;
use App\Models\Configurations;
use App\Models\User;
use TelegramBot\Api\BotApi;
/** Administrator-only ticket alerts. No Telegram user login or ticket reply commands. */
final class TicketTelegramNotifier
{
private const KEY = 'ticket_telegram_binding';
public const BINDING_TTL = 300;
public static function enabled(): bool
{
return in_array(Config::get('enable_telegram'), [true, 1, '1', 'true'], true);
}
public static function configured(): bool
{
return trim((string) Config::get('telegram_token', '')) !== ''
&& preg_match('/^[A-Za-z0-9_-]{16,256}$/D', (string) Config::get('telegram_request_token', '')) === 1;
}
public static function authorizeWebhook(string $header): bool
{
$secret = (string) Config::get('telegram_request_token', '');
return self::enabled() && self::configured() && hash_equals($secret, $header);
}
public static function bindingStatus(): array
{
$state = self::readState(Configurations::where('name', self::KEY)->first());
$adminId = (int) ($state['bound_admin_id'] ?? 0);
return ['bound' => !empty($state['chat_id']) && self::eligibleAdmin($adminId), 'admin_id' => $adminId];
}
public static function createBinding(int $adminId): array
{
if (!self::enabled() || !self::configured()) {
throw new \RuntimeException('请先启用 Telegram,并配置 bot token 和有效的 webhook secret');
}
if (!self::eligibleAdmin($adminId)) {
throw new \RuntimeException('只有超级管理员可以绑定工单通知');
}
$code = bin2hex(random_bytes(24));
Configurations::firstOrCreate(['name' => self::KEY], ['value' => '{}']);
(new Configurations())->getConnection()->transaction(function () use ($adminId, $code) {
$row = Configurations::where('name', self::KEY)->lockForUpdate()->firstOrFail();
$state = self::readState($row);
$state['pending_hash'] = hash('sha256', $code);
$state['pending_admin_id'] = $adminId;
$state['pending_expires_at'] = time() + self::BINDING_TTL;
$row->value = json_encode($state, JSON_THROW_ON_ERROR);
$row->save();
});
return ['code' => $code, 'expires_in' => self::BINDING_TTL];
}
public static function unbind(): void
{
Configurations::where('name', self::KEY)->delete();
}
public static function bindingCommand(array $update): ?array
{
$message = $update['message'] ?? null;
if (!is_array($message) || ($message['chat']['type'] ?? '') !== 'private'
|| !empty($message['from']['is_bot']) || !empty($message['forward_origin'])
|| !empty($message['forward_from']) || !empty($message['forward_date'])) {
return null;
}
$chatId = (string) ($message['chat']['id'] ?? '');
$senderId = (string) ($message['from']['id'] ?? '');
if (!preg_match('/^[1-9][0-9]{0,18}$/D', $chatId) || $chatId !== $senderId
|| !preg_match('/^\/start\s+([a-f0-9]{48})$/D', (string) ($message['text'] ?? ''), $matches)) {
return null;
}
return ['chat_id' => $chatId, 'code' => $matches[1]];
}
public static function handleUpdate(array $update): bool
{
$command = self::bindingCommand($update);
if ($command === null) {
return false;
}
return (new Configurations())->getConnection()->transaction(function () use ($command) {
$row = Configurations::where('name', self::KEY)->lockForUpdate()->first();
$state = self::readState($row);
$adminId = (int) ($state['pending_admin_id'] ?? 0);
if ($row === null || (int) ($state['pending_expires_at'] ?? 0) <= time()
|| !hash_equals((string) ($state['pending_hash'] ?? ''), hash('sha256', $command['code']))
|| !self::eligibleAdmin($adminId)) {
return false;
}
// One-time token consumed atomically; replay cannot change the recipient.
$row->value = json_encode(['bound_admin_id' => $adminId, 'chat_id' => $command['chat_id']], JSON_THROW_ON_ERROR);
$row->save();
return true;
});
}
public static function notify(string $event, int $ticketId, string $title, string $content): bool
{
if (!self::enabled() || !self::configured()) {
return false;
}
try {
$state = self::readState(Configurations::where('name', self::KEY)->first());
$chatId = $state['chat_id'] ?? null;
if ((!is_string($chatId) && !is_int($chatId))
|| preg_match('/^[1-9][0-9]{0,18}$/D', (string) $chatId) !== 1
|| !self::eligibleAdmin((int) ($state['bound_admin_id'] ?? 0))) {
return false;
}
$label = in_array($event, ['created', '新工单'], true) ? '新工单' : '工单更新';
$plain = strip_tags($title . "\n" . $content);
$text = $label . ' #' . $ticketId . "\n" . mb_substr($plain, 0, 3000, 'UTF-8');
(new BotApi((string) Config::get('telegram_token')))->call('sendMessage', [
'chat_id' => (string) $chatId,
'text' => $text,
'disable_web_page_preview' => 'true',
], 10);
return true;
} catch (\Throwable $exception) {
// SDK error URLs may contain bot secrets. Never log their messages.
error_log('Administrator ticket Telegram delivery failed; ticket=' . $ticketId);
return false;
}
}
public static function registerWebhook(): bool
{
$baseUrl = rtrim((string) Config::get('baseUrl', ''), '/');
$parts = parse_url($baseUrl);
if (!self::enabled() || !self::configured() || !is_array($parts)
|| ($parts['scheme'] ?? '') !== 'https' || empty($parts['host'])
|| isset($parts['user']) || isset($parts['pass']) || isset($parts['query']) || isset($parts['fragment'])) {
throw new \RuntimeException('请检查 Telegram 配置与网站 HTTPS baseUrl');
}
try {
$result = (new BotApi((string) Config::get('telegram_token')))->call('setWebhook', [
'url' => $baseUrl . '/telegram_callback',
'secret_token' => (string) Config::get('telegram_request_token'),
'allowed_updates' => '["message"]',
], 10);
if ($result !== true) {
throw new \RuntimeException('Webhook registration rejected');
}
return true;
} catch (\Throwable $exception) {
throw new \RuntimeException('Telegram webhook 注册失败,请检查 HTTPS、出站网络和 bot 配置');
}
}
private static function readState($row): array
{
$state = $row === null ? [] : json_decode((string) $row->value, true);
return is_array($state) ? $state : [];
}
private static function eligibleAdmin(int $adminId): bool
{
$allowed = array_map('intval', explode(',', (string) Config::get('super_admin', '')));
if ($adminId <= 0 || !in_array($adminId, $allowed, true)) {
return false;
}
$user = User::find($adminId);
return $user !== null && (bool) $user->is_admin && (int) $user->enable === 1;
}
}