SharePointDumper

SharePointDumper एक PowerShell-आधारित निष्कर्षण और ऑडिटिंग उपयोगिता है जो Microsoft Graph के माध्यम से उन SharePoint साइटों की गणना करती है जिन तक उपयोगकर्ता पहुँच सकता है और SharePoint के माध्यम से फ़ाइलें डाउनलोड करती है।

यह SOC / DLP परीक्षण, पर्पल टीमिंग, और गैर-परिष्कृत रेड-टीम मूल्यांकन के लिए डिज़ाइन किया गया है, इसलिए यह डाउनलोड की गई फ़ाइलों और SIEM सहसंबंध के लिए प्रत्येक HTTP अनुरोध (Graph + SharePoint) सहित विस्तृत रिपोर्ट तैयार करता है।

यह टूल प्रमाणीकरण नहीं करता है। इसके बजाय, इसे उपयुक्त Microsoft Graph अनुमतियों (Sites.Read.All या Sites.ReadWrite.All) के साथ पहले से प्राप्त OAuth2 एक्सेस टोकन की आवश्यकता होती है।
यदि ऐसा टोकन प्राप्त करने में सहायता चाहिए, तो आप EntraTokenAid का उपयोग कर सकते हैं (नीचे उदाहरण शामिल हैं), जो उपयोग योग्य एक्सेस टोकन उत्पन्न करना सरल बनाता है।

✨ विशेषताएँ

• Microsoft Graph के माध्यम से SharePoint साइटों, ड्राइवों, फ़ोल्डरों और फ़ाइलों की गणना करता है
• ड्राइवों और फ़ोल्डरों को पुनरावर्ती रूप से डंप करता है (SharePoint प्री-ऑथेंटिकेशन URL का उपयोग करके)
• कोई अनिवार्य बाहरी निर्भरता नहीं (कोई Microsoft Graph PowerShell मॉड्यूल आदि नहीं)
• User-Agent को अनुकूलित करें
• वैश्विक डाउनलोड सीमाएँ: अधिकतम फ़ाइलें और अधिकतम कुल आकार
• साइटों और फ़ाइल एक्सटेंशन के लिए शामिल/बहिष्कृत फ़िल्टरिंग
• यादृच्छिक जिटर के साथ समायोज्य अनुरोध थ्रॉटलिंग
• वैकल्पिक सार्वजनिक-IP लुकअप
• सरल HTTP प्रॉक्सी का समर्थन करता है
• संरचित रिपोर्ट जिसमें शामिल हैं:
  • सारांश (अवधि, सीमाएँ, फ़िल्टर, सार्वजनिक IP)
  • एक्सेस किए गए SharePoint साइटें
  • पूर्ण HTTP अनुरोध लॉग (CSV या JSON)
• SharePoint डाउनलोड टोकन का रिडैक्शन, विकल्प के साथ उन्हें बिना रिडैक्ट किए लॉग करना
• सुगम Ctrl+C हैंडलिंग जो वर्तमान फ़ाइल के बाद रुक जाती है और बाहर निकलने से पहले पूरी रिपोर्ट और HTTP लॉग लिखती है
• रिज़्यूम मोड, जो पुनर्गणना करता है लेकिन पहले से डाउनलोड की गई फ़ाइलों को छोड़ देता है
• वैकल्पिक स्वचालित एक्सेस टोकन रीफ़्रेश (EntraTokenAid की आवश्यकता है https://github.com/zh54321/EntraTokenAid.git)

📦 चित्र

निष्पादन:

उदाहरण CSV API लॉग (CSV या JSON हो सकता है):

उदाहरण फ़ाइल डाउनलोड लॉग (CSV या JSON हो सकता है)

📦 स्थापना

रिपॉजिटरी क्लोन करें

git clone https://github.com/zh54321/SharePointDumper.git
cd SharePointDumper

🔑 आवश्यकताएँ

SharePointDumper को साइटों और फ़ाइलों की गणना करने के लिए प्रतिनिधि अनुमतियों के साथ एक वैध Microsoft Graph एक्सेस टोकन की आवश्यकता होती है:

• Sites.Read.All या
• Sites.ReadWrite.All

इसके अलावा, OAuth क्लाइंट को SharePoint API को कॉल करने की अनुमति होनी चाहिए।

23 से अधिक Microsoft प्रथम-पक्ष एप्लिकेशन पहले से ही Sites.Read… अनुमतियों के लिए पूर्व-सहमत हैं। वे SharePoint से फ़ाइलें डाउनलोड कर सकते हैं, और अतिरिक्त टेनेंट कॉन्फ़िगरेशन के बिना एक वैध टोकन प्राप्त करने के लिए उपयोग किए जा सकते हैं।

टोकन जीवनकाल अनुशंसा

यदि संभव हो, तो CAE-सक्षम एक्सेस टोकन का उपयोग करें, जो 24 घंटे तक वैध रहता है और लंबे समय तक चलने वाले डंप के दौरान रुकावटों को कम करता है।

EntraTokenAid के साथ टोकन प्राप्त करना

आप उपयुक्त एक्सेस टोकन प्राप्त करने के लिए EntraTokenAid का उपयोग PowerShell के माध्यम से कर सकते हैं
(डिफ़ॉल्ट रूप से CAE टोकन का अनुरोध किया जाता है):

# मॉड्यूल क्लोन करें
git clone https://github.com/zh54321/EntraTokenAid.git
Import-Module EntraTokenAid/EntraTokenAid.psm1

# टोकन प्राप्त करें
$tokens = Invoke-Auth -ClientID 'b26aadf8-566f-4478-926f-589f601d9c74' -RedirectUrl 'urn:ietf:wg:oauth:2.0:oob'

# वैकल्पिक: नीचे दिए गए उदाहरणों के साथ संगत वेरिएबल में स्टोर करें
$AccessToken = $tokens.access_token

🚀 उपयोग

मूल उपयोग

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -UserAgent "Not SharePointDumper"

साइटों को फ़िल्टर करें

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -IncludeSites "Finance","Projects"

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -ExcludeSites "HR","Legal"

फ़ाइल एक्सटेंशन फ़िल्टर करें

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -IncludeExtensions pdf,docx

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -ExcludeExtensions jpg,bmp

डाउनलोड सीमित करें

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -MaxFiles 500

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -MaxTotalSizeMB 100

अनुरोध धीमा करें

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -RequestDelaySeconds 2

जिटर के साथ:

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -RequestDelaySeconds 2 -Variation 3

रिज़्यूम (टोकन समाप्ति के बाद उदाहरण)

.\Invoke-SharePointDumper.ps1 -AccessToken $accesstoken -Resume -OutputFolder .\20251121_1551_MyTenant

रिज़्यूम मोड में, -OutputFolder को आपके पिछले रन के फ़ोल्डर की ओर इशारा करना चाहिए।

स्वचालित टोकन रीफ़्रेश का उपयोग करना

SharePointDumper एक रीफ़्रेश टोकन और EntraTokenAid का उपयोग करके समाप्त हुए एक्सेस टोकन (HTTP 401) को स्वचालित रूप से रीफ़्रेश कर सकता है।

# अनिवार्य: मॉड्यूल आयात किया जाना चाहिए ताकि टूल Invoke-Refresh कमांड का उपयोग कर सके
Import-Module .\EntraTokenAid\EntraTokenAid.psm1

# वैकल्पिक: EntraTokenAid का उपयोग करके टोकन प्राप्त करें (अन्य विधियाँ भी संभव हैं)
$tokens = Invoke-Auth -ClientId 'b26aadf8-566f-4478-926f-589f601d9c74' -RedirectUrl 'urn:ietf:wg:oauth:2.0:oob'

# रीफ़्रेश समर्थन के साथ SharePointDumper चलाएँ
.\Invoke-SharePointDumper.ps1 -AccessToken $tokens.access_token -RefreshToken $tokens.refresh_token -RefreshClientId 'b26aadf8-566f-4478-926f-589f601d9c74'

नोट: टोकन रीफ़्रेश प्रयास API लॉग में लॉग नहीं किए जाते हैं।

पैरामीटर

🧾 आउटपुट संरचना

निर्देशिका संरचना

20261115_MySecureTenant/
 ├── SharePointDumper_Report_20261115_080333.txt
 ├── SharePointDumper_ApiLog_20261115_080333.csv
 ├── SharePointDumper_FileLog_20261115_080333.csv
 ├── Site A/
 │    └── Documents/
 │         ├── file1.docx
 │         └── file2.pdf
 └── Site B/
      └── Site Assets/

लॉग

• रिपोर्ट: उच्च-स्तरीय सारांश (Report_*.txt)
• API लॉग: प्रत्येक Graph + SharePoint HTTP अनुरोध
  (ApiLog_*.csv या .json)
• रिज़्यूम रन उत्पन्न करते हैं:
  • SharePointDumper_ReportResume_*
  • SharePointDumper_ApiLogResume_*

⚠️ प्रमाणीकरण त्रुटियाँ

401 – अनधिकृत

एक्सेस टोकन अमान्य या समाप्त हो गया है।

403 – निषिद्ध

एक्सेस टोकन मान्य है, लेकिन आवश्यक Microsoft Graph या SharePoint अनुमतियाँ गायब हैं।

🔍 पहचान

SharePointDumper गतिविधियाँ इसमें लॉग की जाती हैं:

• Unified Audit Log (UAL): SharePoint खोज और डाउनलोड गतिविधि को लॉग करता है।
• Graph Activity Logs: सभी साइट और ड्राइव गणना अनुरोधों (/organization, /sites, /drives) को रिकॉर्ड करता है।

UAL उदाहरण:

Graph Activity Log उदाहरण:

📝 लाइसेंस

MIT License के तहत जारी किया गया।