user_id !== (int) $actor['user_id'] || !CloudSessionService::active( $sessionId, (int) $instance->host_id, (string) $instance->uuid )) { throw new CloudError('控制台会话已失效,请重新登录', 401); } [$ticket, $agentExpiry] = self::validateAgentTicket($agentTicket); if (!self::agentReady((int) $instance->host_id)) { throw new CloudError( '宿主机 Agent 或面板网络尚未配置就绪,请重新配置并测试', 503 ); } $now = time(); $ticketExpiry = min($agentExpiry, $now + self::BROWSER_TTL); if ($ticketExpiry <= $now) { throw new CloudError('宿主机 Agent 返回的控制台票据已经过期', 502); } $browserTicket = rtrim(strtr(base64_encode(random_bytes(32)), '+/', '-_'), '='); $record = new CloudConsoleTicket(); $record->ticket_hash = hash('sha256', $browserTicket); $record->session_id = $sessionId; $record->user_id = (int) $actor['user_id']; $record->instance_id = (int) $instance->id; $record->host_id = (int) $instance->host_id; $record->vm_uuid = strtolower((string) $instance->uuid); $record->sealed_agent_ticket = CloudSecrets::encrypt([ 'ticket' => $ticket, 'host_id' => (int) $instance->host_id, 'vm_uuid' => strtolower((string) $instance->uuid), ], 'console-agent-ticket'); $record->agent_expires_at = $agentExpiry; $record->ticket_expires_at = $ticketExpiry; $record->connection_expires_at = min( (int) $session->expires_at, $now + self::MAX_CONNECTION_SECONDS ); $record->consumed_at = null; $record->connection_id = null; $record->created_at = $now; $record->save(); self::purgeExpired($now); return [ 'ticket' => $browserTicket, 'expires_in' => $ticketExpiry - $now, 'websocket_path' => '/engine-console', ]; } public static function introspect(array $input): array { $allowed = ['ticket', 'connection_id', 'consume']; foreach (array_keys($input) as $key) { if (!is_string($key) || !in_array($key, $allowed, true)) { throw new CloudError('控制台校验请求无效', 400); } } $ticket = $input['ticket'] ?? null; $consume = $input['consume'] ?? null; $connectionId = $input['connection_id'] ?? null; if (!is_string($ticket) || preg_match('/^[A-Za-z0-9_-]{32,256}$/D', $ticket) !== 1 || !is_bool($consume)) { throw new CloudError('控制台校验请求无效', 400); } if ($consume) { if ($connectionId !== null) { throw new CloudError('控制台首次校验不能包含连接编号', 400); } } elseif (!is_string($connectionId) || preg_match('/^[a-f0-9]{64}$/D', $connectionId) !== 1) { throw new CloudError('控制台连接编号无效', 400); } $hash = hash('sha256', $ticket); $connection = (new CloudConsoleTicket())->getConnection(); return $connection->transaction(static function () use ( $hash, $consume, $connectionId ): array { $record = CloudConsoleTicket::query() ->where('ticket_hash', $hash) ->lockForUpdate() ->first(); $now = time(); if ($record === null || !CloudSessionService::active( (string) $record->session_id, (int) $record->host_id, (string) $record->vm_uuid )) { return ['active' => false]; } if (!self::agentReady((int) $record->host_id)) { return ['active' => false]; } if ($consume) { if ($record->consumed_at !== null || (int) $record->ticket_expires_at <= $now || (int) $record->agent_expires_at <= $now) { return ['active' => false]; } $sealed = CloudSecrets::decrypt( (string) $record->sealed_agent_ticket, 'console-agent-ticket' ); if ((int) ($sealed['host_id'] ?? 0) !== (int) $record->host_id || !is_string($sealed['vm_uuid'] ?? null) || !hash_equals((string) $record->vm_uuid, strtolower($sealed['vm_uuid'])) || !is_string($sealed['ticket'] ?? null) || preg_match('/^[A-Za-z0-9_-]{32,256}$/D', $sealed['ticket']) !== 1) { return ['active' => false]; } $newConnectionId = bin2hex(random_bytes(32)); $record->connection_id = $newConnectionId; $record->consumed_at = $now; $record->save(); return [ 'active' => true, 'connection_id' => $newConnectionId, 'agent_id' => (string) $record->host_id, 'agent_ticket' => $sealed['ticket'], 'agent_expires_at' => gmdate( 'Y-m-d\\TH:i:s\\Z', (int) $record->agent_expires_at ), ]; } return [ 'active' => $record->consumed_at !== null && (int) $record->connection_expires_at > $now && is_string($record->connection_id) && hash_equals($record->connection_id, $connectionId), ]; }, 3); } private static function agentReady(int $hostId): bool { $setting = CloudHostAgent::find($hostId); return $setting !== null && $setting->isReady(); } private static function validateAgentTicket(array $value): array { $ticket = $value['ticket'] ?? null; $expiresAt = $value['expires_at'] ?? null; if (array_is_list($value) || count($value) !== 2 || !array_key_exists('ticket', $value) || !array_key_exists('expires_at', $value) || !is_string($ticket) || preg_match('/^[A-Za-z0-9_-]{32,256}$/D', $ticket) !== 1 || !is_string($expiresAt)) { throw new CloudError('宿主机 Agent 返回了无效控制台票据', 502); } try { $expiry = (new \DateTimeImmutable($expiresAt))->getTimestamp(); } catch (\Throwable $error) { throw new CloudError('宿主机 Agent 返回了无效票据期限', 502); } $now = time(); if ($expiry <= $now || $expiry > $now + 90) { throw new CloudError('宿主机 Agent 返回了无效票据期限', 502); } return [$ticket, $expiry]; } private static function purgeExpired(int $now): void { CloudConsoleTicket::query() ->where('connection_expires_at', '<=', $now - 3600) ->limit(100) ->delete(); } }