TL;DR
- Chẩn đoán xác thực CDP tại giai đoạn thất bại đầu tiên: tìm API kinh doanh, vấn đề về thông tin xác thực, hoặc bắt tay WebSocket.
- Gửi khóa API kinh doanh Nstdata dưới dạng
x-api-keycho các yêu cầu HTTP phiên. Bao gồmx-team-idkhi chọn một đội tham gia với khóa cá nhân. - Xác minh rằng phiên gốc là
readytrước khi yêu cầu một thông tin xác thực tự động tạm thời. - Xây dựng tiêu đề WebSocket từ
headerNamevàaccessTokenđã trả về. Tiền tố Bearer chỉ choAuthorization. - Yêu cầu thông tin xác thực mới cho phiên chạy gốc sau khi hết hạn.
- Ghi lại các giai đoạn đã được làm sạch và mã trạng thái. Giữ cho các khóa API, token ngắn hạn và URL đã ký hoàn chỉnh ở chế độ riêng tư.
Tại sao xác thực CDP thất bại trên trình duyệt từ xa?
Xác thực CDP thất bại khi khách hàng không thể cấp phép kết nối của mình đến trình duyệt mong muốn. Các lỗi tương tự có thể phát sinh sớm hơn trong quy trình làm việc, bao gồm việc chọn sai không gian làm việc hoặc cố gắng phát hành thông tin xác thực cho một phiên đã kết thúc. Xác định yêu cầu đầu tiên bị thất bại trước khi xoay vòng thông tin xác thực hoặc bắt đầu một trình duyệt khác. Trình duyệt Đám mây Nstdata.
Một nhân viên sử dụng API kinh doanh để kiểm tra một phiên và yêu cầu một thông tin xác thực tự động. Khách hàng trình duyệt sử dụng thông tin xác thực tạm thời đó để kết nối với Chromium. Những cuộc gọi đó có điểm đến khác nhau, tiêu đề và điều kiện thành công khác nhau. Một cổng WebSocket có thể có thể truy cập trong khi từ chối cấp phép. Một nhân viên cũng có thể kết nối và hạ cánh trên tab sai. Lỗi sau đó thuộc về việc chọn trang và xác thực tác vụ. Xem hướng dẫn kết nối CDP Playwright.
Thông tin xác thực nào thuộc về yêu cầu nào?
Sử dụng khóa kinh doanh cho các yêu cầu HTTP của Trình duyệt Đám mây, thông tin xác thực tự động đã phát hành cho CDP, và việc đăng nhập của ứng dụng trong trang đã được ủy quyền của nó. Giữ cho lựa chọn không gian làm việc nhất quán trong suốt các cuộc gọi API kinh doanh.
| Hoạt động | Thông tin xác thực hoặc trường | Tín hiệu để tiếp tục |
|---|---|---|
| Kiểm tra một phiên | x-api-key và ngữ cảnh đội thích hợp | ID phiên gốc được giải quyết |
| Phát hành thông tin xác thực tự động | Khóa kinh doanh tương tự và ngữ cảnh đội | Thông tin xác thực đã trả về thuộc về phiên đó và có một thời hạn hiện tại |
| Kết nối với Chromium | URL CDP đã trả về và tiêu đề | Khách hàng nhận được ngữ cảnh trình duyệt như mong đợi |
| Truy cập ứng dụng | Tài khoản kiểm tra được chấp thuận hoặc phiên ứng dụng | Ứng dụng xác nhận danh tính và trạng thái tác vụ mong muốn |
Lấy một khóa cá nhân từ Cài đặt → Tài khoản và một khóa thành viên đội từ Thành viên. Một khóa thành viên đội chọn đội của mình. Một khóa cá nhân có thể sử dụng x-team-id tùy chọn cho một đội tham gia. Bỏ qua tiêu đề đội cho một không gian làm việc cá nhân. Giữ thông tin xác thực trong kho bảo mật đã được chấp thuận của bạn và liên kết mỗi công việc với không gian làm việc của nó. Cấu hình thông tin xác thực Trình duyệt Đám mây.
Playwright sử dụng chromium.connectOverCDP() để kết nối với Chromium qua CDP. Một máy chủ trình duyệt Playwright sử dụng giao thức Playwright và sử dụng một phương thức kết nối khác. API BrowserType mô tả cả hai phương pháp. Puppeteer cũng hỗ trợ một điểm cuối và tiêu đề kết nối. Puppeteer ConnectOptions.
Làm thế nào bạn xác định yêu cầu nào đã thất bại?
Chạy tra cứu phiên đầu tiên, phát hành một thông tin xác thực mới cho phiên sẵn sàng đó, và cố gắng một kết nối. Điều này tạo ra một giai đoạn lỗi hữu ích trong khi giữ cho các token truy cập được bảo mật.
Bước 1. Xác định phiên gốc
Sử dụng ID phiên từ hồ sơ công việc hoặc mở Cloud Browser → Session History và chọn phiên đã biết trong không gian làm việc của nó. Nếu bạn chỉ có một ID yêu cầu tạo, đối chiếu nỗ lực tạo gốc trước khi bắt đầu một trình duyệt khác. Xem quản lý vòng đời phiên.
Bước 2. Kiểm tra API phiên
Thực hiện GET /api/v1/cloud-browser/sessions/{sessionId} với khóa kinh doanh thô và lựa chọn đội tùy chọn. Kiểm tra data.state. Một trạng thái creating hoặc stopping thay đổi hành động tiếp theo. Đối với một phiên đã dừng, xác định lý do tại sao nó kết thúc và liệu một phiên khác có cần thiết cho một tác vụ mới hay không.
Bước 3. Phát hành và xác thực một thông tin xác thực
Gửi POST /api/v1/cloud-browser/sessions/{sessionId}/automation-credentials. Xác minh các trường phản hồi sessionId, cdpUrl, headerName, accessToken, và expiresAt. Tạo tiêu đề từ các trường đã trả về. Lưu ID phiên không bí mật trong công việc thay vì liên tục đọc một token cũ từ bộ nhớ đệm.
Bước 4. Chạy một bắt tay có giới hạn
Cài đặt playwright-core@1.65.1 với npm và sử dụng Node.js phiên bản 22.12 hoặc mới hơn. Lưu hai mô-đun dưới đây. Thiết lập NSTDATA_API_KEY, NSTDATA_SESSION_ID, và tùy chọn NSTDATA_TEAM_ID trong môi trường. Chạy node auth.mjs trong cùng một thư mục. Phần quản lý yêu cầu khóa của bạn và một phiên sẵn sàng. Xác nhận việc bắt tay được hỗ trợ tài khoản trong không gian làm việc của bạn.
Lưu 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 (!key) throw new Error('Set NSTDATA_API_KEY'); const headers = { 'x-api-key': key }; if (process.env.NSTDATA_TEAM_ID) headers['x-team-id'] = process.env.NSTDATA_TEAM_ID; if (body) headers['content-type'] = 'application/json'; let response; try { response = await fetch(root + path, { method, headers, redirect: 'error', body: body ? JSON.stringify(body) : undefined, signal: AbortSignal.timeout(20_000), }); } catch { throw Object.assign(new Error('API transport failed; reconcile the original operation'), { retryable: true }); } const retryable = response.status === 429 || response.status >= 500; let result; try { result = await response.json(); } catch { throw Object.assign(new Error('Invalid API JSON'), { retryable }); } if (!response.ok || result.err === true || result.success === false) { throw Object.assign(new Error(`Cloud Browser API HTTP ${response.status}`), { retryable }); } if (!result.data) throw new Error('Missing API data'); return result.data; } export async function connection(id) { if (!id) throw new Error('Set NSTDATA_SESSION_ID'); const path = `/sessions/${encodeURIComponent(id)}`; const session = await api('GET', path); if (session.state !== 'ready') throw new Error(`Session is ${session.state}, not ready`); const c = await api('POST', path + '/automation-credentials'); if (c.sessionId !== id || !c.headerName || !c.accessToken || !(Date.parse(c.expiresAt) > Date.now()) || new URL(c.cdpUrl).protocol !== 'wss:') { throw new Error('Invalid or expired CDP credentials'); } return { endpoint: c.cdpUrl, headers: { [c.headerName]: c.headerName.toLowerCase() === 'authorization' ? `Bearer ${c.accessToken}` : c.accessToken }, }; } export async function endpoint() { // An isolated local CDP endpoint can test the client without managed credentials. if (process.env.LOCAL_CDP_URL) { const url = new URL(process.env.LOCAL_CDP_URL); if (!['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)) { throw new Error('LOCAL_CDP_URL must use loopback'); } return { endpoint: url.href, headers: {} }; } return connection(process.env.NSTDATA_SESSION_ID); }
Lưu auth.mjs.
import { chromium } from 'playwright-core'; import { connection } from './cloud-api.mjs'; let phase = 'session lookup and credential issue'; let browser; try { const credentials = await connection(process.env.NSTDATA_SESSION_ID); phase = 'WebSocket connection'; browser = await chromium.connectOverCDP(credentials.endpoint, { headers: credentials.headers, timeout: 15_000, }); console.log(JSON.stringify({ connected: true, contexts: browser.contexts().length })); } catch { console.error('Check failed during ' + phase); process.exitCode = 1; } finally { await browser?.close(); }
Một cuộc kiểm tra thành công in ra cờ kết nối và số lượng ngữ cảnh. Kết hợp điều đó với một xác nhận trang nếu bạn đang chẩn đoán một tác vụ. Đóng khách hàng, và để chủ sở hữu dừng trình duyệt được quản lý. Nếu cuộc điều tra bản thân sở hữu phiên, hãy sử dụng Stop Browser và xác nhận rằng phiên đã kết thúc.
Lỗi HTTP và WebSocket mỗi cái đều cho bạn biết điều gì?
Lỗi HTTP từ API phiên liên quan đến yêu cầu dịch vụ. Lỗi WebSocket liên quan đến việc vận chuyển trình duyệt. Một trạng thái nhận được từ ứng dụng mục tiêu sau khi kết nối liên quan đến ứng dụng. Ghi nhãn từng lỗi với bước mà nó xảy ra.
| Quan sát thất bại đầu tiên | Khu vực kiểm tra | Hành động tiếp theo |
|---|---|---|
| API báo cáo 401, 403, hoặc 470 | Khóa doanh nghiệp, phạm vi, hoặc không gian làm việc | Xác nhận loại khóa, quyền hạn, và nhóm |
| API báo cáo 409 | Xung đột trạng thái hoạt động hoặc phiên | Kiểm tra phiên hiện tại và tham số tạo |
| API báo cáo 410 | Hết hạn tài nguyên | Tìm kiếm phiên ban đầu trước khi cấp phát thông tin xác thực |
| WebSocket báo cáo 401 hoặc 403 | Thông tin xác thực tự động hóa hoặc chính sách cổng | Kiểm tra cấu trúc tiêu đề, hết hạn, và phiên dự kiến |
| WebSocket bắt tay hết thời gian | Đường dẫn mạng hoặc sự sẵn có của phiên | Xác nhận trạng thái đang chạy và truy cập WebSocket an toàn từ tác nhân |
| Mục tiêu mở một trang đăng nhập không mong đợi | Xác thực ứng dụng hoặc lựa chọn trang | Xác nhận đăng nhập được phê duyệt và tab dự kiến |
| Một proxy hoặc load balancer trên đường ra của worker có thể xử lý WebSockets khác với HTTPS. Tái tạo từ worker đã thất bại. So sánh các dấu thời gian cho vấn đề xác thực, cố gắng kết nối và ngắt kết nối. Nếu xác thực hết hạn trước khi sử dụng, yêu cầu nó gần hơn với việc kết nối. Nếu đồng hồ bị lệch, hãy điều chỉnh đồng hồ và kiểm tra lại. |
Các vấn đề xác thực thường yêu cầu một điều kiện đã thay đổi trước khi một lần thử lại có thể giúp ích. Một yêu cầu lặp lại với cùng một khóa sai chỉ thêm nhiễu. Chờ một phiên đang được tạo hoặc yêu cầu một token mới cho phiên đã sẵn sàng khi thích hợp. Tôn trọng phản hồi giới hạn tần suất rõ ràng bằng cách làm theo hướng dẫn dịch vụ và ngữ nghĩa HTTP 429.
Một sự cố kết nối trông như thế nào từ phía worker?
Một sự cố kết nối trở nên dễ chẩn đoán hơn khi worker lưu giữ kết quả cho mỗi giai đoạn. Hãy tưởng tượng rằng một không gian làm việc demo báo cáo một trình duyệt đã sẵn sàng, sau đó worker nhận được HTTP 403 trong quá trình phát hành xác thực. Trình duyệt chưa bao giờ thấy một nỗ lực kết nối CDP. So sánh không gian làm việc được nhận dạng tại tìm kiếm với không gian làm việc được sử dụng bởi cuộc gọi xác thực. Nếu một khóa thành viên nhóm được ràng buộc với không gian làm việc của phiên, hãy sử dụng cùng một danh tính cho cả hai yêu cầu. Đối với một khóa cá nhân, xác nhận rằng cả hai cuộc gọi đều mang cùng một lựa chọn nhóm được ủy quyền.
Bây giờ hãy xem xét một phiên đã sẵn sàng và một phản hồi xác thực thành công tiếp theo là một thời gian chờ WebSocket. Kiểm tra đường mạng ra của worker và thời gian hết hạn của token. Nếu điểm cuối có thể được truy cập bởi một worker thứ hai được cấu hình đúng trong cùng một môi trường, hãy so sánh cấu hình proxy và thư viện của worker đầu tiên. Tránh công bố URL như một phần của sự so sánh này. Giữ một bộ đếm thời gian riêng cho việc chờ đợi sự sẵn sàng của phiên, phát hành token và kết nối WebSocket để sự cố tiếp theo cho bạn biết chính xác thời gian đã được dành cho đâu.
Nstdata Cloud Browser phù hợp với quy trình kết nối sản xuất như thế nào?
Nstdata Cloud Browser cung cấp cơ sở hạ tầng trình duyệt được quản lý cho tự động hóa và các tác nhân AI, với kết nối CDP an toàn và một API phiên rõ ràng. Worker có thể kết nối với trình duyệt mà họ dự định trong khi một điều hành viên kiểm tra nó trong Live View. Trình duyệt có thể sử dụng định tuyến mạng tích hợp được cấu hình khi khởi động. Ứng dụng nên giữ một ánh xạ bền vững từ công việc kinh doanh đến phiên được quản lý. Ánh xạ đó cung cấp cho các kỹ sư một nơi để bắt đầu khi xác thực hoặc nhiệm vụ thất bại.
- Tra cứu phiên. Xác nhận không gian làm việc và trạng thái trình duyệt trước khi thử lại kết nối.
- Xác thực CDP tạm thời. Yêu cầu một token truy cập cho phiên đã sẵn sàng đã chọn và giữ nó trong phạm vi đường đính kèm.
- Kiểm tra trực tiếp. Kiểm tra trang trình duyệt khi vận chuyển thành công nhưng quy trình làm việc vẫn thất bại. Sử dụng hướng dẫn gỡ lỗi tự động hóa trình duyệt để tương quan chứng cứ trang với lỗi của worker.
Những gì thuộc về hồ sơ sự cố kết nối?
Hồ sơ sự cố kết nối nên chứa ID công việc và phiên, tham chiếu không gian làm việc, giai đoạn thất bại, thời gian, trạng thái đã được rửa sạch và kết quả ngắt kết nối. Bao gồm một hướng dẫn tái tạo ngắn gọn và phiên bản gói của khách hàng. Chỉ cần giữ lại các chi tiết lỗi cần thiết để chẩn đoán vận chuyển hoặc quyền. Không bao giờ dán một điểm cuối đã ký hoàn chỉnh vào vé hoặc bao gồm phản hồi xác thực trong một hiện vật CI.
FAQ
Q: Có thể khóa API doanh nghiệp ủy quyền kết nối CDP WebSocket trực tiếp không? Sử dụng khóa xác thực ngắn hạn được phát hành cho phiên đó. Khóa doanh nghiệp xác thực các yêu cầu HTTP vòng đời.
Q: Tại sao bảng điều khiển có thể thấy một phiên trong khi worker nhận 403? Bảng điều khiển và worker có thể hoạt động với các danh tính và lựa chọn không gian làm việc khác nhau. Xác nhận rằng khóa của worker có quyền truy cập vào không gian làm việc của phiên.
Q: Một tra cứu phiên thành công chứng minh điều gì? Nó chứng minh rằng yêu cầu dịch vụ có thể đọc một phiên. Tính sẵn sàng của trình duyệt, ủy quyền CDP và việc hoàn thành thành công một tác vụ trang web có các kiểm tra riêng của chúng.
Q: Tôi có thể tái sử dụng chi tiết kết nối sau khi ngắt kết nối không? Kiểm tra phiên gốc. Nếu nó vẫn sẵn sàng, yêu cầu chi tiết mới và sử dụng điểm cuối và tiêu đề mới.
Q: Việc ngắt kết nối Playwright có dừng phiên đã quản lý không?
Kết thúc phiên thông qua quy trình sở hữu và chờ ended. Một kết nối khách hàng ngắt bỏ việc dọn dẹp vòng đời cho chủ sở hữu.





