🔐 Universal Git Secrets Cleaner + GitGuardian Integration

🇺🇸 English | 🇯🇵 日本語 | 🇹🇼 正體中文

🇹🇼 正體中文

概述

企業級 Git 機敏資料檢測與清理工具，支援 GitHub、GitLab.com、自架 GitLab。整合 GitGuardian API 提供專業檢測，具備完整 Git 歷史清理功能。

✨ 主要功能

🌐 多平台支援: GitHub、GitLab.com、自架 GitLab
🔍 專業檢測: GitGuardian API（650+ 種機敏資料）+ 本地檢測
🖥️ 雙重界面: 命令列工具 + 圖形界面
🧹 完整清理: Git 歷史重寫 + 檔案移除 + 字串替換
💾 自動備份: 修改前自動備份
🎯 三種模式: 僅掃描、自動清理、配置驅動

🚀 快速開始

安裝

# 複製專案
git clone https://github.com/your-username/universal-git-cleaner.git
cd universal-git-cleaner

# 安裝相依套件
pip install requests

# 使用方式
python universal_git_cleaner.py        # 命令列版本
python git_cleaner_gui.py              # 圖形界面版本（推薦）

基本使用

選擇平台: GitHub / GitLab.com / 自架 GitLab
輸入 Token: Personal Access Token
選擇檢測: GitGuardian API（可選）/ 本地模式
選擇模式: 掃描 / 清理 / 配置檔案

🔧 設定指南

Token 權限需求

GitHub: repo, user
GitLab: api, read_repository, write_repository
GitGuardian: scan:read

取得方式

GitHub: Settings → Developer settings → Personal access tokens
GitLab: User Settings → Access Tokens
GitGuardian: Dashboard → API Keys

📋 支援檢測類型

GitGuardian（650+ 類型）

AWS、Azure、GCP、OpenAI、Stripe、資料庫憑證、SSH Keys、JWT Tokens 等

本地模式

OpenAI API Keys、Google API Keys、AWS 憑證、Stripe Keys、資料庫 URLs、一般機密模式

⚠️ 重要警告

Git 歷史重寫: 永久改變倉庫歷史
團隊協調: 清理後所有人需重新 clone
憑證撤銷: 執行前先撤銷暴露的憑證
備份建議: 建立額外備份

📊 輸出範例

=== GitLab 掃描摘要 ===
檢測方式: GitGuardian
總倉庫數: 45
有問題的倉庫: 12
發現的問題: 28
機敏檔案: 8

問題類型分佈:
  AWS Secrets: 8
  Database Credentials: 6
  API Keys: 14

高風險倉庫:
  company/payment-service: 8 個問題, 2 個檔案
  company/auth-service: 6 個問題, 1 個檔案

🤝 貢獻

Fork 專案
建立分支 (git checkout -b feature/amazing-feature)
提交變更 (git commit -m 'Add amazing feature')
推送分支 (git push origin feature/amazing-feature)
建立 Pull Request

📄 授權

MIT License - 詳見 LICENSE 檔案

🇺🇸 English

Overview

Enterprise-grade Git secrets detection and cleaning tool supporting GitHub, GitLab.com, and self-hosted GitLab. Features GitGuardian API integration for professional detection and complete Git history rewriting capabilities.

✨ Key Features

🌐 Multi-Platform: GitHub, GitLab.com, Self-hosted GitLab
🔍 Professional Detection: GitGuardian API (650+ secret types) + Local patterns
🖥️ Dual Interface: Command-line tool + Graphical interface
🧹 Complete Cleanup: Git history rewriting + File removal + String replacement
💾 Auto Backup: Automatic backup before modifications
🎯 Three Modes: Scan-only, Auto cleanup, Config-driven

🚀 Quick Start

Installation

# Clone repository
git clone https://github.com/your-username/universal-git-cleaner.git
cd universal-git-cleaner

# Install dependencies
pip install requests

# Usage
python universal_git_cleaner.py        # Command-line version
python git_cleaner_gui.py              # GUI version (recommended)

Basic Usage

Choose Platform: GitHub / GitLab.com / Self-hosted GitLab
Enter Token: Personal Access Token
Choose Detection: GitGuardian API (optional) / Local mode
Select Mode: Scan / Cleanup / Config file

🔧 Setup Guide

Required Token Permissions

GitHub: repo, user
GitLab: api, read_repository, write_repository
GitGuardian: scan:read

How to Get Tokens

GitHub: Settings → Developer settings → Personal access tokens
GitLab: User Settings → Access Tokens
GitGuardian: Dashboard → API Keys

📋 Supported Detection Types

GitGuardian (650+ types)

AWS, Azure, GCP, OpenAI, Stripe, Database credentials, SSH Keys, JWT Tokens, etc.

Local Mode

OpenAI API Keys, Google API Keys, AWS credentials, Stripe Keys, Database URLs, Generic secrets

⚠️ Important Warnings

Git History Rewriting: Permanently changes repository history
Team Coordination: All collaborators must re-clone after cleanup
Credential Revocation: Revoke exposed credentials before running
Backup Recommended: Create additional backups

📊 Sample Output

=== GitHub Scan Summary ===
Detection Method: GitGuardian
Total Repositories: 45
Repositories with Issues: 12
Issues Found: 28
Sensitive Files: 8

Issue Type Distribution:
  AWS Secrets: 8
  Database Credentials: 6
  API Keys: 14

High-Risk Repositories:
  company/payment-service: 8 issues, 2 files
  company/auth-service: 6 issues, 1 file

🤝 Contributing

Fork the repository
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push branch (git push origin feature/amazing-feature)
Create Pull Request

📄 License

MIT License - see LICENSE file for details

🇯🇵 日本語

概要

GitHub、GitLab.com、セルフホスト GitLab に対応したエンタープライズグレードの Git 機密データ検出・クリーニングツール。GitGuardian API 統合による専門的検出と完全な Git 履歴書き換え機能を提供。

✨ 主要機能

🌐 マルチプラットフォーム: GitHub、GitLab.com、セルフホスト GitLab
🔍 専門的検出: GitGuardian API（650+種類）+ ローカルパターン
🖥️ デュアルインターフェース: コマンドラインツール + グラフィカルインターフェース
🧹 完全クリーニング: Git 履歴書き換え + ファイル削除 + 文字列置換
💾 自動バックアップ: 変更前の自動バックアップ
🎯 3 つのモード: スキャンのみ、自動クリーニング、設定駆動

🚀 クイックスタート

インストール

# リポジトリをクローン
git clone https://github.com/your-username/universal-git-cleaner.git
cd universal-git-cleaner

# 依存関係をインストール
pip install requests

# 使用方法
python universal_git_cleaner.py        # コマンドライン版
python git_cleaner_gui.py              # GUI版（推奨）

基本的な使用方法

プラットフォーム選択: GitHub / GitLab.com / セルフホスト GitLab
トークン入力: Personal Access Token
検出方式選択: GitGuardian API（オプション）/ ローカルモード
モード選択: スキャン / クリーニング / 設定ファイル

🔧 セットアップガイド

必要なトークン権限

GitHub: repo, user
GitLab: api, read_repository, write_repository
GitGuardian: scan:read

トークンの取得方法

GitHub: Settings → Developer settings → Personal access tokens
GitLab: User Settings → Access Tokens
GitGuardian: Dashboard → API Keys

📋 対応検出タイプ

GitGuardian（650+タイプ）

AWS、Azure、GCP、OpenAI、Stripe、データベース認証情報、SSH キー、JWT トークンなど

ローカルモード

OpenAI API キー、Google API キー、AWS 認証情報、Stripe キー、データベース URL、一般的なシークレット

⚠️ 重要な警告

Git 履歴書き換え: リポジトリ履歴を永続的に変更
チーム調整: クリーニング後、全員が再クローンする必要
認証情報の無効化: 実行前に露出した認証情報を無効化
バックアップ推奨: 追加のバックアップを作成

📊 出力例

=== GitLab スキャン概要 ===
検出方式: GitGuardian
総リポジトリ数: 45
問題のあるリポジトリ: 12
発見された問題: 28
機密ファイル: 8

問題タイプ分布:
  AWS Secrets: 8
  Database Credentials: 6
  API Keys: 14

高リスクリポジトリ:
  company/payment-service: 8個の問題、2ファイル
  company/auth-service: 6個の問題、1ファイル

🤝 貢献

リポジトリをフォーク
機能ブランチを作成 (git checkout -b feature/amazing-feature)
変更をコミット (git commit -m 'Add amazing feature')
ブランチをプッシュ (git push origin feature/amazing-feature)
プルリクエストを作成

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照

🌟 謝辞

GitGuardian - 専門的な機密データ検出 API
Git コミュニティ - 強力なバージョン管理システム
全ての貢献者とユーザー

⭐ このツールが役に立った場合は、Star をお願いします！

🔗 チームと共有して、より安全なコードベースを構築しましょう！

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
LICENSE		LICENSE
README.md		README.md
git_cleaner_gui.py		git_cleaner_gui.py
universal_git_cleaner.py		universal_git_cleaner.py

Folders and files

Latest commit

History

Repository files navigation

🔐 Universal Git Secrets Cleaner + GitGuardian Integration

🇹🇼 正體中文

概述

✨ 主要功能

🚀 快速開始

安裝

基本使用

🔧 設定指南

Token 權限需求

取得方式

📋 支援檢測類型

GitGuardian（650+ 類型）

本地模式

⚠️ 重要警告

📊 輸出範例

🤝 貢獻

📄 授權

🇺🇸 English

Overview

✨ Key Features

🚀 Quick Start

Installation

Basic Usage

🔧 Setup Guide

Required Token Permissions

How to Get Tokens

📋 Supported Detection Types

GitGuardian (650+ types)

Local Mode

⚠️ Important Warnings

📊 Sample Output

🤝 Contributing

📄 License

🇯🇵 日本語

概要

✨ 主要機能

🚀 クイックスタート

インストール

基本的な使用方法

🔧 セットアップガイド

必要なトークン権限

トークンの取得方法

📋 対応検出タイプ

GitGuardian（650+タイプ）

ローカルモード

⚠️ 重要な警告

📊 出力例

🤝 貢献

📄 ライセンス

🌟 謝辞

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages