Xuất bản dự án của bạn

Nếu nút Publish hoặc Update hiển thị "Your Cloud Balance is insufficient to publish" hoặc "Your Cloud Balance is insufficient to update," ví Cloud của bạn đã hết tiền.

Để khắc phục:

1. Vào Settings > Cloud & AI để kiểm tra số dư hiện tại của bạn.

2. Chọn Top up now và thêm tiền vào ví Cloud của bạn.

3. Quay lại bảng Publish và thử lại.

Lưu ý: Ví Cloud của bạn tách biệt với tín dụng gói đăng ký. Ví Cloud dùng để chi trả cho dịch vụ lưu trữ và triển khai, trong khi tín dụng gói đăng ký được dùng cho các cuộc trò chuyện với agent AI.

1. Kiểm tra chế độ xem mức sử dụng bộ nhớ và xác định các cuộc trò chuyện, dự án và tệp lớn nhất.
2. Tải xuống hoặc sao lưu mọi thứ bạn có thể cần sau này.
3. Chỉ xóa những mục không cần thiết. Nếu việc xóa cuộc trò chuyện có tùy chọn xóa dữ liệu đĩa liên quan, chỉ chọn tùy chọn đó sau khi xác nhận dữ liệu có thể được loại bỏ an toàn.
4. Làm mới trang và xác nhận rằng dung lượng khả dụng đã tăng.
5. Quay lại Publish và thử lại một lần.

Việc xóa có thể là vĩnh viễn và có thể làm hỏng một dự án đang tham chiếu đến tệp đã bị xóa. Nếu mức sử dụng không giảm, hãy liên hệ Support kèm theo chế độ xem bộ nhớ, gói, liên kết dự án và thời điểm xuất bản thất bại.

Hãy chờ quét bảo mật hoàn tất, sau đó xem lại từng mục bị gắn cờ trước khi xuất bản.

1. Chọn Resolve All và kiểm tra hành vi bị ảnh hưởng. Hãy khắc phục các vấn đề liên quan đến bí mật bị lộ, xác thực, quyền hạn, dữ liệu người dùng hoặc truy cập bên ngoài không an toàn trước khi dùng trong môi trường production.
2. Nếu một bí mật có thể đã bị lộ, hãy xóa nó khỏi dự án và thay mới nó thông qua nhà cung cấp liên quan trước khi xuất bản.
3. Chạy lại quá trình quét và xác minh luồng bị ảnh hưởng.
4. Chỉ dùng Publish Anyway khi một người chịu trách nhiệm đã hiểu và chấp nhận rủi ro còn lại, không nghiêm trọng. Ghi lại lý do và tránh bỏ qua rủi ro chưa được giải quyết trên trang production.

Nếu bạn không thể xác định tác động của một phát hiện, đừng xuất bản. Hãy liên hệ Support hoặc người phụ trách bảo mật của bạn kèm theo nội dung phát hiện và bằng chứng đã được ẩn thông tin nhạy cảm.

1. Kiểm tra riêng URL production của nền tảng và miền tùy chỉnh. Đồng thời so sánh trang gốc với trang cụ thể hoặc đường dẫn API bị lỗi.
2. Ghi lại chính xác mã trạng thái, URL đầy đủ, thời gian và múi giờ, cũng như việc lỗi xảy ra liên tục hay gián đoạn.
3. Kiểm tra trạng thái triển khai mới nhất và xem liệu thay đổi gần đây về dependency, biến môi trường, cơ sở dữ liệu hoặc dịch vụ bên ngoài có trùng với thời điểm lỗi bắt đầu hay không.
4. Ghi lại các lỗi Console và Network liên quan.

Nếu lỗi vẫn tiếp diễn, hãy liên hệ Support kèm theo các bước tái hiện, phiên bản bị ảnh hưởng và chẩn đoán đã được ẩn thông tin nhạy cảm. Trước khi gửi HAR, đầu ra lệnh hoặc ảnh chụp màn hình, hãy xóa cookie, header Authorization, token, tham số truy vấn bí mật, dữ liệu cá nhân và thông tin thanh toán.

Nếu việc triển khai của bạn bị hết thời gian hoặc trang đang hoạt động tạm thời không khả dụng:

1. Kiểm tra xem cả tên miền phụ Prod của nền tảng và Preview đều không truy cập được, hay chỉ một trong hai.

2. Giữ nguyên trang lỗi hiện tại — đừng liên tục nhấp vào Publish.

3. Kiểm tra xem gần đây bạn có sửa đổi dependency, điểm vào khởi động hoặc kết nối cơ sở dữ liệu không, vì những thay đổi này có thể ảnh hưởng đến việc triển khai.

Nếu sự cố vẫn tiếp diễn, hãy liên hệ Support và cung cấp:

- Liên kết dự án và URL đang hoạt động

- Thời điểm lỗi xảy ra và múi giờ của bạn

- Số phiên bản và ảnh chụp màn hình trang lỗi

- Preview có hoạt động bình thường hay không

- Bạn có недавно sửa đổi dependency, mục khởi động hoặc kết nối cơ sở dữ liệu hay không

Nếu bảng Publish hiển thị "latest" với nút bị làm mờ hoặc bị kẹt ở trạng thái "Building":

1. Đừng liên tục nhấp vào Publish — việc này sẽ không làm nhanh hơn và có thể tạo các tác vụ build trùng lặp.

2. Chờ vài phút rồi làm mới trang.

3. Nếu trạng thái không thay đổi sau khi làm mới, hãy liên hệ Support.

Khi liên hệ Support, hãy cung cấp những thông tin sau:

- Liên kết chat

- Ảnh chụp màn hình đầy đủ của bảng Publish (bao gồm URL trang, số phiên bản và trạng thái nút)

- Thời điểm xảy ra và múi giờ của bạn

- Số phiên bản hiện đang hiển thị

- Ở bước nào nó bắt đầu hiển thị "Building" hoặc nút bị làm mờ

1. Kiểm tra xem hình ảnh bị thiếu trong Trình xem App, trên trang đã xuất bản hay ở cả hai nơi.
2. Chọn Reload App Viewer một lần. Nếu sự cố chỉ xảy ra trên trang đang hoạt động, hãy xác nhận rằng phiên bản mới nhất đã được xuất bản hoặc cập nhật.
3. Cho Agent biết trang, hình ảnh đáng lẽ phải xuất hiện và nguồn gốc ban đầu của hình ảnh. Yêu cầu Agent kiểm tra rằng dự án hiện tại vẫn đang sử dụng đúng tên và vị trí hình ảnh.
4. Nếu hình ảnh gốc đã bị xóa hoặc đổi tên, hãy tải lên hoặc chọn lại hình ảnh mong muốn, sau đó kiểm tra lại trang.
5. Nếu hình ảnh sử dụng Lưu trữ App hoặc dịch vụ được kết nối khác, hãy xác nhận rằng dịch vụ dự định dùng đã được kết nối và tệp vẫn còn tồn tại ở đó.

Nếu hình ảnh vẫn không tải, hãy liên hệ Atoms Support kèm theo Chat Link, URL trang bị ảnh hưởng, tên hoặc nguồn hình ảnh và ảnh chụp màn hình. Không bao gồm liên kết truy cập riêng tư, mật khẩu, khóa hoặc token.

Nếu gói tự lưu trữ đã export tải xuống thành công nhưng không chạy được:

1. Kiểm tra README đi kèm trong gói export để biết các yêu cầu môi trường và các bước thiết lập.

2. Xác minh rằng môi trường chạy của bạn khớp với các yêu cầu (phiên bản OS, phiên bản Docker, phiên bản Node.js).

3. Chạy lệnh khởi động và xem lại toàn bộ đầu ra để tìm thông báo lỗi.

Nếu sự cố vẫn tiếp diễn, hãy liên hệ Support và cung cấp:

- Phiên bản export và thời gian tải xuống

- OS đang chạy và phiên bản Docker

- Lệnh đầy đủ đã chạy và toàn bộ đầu ra

- Script hoặc đường dẫn API bị lỗi

- Phương thức triển khai dự kiến

Quan trọng: Đính kèm một ví dụ cấu hình đã được ẩn thông tin nhạy cảm, nhưng KHÔNG bao gồm mật khẩu, bí mật hoặc token.

Trình xem App và trang đã xuất bản hiển thị các giai đoạn khác nhau của dự án. Việc lưu một thay đổi trực quan sẽ không tự động cập nhật trang đang hoạt động.

1. Trong Design, chọn Save và chờ tác vụ Agent hiện tại hoặc quá trình build hoàn tất.
2. Mở Publish. Việc xuất bản sử dụng phiên bản dự án mới nhất; không có bộ chọn phiên bản trong bảng Publish.
3. Chọn Publish cho lần phát hành đầu tiên hoặc Update cho lần phát hành sau. Chờ đến khi bảng hiển thị Up to date.
4. Mở trang đang hoạt động trong tab mới và tải lại một lần.
5. Nếu địa chỉ Atoms mặc định hiển thị thay đổi nhưng miền tùy chỉnh thì không, hãy kiểm tra kết nối miền thay vì liên tục xuất bản lại cùng một phiên bản.

Nếu trang đang hoạt động vẫn hiển thị sai phiên bản, hãy liên hệ Atoms Support kèm theo Chat Link, URL đang hoạt động, phiên bản bạn định xuất bản, thời gian và múi giờ, cùng ảnh chụp màn hình của Trình xem App và trang đang hoạt động.

1. Kiểm soát rủi ro ngay lập tức. Nếu bản phát hành làm lộ dữ liệu nhạy cảm hoặc tạo ra hành vi không an toàn, hãy mở App Status và dùng Pause cho app Atoms Cloud đủ điều kiện hoặc Unpublish để gỡ quyền truy cập công khai. Nếu không có rủi ro đang diễn ra, tránh gây gián đoạn không cần thiết.
2. Ghi lại miền bị ảnh hưởng, thời gian xuất bản, phiên bản hiện tại, phiên bản dự định và tác động kinh doanh.
3. Sau khi tác vụ agent hiện tại dừng lại, hãy mở Versions, chọn phiên bản tốt gần nhất đã biết và chọn Restore this version.
4. Xác minh phiên bản đã khôi phục trong Preview, bao gồm các luồng đăng nhập, thanh toán và dữ liệu quan trọng, rồi Publish hoặc Update phiên bản đó.

Việc khôi phục một phiên bản dự án có thể không đảo ngược các thay đổi cơ sở dữ liệu production hoặc các hành động bên ngoài. Đừng ghi đè hoặc xóa dữ liệu production để giả lập rollback. Hãy liên hệ Support ngay khi có liên quan đến dữ liệu, thông tin xác thực, thanh toán hoặc các thay đổi mang tính phá hủy.

1. Dừng hoặc chờ tác vụ agent hiện tại; không thể khôi phục phiên bản khi đang có công việc xung đột hoạt động.
2. Mở Versions, tìm phiên bản tốt gần nhất đã biết và chọn Restore this version.
3. Xem lại dự án đã khôi phục trong Preview và kiểm tra các luồng quan trọng đã thay đổi.
4. Chỉ Publish hoặc Update sau khi kết quả Preview là chính xác.

Việc khôi phục phiên bản dự án không nhất thiết sẽ rollback các bản ghi cơ sở dữ liệu production, thay đổi schema, biến môi trường, thanh toán, email hoặc các hành động bên ngoài khác. Nếu bản phát hành đã thay đổi dữ liệu production hoặc phiên bản mục tiêu không khả dụng, hãy dừng lại và liên hệ Support kèm theo cả hai số phiên bản, miền bị ảnh hưởng và kết quả bảo toàn dữ liệu cần thiết.

Pause và Unpublish là hai hành động khác nhau:

Pause (chỉ dành cho dự án Atoms Cloud):

- App sẽ không khả dụng với khách truy cập.

- Tài nguyên máy chủ vẫn được giữ và việc tính phí vẫn tiếp tục.

- Bạn có thể tiếp tục app bất kỳ lúc nào từ App Status.

Unpublish (mọi dự án):

- Trang web sẽ hoàn toàn ngoại tuyến. Bất kỳ ai dùng URL đã xuất bản sẽ mất quyền truy cập.

- Với các dự án Atoms Cloud, tài nguyên máy chủ sẽ được giải phóng.

- Bạn có thể xuất bản lại dự án sau, nhưng khách truy cập sẽ không thể truy cập cho đến khi bạn làm vậy.

Dùng Pause để gỡ tạm thời với khả năng khởi động lại nhanh. Dùng Unpublish để gỡ bỏ hoàn toàn trang web.

Nếu trình duyệt của bạn hiển thị "too many redirects" hoặc trang liên tục tải lại mà không hiển thị nội dung:

1. Hãy thử tên miền phụ Prod mặc định của nền tảng (không phải miền tùy chỉnh của bạn) để xác định xem vòng lặp chuyển hướng do cấu hình miền hay do chính ứng dụng gây ra.
2. Nếu tên miền phụ Prod mặc định hoạt động, hãy kiểm tra cài đặt DNS của miền tùy chỉnh và nhà đăng ký miền của bạn để tìm các quy tắc chuyển hướng có thể xung đột với nền tảng.
3. Xóa bộ nhớ đệm trình duyệt hoặc thử trong cửa sổ Ẩn danh để loại trừ các chuyển hướng đã được lưu trong bộ nhớ đệm.

Nếu sự cố vẫn tiếp diễn, hãy liên hệ Support và cung cấp:

- URL đầy đủ hiển thị vòng lặp chuyển hướng

- Tên miền phụ Prod mặc định có truy cập được hay không

- Tên miền và nhà cung cấp DNS

- Ảnh chụp màn hình lỗi đầy đủ

Nếu app của bạn hoạt động trong Preview nhưng lỗi trong production do biến môi trường bị thiếu hoặc rỗng:

1. Kiểm tra xem biến môi trường được lưu trước hay sau lần xuất bản gần nhất. Nếu được lưu sau đó, bạn cần xuất bản lại để thay đổi có hiệu lực.
2. Xác minh rằng biến được đặt cho đúng môi trường (Development so với Production).
3. Kiểm tra xem thông báo lỗi từ dịch vụ phía sau có đưa ra gợi ý không — ví dụ, "unauthorized" thường có nghĩa là khóa API đang trống hoặc không chính xác trong môi trường đó.

Nếu sự cố vẫn tiếp diễn, hãy liên hệ Support và cung cấp:

- Liên kết dự án hoặc URL đang hoạt động

- Tên khóa bị ảnh hưởng và môi trường nào gặp sự cố

- Lỗi đầy đủ từ dịch vụ phía sau

- Ảnh chụp màn hình đã được ẩn thông tin nhạy cảm của trang cấu hình

- Cấu hình được lưu trước hay sau khi xuất bản

Quan trọng: Chỉ cung cấp tên khóa. KHÔNG gửi giá trị bí mật, mật khẩu hoặc token.

Các phát hiện có thể dùng cách diễn đạt tương tự nhưng trỏ đến các vị trí khác nhau. Cách diễn đạt giống nhau không nhất thiết có nghĩa là kết quả bị trùng lặp.

1. So sánh tên phát hiện và vị trí được hiển thị cho từng kết quả.
2. Xem lại từng vị trí duy nhất thay vì bỏ qua cách diễn đạt lặp lại.
3. Nếu nhiều phát hiện có cùng nguyên nhân gốc, hãy khắc phục nguyên nhân đó rồi kiểm tra lại từng vị trí.
4. Chạy lại quét bảo mật trên phiên bản đã cập nhật.

Nếu cùng một phát hiện và vị trí vẫn xuất hiện nhiều hơn một lần, hãy liên hệ Atoms Support kèm theo Chat Link, thời gian quét và múi giờ, số lượng phát hiện và ảnh chụp màn hình đã được che thông tin nhạy cảm. Hãy xóa mọi mật khẩu, khóa, token hoặc thông tin nhạy cảm khác có thể xuất hiện trong phát hiện.

Một lần quét hoàn tất mà không có phát hiện được báo cáo là một bước kiểm tra hữu ích, nhưng không thể đảm bảo rằng mọi vấn đề bảo mật hoặc runtime đều đã được tìm thấy. Quá trình quét kiểm tra phiên bản dự án đã chọn; app của bạn vẫn cần được kiểm tra theo cách người dùng thực tế sẽ sử dụng.

Trước khi xuất bản, hãy kiểm tra các hành trình quan trọng trong app của bạn, bao gồm đăng nhập, vai trò người dùng, quyền truy cập dữ liệu riêng tư, thanh toán và các dịch vụ được kết nối. Sử dụng các tài khoản thử nghiệm riêng cho các vai trò khác nhau và xác nhận rằng mỗi tài khoản chỉ có thể truy cập thông tin và hành động được dành cho nó.

Nếu bạn phát hiện một sự cố production có thể làm lộ tài khoản, dữ liệu riêng tư, thanh toán hoặc thông tin xác thực, trước tiên hãy ngừng sử dụng hoặc hạn chế quyền truy cập vào tính năng bị ảnh hưởng. Thay mới mọi thông tin xác thực có thể đã bị lộ, sau đó liên hệ Atoms Support kèm theo Chat Link, phiên bản bị ảnh hưởng, các bước tái hiện sự cố, thời gian và múi giờ, cùng ảnh chụp màn hình đã được che thông tin nhạy cảm. Không chia sẻ chính thông tin xác thực đã bị lộ.

Nếu quá trình quét báo rằng một hành động chỉ dành cho admin có thể không được bảo vệ, hãy coi phát hiện đó là chưa được giải quyết cho đến khi bạn xác nhận rằng người dùng không được phép không thể sử dụng nó. Việc ẩn một nút admin là chưa đủ nếu hành động đó vẫn có thể được yêu cầu theo cách khác.

1. Mở phát hiện và xác định hành động hoặc vị trí mà nó nêu tên.
2. Xác định những vai trò đã đăng nhập nào nên được phép sử dụng hành động đó.
3. Yêu cầu Agent kiểm tra quyền của người dùng khi hành động được yêu cầu, không chỉ khi nút được hiển thị.
4. Kiểm tra hành động khi đã đăng xuất, với tài khoản thử nghiệm thông thường và với tài khoản thử nghiệm admin được ủy quyền.
5. Xác nhận rằng các lần thử bị từ chối không làm lộ dữ liệu riêng tư và không tạo thay đổi nào, sau đó chạy lại quét bảo mật.

Đừng xuất bản tính năng bị ảnh hưởng nếu một tài khoản không được phép vẫn có thể sử dụng hành động đó. Hãy liên hệ Atoms Support kèm theo Chat Link, nội dung phát hiện, phiên bản bị ảnh hưởng và ảnh chụp màn hình đã được che thông tin nhạy cảm nếu bạn không thể giải quyết.

HTTPS bảo vệ thông tin trong quá trình truyền giữa người dùng và dịch vụ. Nếu quá trình quét báo một vấn đề HTTPS, hãy dùng chính phát hiện đó để xác định địa chỉ, tài nguyên, callback hoặc cấu hình miền bị ảnh hưởng.

1. Mở phát hiện và ghi lại chính xác vị trí và địa chỉ mà nó báo cáo.
2. Yêu cầu Agent thay thế kết nối cụ thể đó bằng địa chỉ an toàn do nhà cung cấp hỗ trợ hoặc sửa cấu hình miền liên quan.
3. Đừng bỏ qua cảnh báo chứng chỉ hoặc thay đổi địa chỉ một cách mù quáng nếu dịch vụ bên ngoài không ghi nhận một lựa chọn an toàn tương đương.
4. Kiểm tra lại hành trình người dùng bị ảnh hưởng và xác nhận rằng không có mật khẩu, token, chi tiết thanh toán hoặc thông tin riêng tư nào được gửi qua kết nối không an toàn.
5. Chạy lại quét bảo mật trên phiên bản đã cập nhật.

Nếu phát hiện liên quan đến miền tùy chỉnh hoặc chứng chỉ mà bạn không thể sửa, hãy liên hệ Atoms Support kèm theo Chat Link, URL bị ảnh hưởng, nội dung phát hiện, thời gian và múi giờ, cùng ảnh chụp màn hình đã được che thông tin nhạy cảm.

Row Level Security, hay RLS, là một tính năng của Supabase kiểm soát những hàng dữ liệu nào trong cơ sở dữ liệu mà mỗi người dùng có thể đọc hoặc thay đổi. Phát hiện này chỉ liên quan khi dự án sử dụng Supabase và quá trình quét xác định một bảng có quy tắc truy cập cần được xem xét.

1. Mở phát hiện và xác định bảng mà nó nêu tên.
2. Ghi ra ai nên có thể xem, thêm, sửa hoặc xóa dữ liệu của bảng đó.
3. Yêu cầu Agent tạo các chính sách Supabase có quyền hạn tối thiểu nhưng vẫn hỗ trợ các hành trình người dùng đó.
4. Kiểm tra khi đã đăng xuất và với một tài khoản thử nghiệm riêng cho từng vai trò. Xác nhận rằng mỗi tài khoản chỉ có thể truy cập các hàng và hành động được dự định.
5. Chạy lại quét bảo mật sau khi các chính sách được áp dụng.

Đừng tắt RLS hoặc cho phép mọi người dùng chỉ để xóa cảnh báo. Trước khi thực hiện thay đổi có thể ảnh hưởng đến dữ liệu hiện có, hãy xác nhận kế hoạch và giữ bản sao lưu hoặc bản export an toàn khi phù hợp. Không bao giờ chia sẻ khóa Supabase hoặc thông tin xác thực cơ sở dữ liệu trong Chat hoặc ảnh chụp màn hình.