Kiểm tra URL callback của Cams cục bộ bằng ngrok
Trước khi đưa tích hợp của bạn lên môi trường production, bạn có thể kiểm tra các callback của Cams API trực tiếp trên máy phát triển bằng một công cụ tunneling. Hướng dẫn này sẽ hướng dẫn bạn thiết lập theo từng bước.
Vì sao bạn cần tunnel
Các yêu cầu callback và webhook được gửi từ nền tảng Cams qua internet. Ứng dụng cục bộ chạy trên máy của bạn không thể nhận trực tiếp các yêu cầu này vì nằm sau tường lửa hoặc mạng NAT.
Dịch vụ tunneling tạo ra một endpoint công khai an toàn, chuyển tiếp các yêu cầu đến tới ứng dụng cục bộ của bạn.
Lợi ích
- Kiểm tra callback trước khi triển khai
- Gỡ lỗi payload của webhook theo thời gian thực
- Xác thực cách xử lý yêu cầu trên máy cục bộ
- Giảm thời gian phát triển và triển khai
Các công cụ tunneling được khuyến nghị

Thiết lập ngrok (khuyến nghị)
Cài đặt
- Truy cập https://ngrok.com
- Tải phiên bản phù hợp với hệ điều hành của bạn.
- Giải nén và cài đặt tệp thực thi.
- Tạo tài khoản miễn phí (không bắt buộc nhưng được khuyến nghị).
- Tạo AuthToken.
- Cấu hình AuthToken của bạn.
ngrok config add-authtoken YOUR_AUTHTOKEN
Khởi động tunnel
Nếu ngrok đã được cấu hình:
ngrok http 3000
Thay 3000 bằng cổng của ứng dụng của bạn.
Ví dụ kết quả đầu ra
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Ứng dụng của bạn hiện có thể truy cập qua URL HTTPS công khai.
Phương án thay thế: Sử dụng công cụ kiểm tra callback của Cams
Bạn cũng có thể sử dụng tiện ích kiểm tra callback do Cams cung cấp.
- Cài đặt và giải nén công cụ theo liên kết sau.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar - Chỉnh sửa tệp
app.properties. - Cấu hình:
ngrok.auth.token=
ngrok.tunnel.url= - Chạy:
check_ngrok.bat
Tiện ích sẽ tự động thiết lập tunnel và đơn giản hóa việc kiểm tra callback cục bộ.
Thiết lập tích hợp callback
Bước 1: Khởi động ứng dụng cục bộ của bạn
Bước 2: Khởi động tunnel
Bước 3: Kiểm tra callback
Kích hoạt một sự kiện kiểm tra mẫu và xác minh các nội dung sau:
- Ứng dụng của bạn nhận được yêu cầu callback.
- Payload của yêu cầu được xử lý thành công.
- Không có lỗi nào xuất hiện trong nhật ký ứng dụng.
- Các yêu cầu hiển thị trên bảng điều khiển của tunnel.
Thực hành tốt nhất
- Sử dụng URL callback HTTPS whenever possible.
- Giữ tunnel hoạt động trong suốt quá trình kiểm tra.
- Xem lại nhật ký ứng dụng để kiểm tra xác thực yêu cầu.
- Xác minh rằng endpoint của bạn trả về đúng mã phản hồi HTTP mong đợi.
- Kiểm tra các tình huống xử lý lỗi trước khi chuyển sang production.
Lưu ý quan trọng
- URL ngrok miễn phí sẽ thay đổi mỗi khi tunnel khởi động lại.
- Các gói ngrok trả phí hỗ trợ tên miền dành riêng và subdomain tùy chỉnh.
- Tunnel tạm thời chỉ nên được sử dụng cho mục đích phát triển và kiểm thử.
Kết luận
Đưa máy chủ cục bộ của bạn ra ngoài qua dịch vụ tunneling là cách nhanh nhất để kiểm tra URL callback trước khi triển khai ứng dụng. Dù bạn sử dụng ngrok, Cloudflare Tunnel hay localhost.run, quy trình này cho phép bạn nhận các yêu cầu callback theo thời gian thực và xác thực tích hợp trong môi trường phát triển cục bộ.
Thực hiện theo các bước trên sẽ giúp đảm bảo quá trình chuyển từ phát triển sang triển khai production diễn ra suôn sẻ.