v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:08:00.000Z▲ 0 upvotes

Bí mật trong kho lưu trữ: gitleaks trong pre-commit và CI và phải làm gì nếu có rò rỉ

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Nếu key đã bị rò rỉ, trước tiên hãy làm điều này

Thứ tự của các hành động quan trọng hơn các công cụ, vì vậy hãy bắt đầu từ đầu.

  1. 1.Thu hồi và cấp lại khóa từ nhà cung cấp. Ngay lập tức, trước khi xóa lịch sử và phân tích. Các kho lưu trữ công khai được bot quét liên tục và khóa kết thúc trong một cam kết công khai sẽ được coi là bị xâm phạm kể từ thời điểm đẩy.
  2. 2.Cập nhật khóa trong tất cả các môi trường (bí mật CI, biến lưu trữ, trình quản lý bí mật) và khởi động lại dịch vụ.
  3. 3.Kiểm tra nhật ký sử dụng khóa với nhà cung cấp của bạn: cuộc gọi từ địa chỉ lạ, số lượng bất thường, tài nguyên được tạo. Dành cho khóa đám mây - phiên bản mới và người dùng IAM.
  4. 4.Chỉ sau đó mới quyết định xem có xóa lịch sử hay không. Bạn có thể viết lại lịch sử đó qua git filter-repo, nhưng bạn không kiểm soát các bản sao, nhánh, bộ đệm CI và bản sao của dịch vụ nhân bản. Xóa khỏi lịch sử là để vệ sinh chứ không phải để sửa chỗ rò rỉ. Nếu một chìa khóa bị thu hồi, nó sẽ vô hại cho dù nó ở đâu.

Một lỗi phổ biến là xóa tệp có cam kết mới và coi như vấn đề đã được giải quyết. Giá trị vẫn còn trong lịch sử và được tìm thấy bằng một lệnh git log -p.

Phòng ngừa: gitleaks cục bộ

gitleaks tìm kiếm mã và lịch sử các chuỗi tương tự như khóa của các dịch vụ đã biết và các giá trị entropy cao theo một bộ quy tắc. Kết nối thông qua khung cam kết trước:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/gitleaks/gitleaks
    rev: v8.30.1   # конкретный тег; pre-commit autoupdate обновит его
    hooks:
      - id: gitleaks
pip install pre-commit      # или brew install pre-commit
pre-commit install          # ставит хук в .git/hooks
pre-commit run gitleaks --all-files

Móc chỉ kiểm tra những gì bạn cam kết, vì vậy nó rất nhanh. Nhưng nó mang tính cục bộ: đồng nghiệp không chạy pre-commit install không có nó và nó bị vô hiệu hóa bởi git commit --no-verify. Do đó, cam kết trước là sự thuận tiện cho nhà phát triển và rào cản thực sự là việc xác minh trong CI.

Kiểm tra một lần toàn bộ lịch sử của kho lưu trữ hiện có (trong phiên bản 8.19 trở lên, các lệnh được gọi là git và dir; detect và protect cũ được giữ lại để đảm bảo tính tương thích):

gitleaks git --redact -v .

Cờ --redact ẩn các giá trị tìm thấy trong đầu ra - nếu không có cờ này, báo cáo sẽ bị rò rỉ nếu được sao chép vào phiếu.

Xác thực trong CI

# .github/workflows/secrets.yml
name: secrets
on: [pull_request, push]
permissions:
  contents: read
jobs:
  gitleaks:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0       # полная история, иначе проверяется только последний коммит
      - uses: gitleaks/gitleaks-action@v2
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Đối với kho lưu trữ của tổ chức, gitleaks-action yêu cầu khóa cấp phép (miễn phí, có sẵn theo yêu cầu) trong biến GITLEAKS_LICENSE. Một giải pháp thay thế không cần khóa là chạy chính tệp nhị phân hoặc hình ảnh Docker gitleaks trong bước run.

Hãy biến nhiệm vụ này thành một bước kiểm tra bắt buộc trong các quy tắc bảo vệ nhánh. Sau đó, một bí mật bị rò rỉ cục bộ sẽ dừng lại ở PR, thậm chí trước khi nó đến được nhánh chính.

Dương tính giả

Kiểm tra các nội dung cố định, các khóa ví dụ từ tài liệu và các giá trị băm trong các tệp khóa đôi khi trông giống như các bí mật. Tùy chọn:

  • Nhận xét gitleaks:allow trong dòng là một ngoại lệ được nhắm mục tiêu, hiển thị trong bài đánh giá.
  • Tệp .gitleaksignore chứa dấu vân tay của những phát hiện cụ thể từ báo cáo.
  • Sở hữu .gitleaks.toml, mở rộng các quy tắc tiêu chuẩn và đặt ra các ngoại lệ dọc theo đường dẫn.

Đừng loại trừ toàn bộ thư mục như config/ - đó là nơi chứa đựng các bí mật.

Bảo vệ đẩy GitHub

GitHub đã tích hợp tính năng quét bí mật với tính năng chặn đẩy cho các định dạng mã thông báo đã biết. Nó có sẵn miễn phí cho các kho lưu trữ công cộng và cho các kho riêng tư như một phần của Bảo vệ bí mật GitHub trả phí. Nó bổ sung cho gitleaks: nó hoạt động ở phía máy chủ và không thể bị cờ bỏ qua, nhưng nó chỉ biết các định dạng của các đối tác GitHub và không nhìn thấy bất kỳ loại bí mật nào của riêng bạn.

Về nguyên tắc ngăn ngừa rò rỉ

  • .env* trong .gitignore từ lần xác nhận đầu tiên, trong kho chỉ có .env.example với các giá trị trống.
  • Key có quyền tối thiểu và riêng biệt cho từng môi trường: rò rỉ key test thì không nên mở production.
  • Bí mật trong CI - thông qua kho bí mật tích hợp, không bao giờ có trong YAML.
  • Chú ý đến nhật ký: các giá trị của biến môi trường được in khi gỡ lỗi bản dựng vẫn còn trong nhật ký CI.

##Những việc không nên làm

  • Không "mã hóa" khóa base64 trước khi xác nhận. Máy quét không phải lúc nào cũng nắm bắt được điều này, nhưng kẻ tấn công sẽ giải mã nó sau một giây.
  • Không trì hoãn việc quay cho đến khi biết rõ liệu có ai đó đã sử dụng chìa khóa hay không. Việc làm rõ mất hàng giờ, việc quay vòng mất vài phút.
  • Không viết lại lịch sử của một chủ đề được chia sẻ một cách âm thầm. Các đồng nghiệp có bản sao cục bộ sẽ hoàn nguyên các cam kết cũ ở lần đẩy tiếp theo; đồng ý và yêu cầu sao chép lại kho lưu trữ.

Обсуждение (0)

Ещё на vbcd4u.com