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," thì ví Cloud của bạn đã hết tiền.

Để khắc phục việc này:

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 đă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 đăng ký được dùng cho các cuộc trò chuyện với AI agent.

1. Kiểm tra chế độ xem mức sử dụng bộ nhớ và xác định các cuộc chat, 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 chat 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 lên.
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 publish thất bại.

Hãy chờ quét bảo mật hoàn tất, sau đó xem lại mọi 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 sửa 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à xoay vòng 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 đánh giá có 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 xử lý trên một 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 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 làm sạch 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ờ, và việc lỗi xảy ra liên tục hay ngắt quãng.
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 làm sạch 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 web đang hoạt động tạm thời không khả dụng:

1. Kiểm tra xem cả subdomain Prod của nền tảng và Preview đều không thể truy cập hay chỉ một trong hai.

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

3. Kiểm tra xem gần đây bạn có sửa dependency, điểm vào khởi động hoặc kết nối cơ sở dữ liệu hay 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à bao gồm:

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

- Thời điểm lỗi 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

- Gần đây bạn có sửa 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 ở "Building":

1. Đừng nhấp Publish liên tục — điều 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 và 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.

Hãy bao gồm những thông tin sau khi liên hệ Support:

- Liên kết chat

- Ảnh chụp đầ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ị

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

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 Trình xem App 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 lẽ ra 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 xem dự án hiện tại vẫn đang dùng đúng tên và vị trí hình ảnh hay không.
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 dùng Lưu trữ App hoặc một 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 yêu cầu môi trường và các bước thiết lập.

2. Xác minh môi trường chạy của bạn khớp với 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à bao gồm:

- 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 mong muốn

Quan trọng: Đính kèm một ví dụ cấu hình đã được làm sạch 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 hoặc bản build hiện tại hoàn tất.
2. Mở Publish. Việc xuất bản 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ì xuất bản lặp 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, hãy tránh gây ra thời gian ngừng hoạt động 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, 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, sau đó Publish hoặc Update 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 để mô phỏng 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 cấp phát 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 này, 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 cứ tải lại mà không hiển thị nội dung:

1. Hãy thử subdomain 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 subdomain 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à bao gồm:

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

- Subdomain Prod mặc định có thể truy cập hay không

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

- Ảnh chụp 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 trố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 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 manh mối không — ví dụ, "unauthorized" thường có nghĩa là khóa API bị 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à bao gồm:

- 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 đã được làm sạch 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ự trong khi trỏ đến các vị trí khác nhau. Cách diễn đạt tương tự 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 sửa 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 đã 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 một 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 nó 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 thử theo cách người dùng thực sẽ sử dụng.

Trước khi xuất bản, hãy kiểm thử 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. Dùng các tài khoản kiểm thử riêng biệt 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 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. Hãy xoay vòng 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 đã 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 xử lý 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. Quyết định những vai trò đã đăng nhập nào nên được phép 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 thử hành động khi đã đăng xuất, với tài khoản kiểm thử thông thường và với tài khoản kiểm thử 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ể 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 đã che thông tin nhạy cảm nếu bạn không thể xử lý nó.

HTTPS bảo vệ thông tin khi nó di chuyển giữa người dùng và một 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 được 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 tài liệu hóa một phương án an toàn tương đương.
4. Kiểm thử 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 đã 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 dùng Supabase và quá trình quét xác định một bảng mà quy tắc truy cập của nó 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 lại 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 tối thiểu cần thiết để hỗ trợ các hành trình người dùng đó.
4. Kiểm thử khi đã đăng xuất và với một tài khoản kiểm thử 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ữ một bản sao lưu hoặc export an toàn nếu 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.