TL;DR
- Диагностируйте аутентификацию CDP на первой фазе неудачи: поиск бизнес API, проблема с учетными данными или рукопожатие WebSocket.
- Отправьте бизнес-ключ API Nstdata как
x-api-keyдля HTTP-запросов сессии. Включитеx-team-id, когда выбираете присоединенную команду с личным ключом. - Убедитесь, что оригинальная сессия
ready, прежде чем запрашивать временные учетные данные автоматизации. - Постройте заголовок WebSocket из возвращенного
headerNameиaccessToken. Префикс Bearer только дляAuthorization. - Запрашивайте новые учетные данные для оригинальной работающей сессии после истечения срока.
- Логируйте очищенные фазы и коды состояния. Держите ключи API, токены с коротким сроком действия и полные подписанные URL в секрете.
Почему аутентификация CDP терпит неудачу в удаленном браузере?
Аутентификация CDP терпит неудачу, когда клиент не может авторизовать свое соединение с предполагаемым браузером. Похожие ошибки могут возникать ранее в рабочем процессе, включая выбор неправильного рабочего пространства или попытку создать учетные данные для завершенной сессии. Определите первый запрос, который потерпел неудачу, прежде чем менять учетные данные или запускать другой браузер. Nstdata Cloud Browser.
Рабочий использует бизнес API для инспекции сессии и запроса учетных данных автоматизации. Клиент браузера использует эти временные учетные данные для соединения с Chromium. Эти вызовы имеют разные назначения, заголовки и условия успеха. Шлюз WebSocket может быть доступен, но отклонять авторизацию. Рабочий также может подключиться и оказаться на неправильной вкладке. Эта ошибка в дальнейшем относится к выбору страницы и проверке задания. См. руководство по подключению Playwright CDP.
Какие учетные данные принадлежат какому запросу?
Используйте бизнес-ключ для HTTP-запросов Cloud Browser, созданные учетные данные автоматизации для CDP и собственный вход в приложение на его авторизованной странице. Поддерживайте согласованность выбора рабочего пространства на протяжении всех вызовов бизнес API.
| Операция | Учетные данные или поле | Сигнал для продолжения |
|---|---|---|
| Инспекция сессии | x-api-key и применимый контекст команды | Оригинальный ID сессии разрешен |
| Выпуск учетных данных автоматизации | Тот же бизнес-ключ и контекст команды | Возвращенные учетные данные принадлежат этой сессии и имеют текущий срок действия |
| Подключение к Chromium | Возвращенный URL CDP и заголовок | Клиент получает ожидаемый контекст браузера |
| Доступ к приложению | Утвержденная тестовая учетная запись или сессия приложения | Приложение подтверждает предполагаемую личность и состояние задания |
Получите личный ключ в Настройки → Учетная запись и ключ члена команды в Члены. Ключ члена команды выбирает его связанную команду. Личный ключ может использовать необязательный x-team-id для присоединенной команды. Уберите заголовок команды для личного рабочего пространства. Храните учетные данные в вашем одобренном секретном хранилище и связывайте каждую задачу с ее рабочим пространством. Конфигурация учетных данных Cloud Browser.
Playwright использует chromium.connectOverCDP() для подключения к Chromium через CDP. Сервер браузера Playwright говорит на протоколе Playwright и использует другой метод соединения. API BrowserType описывает оба метода. Puppeteer также поддерживает конечную точку и заголовки соединения. Puppeteer ConnectOptions.
Как определить, какой запрос потерпел неудачу?
Сначала выполните поиск сессии, выпустите новые учетные данные для этой готовой сессии и попытайтесь подключиться. Это даст полезную фазу ошибки, сохраняя токены доступа в секрете.
Шаг 1. Определите оригинальную сессию
Используйте ID сессии из записи работы или откройте Cloud Browser → Session History и выберите известный запуск в его рабочем пространстве. Если у вас есть только ID запроса на создание, сопоставьте оригинальную попытку создания перед запуском другого браузера. См. управление жизненным циклом сессии.
Шаг 2. Инспекция API сессии
Сделайте GET /api/v1/cloud-browser/sessions/{sessionId} с сырым бизнес-ключом и необязательным выбором команды. Просмотрите data.state. Состояние creating или stopping меняет следующее действие. Для остановленной сессии определите, почему она завершилась и нужна ли другая сессия для новой задачи.
Шаг 3. Выпустите и проверьте учетные данные
Отправьте POST /api/v1/cloud-browser/sessions/{sessionId}/automation-credentials. Проверьте поля ответа sessionId, cdpUrl, headerName, accessToken и expiresAt. Постройте заголовок из возвращенных полей. Сохраните не секретный ID сессии в задаче, а не читайте старый токен из кэша многократно.
Шаг 4. Выполните ограниченное рукопожатие
Установите playwright-core@1.65.1 с помощью npm и используйте Node.js 22.12 или новее. Сохраните два модуля ниже. Установите NSTDATA_API_KEY, NSTDATA_SESSION_ID и опционально NSTDATA_TEAM_ID в среду. Запустите node auth.mjs в той же директории. Управляемая часть требует вашего ключа и готовой сессии. Подтвердите подключение, поддерживаемое аккаунтом, в вашем пространстве.
Сохраните cloud-api.mjs.
const root = 'https://api.nstdata.io/api/v1/cloud-browser'; export async function api(method, path, body) { const key = process.env.NSTDATA_API_KEY; if (
Сохраните auth.mjs.
import { chromium } from 'playwright-core'; import { connection } from './cloud-api.mjs'; let phase = 'session lookup and credential issue'; let browser; try {
Успешный зонд выводит флаг соединения и количество контекстов. Сопоставьте это с утверждением страницы, если вы диагностируете задачу. Закройте клиент и позвольте владельцу остановить управляемый браузер. Если расследование само управляет сессией, используйте Stop Browser и подтвердите, что сессия завершилась.
Что говорят вам ошибки HTTP и WebSocket?
Ошибка HTTP от API сессии касается запроса сервиса. Ошибка WebSocket касается передачи браузера. Статус, полученный от целевого приложения после подключения, касается приложения. Пометьте каждую ошибку шагом, на котором она произошла.
| Первое неудачное наблюдение | Область для проверки | Следующее действие |
|---|---|---|
| API сообщает 401, 403 или 470 | Бизнес-ключ, область или рабочее пространство | Подтвердите тип ключа, разрешения и команду |
| API сообщает 409 | Конфликт состояния операции или сессии | Проверьте существующую сессию и параметры создания |
| API сообщает 410 | Истечение ресурса | Найдите оригинальную сессию перед получением учетных данных |
| WebSocket сообщает 401 или 403 | Учетные данные автоматизации или политика шлюза | Проверьте построение заголовков, срок действия и предполагаемую сессию |
| Тайм-аут рукопожатия WebSocket | Сетевая трасса или доступность сессии | Подтвердите рабочее состояние и безопасный доступ WebSocket от рабочего процесса |
| Целевое приложение открывает неожиданную страницу входа | Аутентификация приложения или выбор страницы | Подтвердите одобренный вход и ожидаемую вкладку |
| Прокси или балансировщик нагрузки на исходящем пути рабочего может обрабатывать WebSockets иначе, чем HTTPS. Воспроизведите с рабочего, который не удался. Сравните временные метки для выдачи учетных данных, попытки подключения и отключения. Если учетные данные истекли до использования, запросите их ближе к прикреплению. Если часы расстроены, откорректируйте часы и повторно протестируйте. |
Проблемы с аутентификацией обычно требуют изменения условий, прежде чем повторная попытка может помочь. Повторный запрос с тем же неверным ключом только добавляет шум. Ждите создания сессии или запрашивайте свежий токен для той же готовой сессии, когда это уместно. Уважайте явный ответ ограничений по скорости, следуя указаниям службы и семантике HTTP 429.
Как выглядит инцидент подключения со стороны рабочего?
Инцидент подключения становится легче диагностировать, когда рабочий сохраняет результаты для каждой фазы. Представьте, что демонстрационное рабочее пространство сообщает о готовом браузере, затем рабочий получает HTTP 403 во время выдачи учетных данных. Браузер никогда не видел попытки подключения CDP. Сравните рабочее пространство, распознанное при поиске, с тем, которое использовалось при вызове учетных данных. Если ключ члена команды привязан к рабочему пространству сессии, используйте ту же личность для обоих запросов. Для личного ключа подтвердите, что оба вызова содержат тот же выбор авторизованной команды.
Теперь рассмотрим готовую сессию и успешный ответ по учетным данным, за которым следует тайм-аут WebSocket. Проверьте исходящий сетевой путь рабочего и срок действия токена. Если конечная точка может быть достигнута вторым правильно настроенным рабочим в той же среде, сравните прокси и конфигурацию библиотеки первого рабочего. Избегайте публикации URL в рамках этого сравнения. Храните отдельный таймер для ожидания готовности сессии, выдачи токена и подключения WebSocket, чтобы следующий инцидент точно сообщил, где было потрачено время.
Как Nstdata Cloud Browser вписывается в рабочий процесс подключения в продакшне?
Nstdata Cloud Browser предоставляет управляемую инфраструктуру браузера для автоматизации и ИИ-агентов, с безопасным подключением CDP и отдельным API сессий. Рабочие могут подключаться к своему целевому браузеру, пока оператор его инспектирует в режиме Live View. Браузер может использовать встроенную маршрутизацию сети, настроенную при запуске. Приложение должно поддерживать надежное соответствие от бизнес-задачи к управляемой сессии. Это соответствие дает инженерам отправную точку, когда аутентификация или задача не удалась.
- Поиск сессии. Подтвердите состояние рабочего пространства и браузера перед повторной попыткой подключения.
- Временные учетные данные CDP. Запросите токен доступа для выбранной готовой сессии и ограничьте его область до пути прикрепления.
- Живое инспектирование. Проверьте страницу браузера, когда транспорт успешен, но рабочий процесс все еще не удался. Используйте руководство по отладке автоматизации браузера для корреляции доказательств страницы с ошибкой рабочего.
Что должно быть в записи инцидента подключения?
Запись инцидента подключения должна содержать идентификаторы задачи и сессии, ссылку на рабочее пространство, неудавшуюся фазу, время, очищенный статус и результат завершения. Включите короткие инструкции по воспроизведению и версию пакета клиента. Сохраните только детали ошибки, необходимые для диагностики транспорта или разрешений. Никогда не вставляйте полный подписанный конечный пункт в тикет или не включайте ответ учетных данных в артефакт CI.
FAQ
Q: Может ли бизнес API ключ авторизовать CDP WebSocket напрямую? Используйте выданные для этой сессии краткосрочные учетные данные автоматизации. Бизнес-ключ аутентифицирует HTTP-запросы жизненного цикла.
Q: Почему панель управления может видеть сессию, в то время как рабочий получает 403? Панель управления и рабочий могут действовать с разными личностями и выборами рабочих пространств. Подтвердите, что ключ рабочего имеет доступ к рабочему пространству сессии.
Q: Что подтверждает успешный поиск сессии? Он подтверждает, что запрос службы мог прочитать сессию. Готовность браузера, авторизация CDP и успешное завершение задачи на сайте имеют свои собственные проверки.
Q: Могу ли я повторно использовать детали подключения после отключения? Проверьте оригинальную сессию. Если она остается готовой, запросите свежие данные и используйте новый конечный пункт и заголовок.
Q: Останавливает ли отключение Playwright управляемую сессию?
Завершите сессию через владеющий рабочий процесс и дождитесь ended. Отключение клиента оставляет очистку жизненного цикла владельцу.





