Bí mật, token và những thứ không bao giờ commit

Bốn chỗ để khóa bí mật và chỗ nào dùng khi nào, cách xử lý khi đã rò rỉ, và ranh giới không đưa mật khẩu cho AI.

Đây là bài ngắn nhất Cấp 2 và là bài gây thiệt hại nhiều nhất nếu bỏ qua. Bot quét GitHub tìm khóa API liên tục; một khóa lọt lên repo công khai thường bị dùng trong vòng vài phút, không phải vài ngày.

Bốn chỗ giữ bí mật, dùng đúng chỗ

Nguyên tắc một câu: bí mật đi theo môi trường, không đi theo mã nguồn. Cùng một tên biến ANTHROPIC_API_KEY, giá trị khi chạy ở máy bạn và khi chạy thật là hai giá trị khác nhau, và không giá trị nào nằm trong Git.

Chạy thử tại máy: .dev.vars

Với Workers, wrangler dev tự đọc file .dev.vars ở gốc project:

ANTHROPIC_API_KEY=sk-ant-...
MAT_KHAU_ADMIN=...
ZALO_WEBHOOK=https://...

Và trong mã, bạn đọc qua env:

export default {
  async fetch(request, env) {
    const key = env.ANTHROPIC_API_KEY;   // không bao giờ viết thẳng khóa ở đây
    // ...
  }
};

Hai việc bắt buộc, làm ngay khi tạo file:

echo ".dev.vars" >> .gitignore
git check-ignore -v .dev.vars     # phải in ra dòng khẳng định nó bị bỏ qua

Lệnh thứ hai là lệnh kiểm. Đừng tin là đã an toàn chỉ vì đã gõ dòng đầu.

App chạy thật: Worker Secrets

wrangler secret put ANTHROPIC_API_KEY
# nó hỏi giá trị, bạn tự dán, giá trị không vào lịch sử dòng lệnh
wrangler secret list

Bí mật nằm được mã hóa phía Cloudflare. Sau khi nạp, bạn không đọc lại được — chỉ xem được tên, không xem được giá trị. Đó là tính năng, không phải thiếu sót.

[vars]
TEN_CONG_TY = "Chang An"
SO_TRANG_MOI_LAN = "50"

CI/CD: GitHub Secrets

gh secret set CLOUDFLARE_API_TOKEN
gh secret list

Trong workflow dùng qua ${{ secrets.TEN }}. GitHub tự che giá trị trong log — nhưng chỉ che khi khớp nguyên văn. Nếu bạn echo nó ra sau khi biến đổi (cắt chuỗi, mã base64), phần che không còn hiệu lực. Luật: đừng in biến bí mật ra log, dù để gỡ lỗi.

Danh sách thứ không bao giờ commit

.dev.vars          .env, .env.local
*.pem, *.key       chứng chỉ, khóa riêng
wrangler.toml      <- CHỈ KHI bạn viết secret lẫn vào đây (đừng làm vậy)
*.sqlite, *.db     cơ sở dữ liệu có dữ liệu thật
*.xlsx, *.csv      dữ liệu khách hàng đã xuất ra
anh-nhan-vien/     ảnh người thật
.wrangler/         thư mục tạm của wrangler

Bốn dòng giữa là thứ người ta hay quên vì chúng không trông như bí mật. Một file danh-sach-nhan-vien.xlsx để trong project và commit lên là một vụ rò rỉ dữ liệu cá nhân — nặng hơn mất một khóa API, vì khóa thì đổi được còn dữ liệu người khác thì không.

Đã rò rỉ rồi thì làm gì — theo đúng thứ tự

1. Thu hồi khóa ở nơi phát hành, ngay bây giờ. Cloudflare → API Tokens → Roll/Delete. Anthropic → Console → Delete key. Đây là bước duy nhất thật sự chặn thiệt hại.
2. Phát hành khóa mới và nạp lại vào Secrets.
3. Xem có bị dùng chưa. Cloudflare: Audit Log. Anthropic Console: tab Usage — có mức dùng bất thường là đã bị dùng.
4. Mới tới việc dọn lịch sử Git (nếu repo công khai).

Lưu ý tâm lý: ai cũng muốn làm bước 4 trước vì nó cho cảm giác "xóa được dấu vết". Nhưng bot đã lấy khóa thì việc bạn xóa khỏi lịch sử không lấy lại được gì. Thu hồi trước.

Ranh giới với AI — nói thẳng

Trợ lý AI giúp bạn rất nhiều việc, nhưng có một đường không bước qua:

• Không đưa mật khẩu, khóa API, mã OTP cho AI, kể cả khi nó đang giúp bạn cấu hình và việc đó sẽ nhanh hơn.
• Không để AI nhập đăng nhập hộ bạn. Cách làm đúng: nó mở sẵn trang đăng nhập, phần gõ là của bạn.
• Khi dán log hoặc mã cho AI, xóa khóa đi trước. Thay bằng sk-ant-XXXX.

Lý do không phải là "AI xấu". Lý do là: nội dung hội thoại có thể được lưu lại, và một khóa đã ra khỏi tầm kiểm soát của bạn thì không rút lại được. Một trợ lý làm việc đúng mực sẽ tự từ chối việc này — nếu nó xin mật khẩu của bạn, đó là tín hiệu nên dừng lại.

Rà toàn bộ project này và liệt kê mọi chỗ có thể là bí mật bị để lộ:
- khóa API, token, mật khẩu gán cứng trong mã
- số điện thoại, email, họ tên người thật
- file dữ liệu thật (.xlsx, .csv, .db, ảnh người)
- bí mật nằm trong [vars] của wrangler.toml

Với mỗi chỗ: nói file, dòng, và loại rủi ro. Chỉ đọc, đừng sửa gì.
Cũng kiểm giúp tôi lịch sử Git: git log --all --name-only | grep -Ei
"\.env|\.dev\.vars|\.xlsx|\.csv|\.pem"