---

## 🖥️ UI प्रबंधन इंटरफ़ेस

BlockGuard में एक **WPF डेस्कटॉप एप्लिकेशन** शामिल है जो संरक्षित फ़ाइलों और फ़ोल्डरों को एक दृश्य इंटरफ़ेस के माध्यम से प्रबंधित करने के लिए है — मैन्युअल रूप से `appsettings.json` संपादित करने की आवश्यकता नहीं है।

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12349/51a9b7894117382666d869cee59860a33698f666133bd23c6b6cd48b225d942c.png" alt="BlockGuard UI" width="640" />
</p>

### विशेषताएँ

- **डैशबोर्ड** — सुरक्षा स्थिति का अवलोकन (कुल फ़ाइलें, फ़ोल्डर, एन्क्रिप्शन स्थिति)
- **संरक्षित फ़ाइलें** — फ़ाइल ब्राउज़र डायलॉग के माध्यम से AI पहुंच से बचाने के लिए फ़ाइलें और फ़ोल्डर जोड़ें/हटाएं
- **गतिविधि लॉग** — सभी कॉन्फ़िगरेशन परिवर्तनों का रीयल-टाइम लॉग
- **सेटिंग्स** — कॉन्फ़िगरेशन फ़ाइल पथ और एजेंट जानकारी देखें
- **एजेंट स्थिति** — लाइव संकेतक जो दिखाता है कि BlockGuard एजेंट सेवा चल रही है या नहीं

### UI कैसे लॉन्च करें```powershell
# From the project root
dotnet run --project src/BlockGuard.UI

---

## 🚀 त्वरित प्रारंभ

### 1. रिपॉजिटरी क्लोन करें```powershell
git clone [email protected]:m2l33k/BlockGuard.git
cd BlockGuard

### 3. समाधान बनाएँ```powershell
dotnet build BlockGuard.sln --configuration Release

### 4. सुरक्षित पथ और नियम कॉन्फ़िगर करें

`src/BlockGuard.Agent/appsettings.json` को संपादित करें **कौन सी फ़ाइलें सुरक्षित करनी हैं** और **कौन सी प्रक्रियाएँ अधिकृत हैं** परिभाषित करने के लिए:```json
{
  "BlockGuard": {
    "ProtectedPaths": [
      "C:\\Secrets\\ai-model-keys",
      "C:\\Secrets\\api-credentials.json"
    ],
    "AuthorizedProcesses": [
      {
        "RuleName": "AI-Model-Inference-Engine",
        "ExecutablePath": "C:\\Program Files\\MyAI\\inference.exe",
        "MinimumIntegrityLevel": "Medium",
        "RequireSignature": false
      }
    ]
  }
}

## ⚙️ कॉन्फ़िगरेशन

सभी कॉन्फ़िगरेशन `src/BlockGuard.Agent/appsettings.json` में `"BlockGuard"` अनुभाग के अंतर्गत रहता है।

### संरक्षित पथ

गार्ड करने के लिए फ़ाइलों या निर्देशिकाओं की एक सूची। निर्देशिकाएँ सभी फ़ाइलों को पुनरावर्ती रूप से सुरक्षित करती हैं।```json
"ProtectedPaths": [
  "C:\\Secrets\\ai-model-keys",
  "C:\\Secrets\\api-credentials.json",
  "D:\\Confidential\\reports"
]

**उदाहरण: हस्ताक्षर-आधारित नियम (किसी भी हस्ताक्षरित प्रबंधन उपकरण के लिए)**```json
{
  "RuleName": "Signed-Management-Tool",
  "ExecutablePath": null,
  "ExpectedFileHash": null,
  "ExpectedSignerSubject": "CN=Contoso Security",
  "MinimumIntegrityLevel": "High",
  "RequireSignature": true
}

### अन्य विकल्प

| विकल्प | डिफ़ॉल्ट | विवरण |
|---|---|---|
| `IdentityCacheTtlSeconds` | `30` | एक मान्य प्रक्रिया पहचान कितने समय (सेकंड) तक कैश में रहती है |
| `HandleTimeoutSeconds` | `60` | अस्थायी ACL अनुदान की अधिकतम अवधि (सेकंड) |
| `AuditLogPath` | `C:\ProgramData\BlockGuard\Logs\audit.json` | JSON ऑडिट लॉग फ़ाइल का पथ |
| `EnableDpapiEncryption` | `true` | DPAPI के साथ संरक्षित फ़ाइलों को आराम पर एन्क्रिप्ट करें |
| `DpapiScope` | `LocalMachine` | DPAPI दायरा: `LocalMachine` या `CurrentUser` |

---

## 🏃 एजेंट चलाना

### विकल्प A: विकास मोड (कंसोल)

परीक्षण और डिबगिंग के लिए सर्वोत्तम। **उन्नत (प्रशासक) PowerShell** से चलाएं:```powershell
dotnet run --project src/BlockGuard.Agent --configuration Release

`Ctrl+C` दबाकर रोकें।

### विकल्प B: एक Windows Service के रूप में स्थापित करें (उत्पादन)```powershell
# 1. Publish a self-contained build
dotnet publish src/BlockGuard.Agent -c Release -r win-x64 --self-contained -o C:\BlockGuard

# 2. Create the Windows Service
sc.exe create BlockGuard binPath= "C:\BlockGuard\BlockGuard.Agent.exe" start= auto obj= "NT AUTHORITY\SYSTEM" DisplayName= "BlockGuard Security Agent"

# 3. Set the service description
sc.exe description BlockGuard "Process-based file access security agent (DLP)"

# 4. Start the service
sc.exe start BlockGuard

---

## ✅ यह काम कर रहा है इसकी पुष्टि करें

BlockGuard फ़ाइलों की सही ढंग से सुरक्षा कर रहा है, यह पुष्टि करने के लिए इन चरणों का पालन करें।

### परीक्षण 1: निर्माण सत्यापन```powershell
# From the project root directory
dotnet build BlockGuard.sln

# Expected: Build succeeded with 0 Error(s)

**✅ अपेक्षित आउटपुट:**
- `BlockGuard Security Agent Starting` संदेश
- कोई `CRITICAL` या `FATAL` त्रुटि नहीं
- `ETW file trace session started successfully`
- `BlockGuard is now actively protecting X path(s)`

**❌ यदि आप `ETW session — insufficient privileges` देखते हैं:**
- आप व्यवस्थापक के रूप में नहीं चल रहे हैं। PowerShell पर राइट-क्लिक करें → "Run as Administrator"

### परीक्षण 3: ACL लॉकडाउन सत्यापन

एजेंट शुरू होने के बाद, सुनिश्चित करें कि संरक्षित फ़ाइलें लॉक डाउन हैं:```powershell
# Create a test protected file
New-Item -Path "C:\Secrets" -ItemType Directory -Force
Set-Content -Path "C:\Secrets\api-credentials.json" -Value '{"api_key": "secret123"}'

# Start the agent (it will lock down the file)
dotnet run --project src/BlockGuard.Agent

# In ANOTHER non-admin terminal, try to read the file:
Get-Content "C:\Secrets\api-credentials.json"
# Expected: Access Denied error

### Test 5: ऑडिट लॉग निरीक्षण

एजेंट के कुछ समय चलने के बाद, ऑडिट लॉग की जाँच करें:```powershell
# View the last 10 audit entries
Get-Content "C:\ProgramData\BlockGuard\Logs\audit.json" | Select-Object -Last 10

### परीक्षण 6: ETW इवेंट कैप्चर सत्यापित करें

दूसरा टर्मिनल खोलें और एजेंट चल रहा होने पर एक संरक्षित फ़ाइल तक पहुँचने का प्रयास करें:

``````powershell
# Terminal 1: Agent is running with console output
dotnet run --project src/BlockGuard.Agent

# Terminal 2: Try reading a protected file with notepad
notepad.exe "C:\Secrets\api-credentials.json"

### परीक्षण 7: अनधिकृत पहुँच अवरुद्ध सत्यापित करें (AI Model)

जब कोई प्रक्रिया (जैसे एक अनधिकृत AI मॉडल) किसी संरक्षित फ़ोल्डर या फ़ाइल को पढ़ने का प्रयास करती है, तो एजेंट तुरंत पहुँच से इनकार कर देता है। AI को सख्त **Access Denied** त्रुटि प्राप्त होगी, और प्रयास लॉग किया जाता है:

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12349/d2a2e20c0fc60e8b3a5f614b0a53c6c7275b634e93b1ce0b9fe4440c38215fac.png" alt="अनधिकृत पहुँच अस्वीकृत" width="600" />
</p>

### परीक्षण 8: DPAPI एन्क्रिप्शन सत्यापित करें```powershell
# Check that the .enc file was created
Test-Path "C:\Secrets\api-credentials.json.enc"
# Expected: True

# Check that the original plaintext file was securely deleted
Test-Path "C:\Secrets\api-credentials.json"
# Expected: False (if EnableDpapiEncryption is true)

### परीक्षण 10: लॉग्स निर्देशिका सत्यापित करें```powershell
# Check both log locations
Get-ChildItem "C:\ProgramData\BlockGuard\Logs\"

# Expected files:
# audit.json              (structured JSON audit log)
# blockguard-20260305.log (daily rolling application log)

---

## 🔬 यह कैसे काम करता है

### स्टार्टअप अनुक्रम (5 चरण)```
Phase 1: ACL Lockdown
  └─ Strip all permissions from protected files
  └─ Grant access only to SYSTEM + Administrators
  └─ Disable ACL inheritance

Phase 2: DPAPI Encryption (optional)
  └─ Encrypt each protected file at rest
  └─ Securely delete plaintext (overwrite with random data)
  └─ Store ciphertext as .enc files

Phase 3: Event Subscription
  └─ Register handler for file access events

Phase 4: ETW Monitoring
  └─ Start kernel-level file trace session
  └─ Filter events by protected paths
  └─ Emit FileAccessEvent for each match

Phase 5: Integrity Check Loop
  └─ Every 60 seconds, verify ACLs are intact
  └─ Auto-remediate if tampering detected

### प्रक्रिया सत्यापन (6 जाँच)

जब कोई प्रक्रिया किसी संरक्षित फ़ाइल तक पहुँचती है, BlockGuard इसे निम्नलिखित के माध्यम से मान्य करता है:

1. **निष्पादन योग्य पथ** — पूर्ण पथ को हल और कैननिकलाइज़ करता है (पथ ट्रैवर्सल को रोकता है)
2. **SHA-256 हैश** — डिस्क पर बाइनरी के हैश की गणना करता है (फ़ाइल प्रतिस्थापन का पता लगाता है)
3. **ऑथेंटिकोड हस्ताक्षर** — डिजिटल हस्ताक्षर श्रृंखला को मान्य करता है (अहस्ताक्षरित/छेड़छाड़ की गई बाइनरी का पता लगाता है)
4. **प्रक्रिया स्वामी SID** — चल रहे खाते की पहचान करने के लिए टोकन को क्वेरी करता है
5. **अखंडता स्तर** — अनिवार्य लेबल (अविश्वसनीय/निम्न/मध्यम/उच्च/सिस्टम) पढ़ता है
6. **मूल प्रक्रिया ID** — प्रक्रिया निर्माण श्रृंखला का पता लगाता है (इंजेक्शन का पता लगाता है)

सभी जाँचें **फेल-क्लोज़`d होती हैं**: यदि कोई भी सत्यापन चरण विफल होता है, तो पहुँच **अस्वीकृत** कर दी जाती है।

---

## 🛠️ समस्या निवारण

### "ETW सत्र — अपर्याप्त विशेषाधिकार"

**कारण:** एजेंट प्रशासक/सिस्टम विशेषाधिकारों के साथ नहीं चल रहा है।

**समाधान:**```powershell
# Right-click PowerShell → "Run as Administrator"
dotnet run --project src/BlockGuard.Agent

### क्लोनिंग के बाद बिल्ड त्रुटियाँ

**समाधान:** NuGet पैकेज पुनर्स्थापित करें:```powershell
dotnet restore BlockGuard.sln
dotnet build BlockGuard.sln

---

## 🔒 सुरक्षा संबंधी विचार

### यह एजेंट क्या कर सकता है
- ✅ ACL प्रवर्तन के माध्यम से संरक्षित फ़ाइलों को **पढ़ने** से अनधिकृत प्रक्रियाओं को रोकें
- ✅ ETW के माध्यम से सभी फ़ाइल एक्सेस प्रयासों का वास्तविक समय में **ऑडिट** करें और पता लगाएं
- ✅ DPAPI का उपयोग करके फ़ाइलों को **आराम की स्थिति में** एन्क्रिप्ट करें
- ✅ ACL छेड़छाड़ का **पता लगाएं और स्वचालित रूप से सुधारें**

### यह एजेंट क्या नहीं कर सकता
- ❌ **फ़ाइल पढ़ने को उड़ान में रोकें** — यह एक उपयोगकर्ता-मोड एजेंट है; वास्तविक उड़ान में रोकथाम के लिए एक कर्नेल मिनीफ़िल्टर ड्राइवर की आवश्यकता है
- ❌ **कर्नेल-स्तरीय हमलों को रोकें** — एक दुर्भावनापूर्ण कर्नेल ड्राइवर NTFS ACL को बायपास कर सकता है
- ❌ **प्रशासकों को ओवरराइड करने से रोकें** — प्रशासक खाते ACL हटा सकते हैं (छेड़छाड़ का पता लगाने से कम किया गया)

### उत्पादन के लिए अनुशंसाएँ

1. **`NT AUTHORITY\SYSTEM` के रूप में चलाएँ** — एक Windows सेवा का उपयोग करें, कंसोल ऐप का नहीं
2. **एजेंट बाइनरी पर हस्ताक्षर करें** एक प्रमाणीकृत कोड प्रमाणपत्र के साथ स्व-छेड़छाड़ को रोकने के लिए
3. **वॉल्यूम पर BitLocker सक्षम करें** पूर्ण-डिस्क एन्क्रिप्शन के लिए (DPAPI का पूरक)
4. **केंद्रीकृत निगरानी के लिए SIEM पर ऑडिट लॉग अग्रेषित करें**
5. **कर्नेल-स्तरीय बायपास को रोकने के लिए सिक्योर बूट + ड्राइवर हस्ताक्षर प्रवर्तन सक्षम करें**

---

## 🤝 योगदान

1. रिपॉजिटरी को फोर्क करें
2. एक फीचर ब्रांच बनाएं: `git checkout -b feature/my-feature`
3. अपने परिवर्तनों को कमिट करें: `git commit -m "Add my feature"`
4. ब्रांच पर पुश करें: `git push origin feature/my-feature`
5. एक पुल अनुरोध खोलें

### कोड शैली
- C# नामकरण परंपराओं का पालन करें (सार्वजनिक सदस्यों के लिए PascalCase)
- सभी सार्वजनिक API में XML दस्तावेज़ीकरण टिप्पणियाँ जोड़ें
- प्रत्येक सत्यापन को **फेल-क्लोज़** होना चाहिए (त्रुटि पर अस्वीकार करें)
- सभी मूल हैंडल को `finally` ब्लॉकों में स्पष्ट रूप से निपटान करें
- उपयोग के बाद संवेदनशील मेमोरी बफ़र्स को शून्य करें

---

## 📄 लाइसेंस

यह प्रोजेक्ट MIT लाइसेंस के तहत लाइसेंस प्राप्त है. विवरण के लिए [LICENSE](https://github.com/m2l33k/blockguard/blob/HEAD/LICENSE) देखें.

---

<p align="center">
  <b>विंडोज़ फ़ाइल सुरक्षा के लिए सुरक्षा-प्रथम सिद्धांतों के साथ निर्मित.</b>
  <br/>
  <sub>BlockGuard — क्योंकि आपका डेटा सिर्फ एक ताले के बजाय एक गार्ड का हकदार है.</sub>
</p>