Skip to main content 首页 创作者 autohandai community-skills performing-cloud-storage-forensic-acquisition
performing-cloud-storage-forensic-acquisition Perform forensic acquisition and analysis of cloud storage services including Google Drive, OneDrive, Dropbox, and Box by collecting both API-based remote data and local sync client artifacts from endpoint devices.
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/autohandai/community-skills --skill performing-cloud-storage-forensic-acquisition命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... name performing-cloud-storage-forensic-acquisition description Perform forensic acquisition and analysis of cloud storage services including Google Drive, OneDrive, Dropbox, and Box by collecting both API-based remote data and local sync client artifacts from endpoint devices. domain cybersecurity subdomain digital-forensics tags ["cloud-forensics","google-drive","onedrive","dropbox","box","cloud-acquisition","api-forensics","sync-client","endpoint-artifacts","magnet-axiom"] version 1.0 author mahipal license Apache-2.0
Performing Cloud Storage Forensic Acquisition
Overview
Cloud storage forensic acquisition involves collecting digital evidence from services like Google Drive, OneDrive, Dropbox, and Box through both API-based remote acquisition and local endpoint artifact analysis. Modern investigations must address the challenge that cloud-synced files may exist in multiple states: locally synchronized, cloud-only (on-demand), cached, and deleted. Endpoint devices that have synchronized with cloud storage contain a wealth of metadata about locally synced files, files present only in the cloud, and even deleted items recoverable from cache folders. API-based acquisition using service-specific APIs provides direct access to remote data with valid credentials and proper legal authorization.
Prerequisites
Legal authorization (warrant, consent, or corporate policy) for cloud data access
Valid user credentials or administrative access tokens
Magnet AXIOM Cloud, Cellebrite Cloud Analyzer, or equivalent tool
KAPE with cloud storage target files
Python 3.8+ with google-api-python-client, msal, dropbox SDK
Network connectivity for API-based acquisition
Acquisition Methods
Method 1: API-Based Remote Acquisition
Google Drive API Acquisition
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
from googleapiclient.http import MediaIoBaseDownload
import io
import os
import json
from datetime import datetime
class GoogleDriveForensicAcquisition :
"""Forensically acquire files and metadata from Google Drive via API."""
def __init__ (self, credentials_path: str , output_dir: str ):
self .creds = Credentials.from_authorized_user_file(credentials_path)
self .service = build("drive" , "v3" , credentials= .creds)
.output_dir = output_dir
os.makedirs(output_dir, exist_ok= )
.acquisition_log = []
( ) -> :
files = []
page_token =
query = include_trashed
:
results = .service.files(). (
q=query,
pageSize= ,
fields=
,
pageToken=page_token
).execute()
files.extend(results.get( , []))
page_token = results.get( )
page_token:
files
( ) -> :
output_path = os.path.join( .output_dir, file_name)
mime_type.startswith( ):
export_formats = {
: ,
: ,
: ,
}
export_mime = export_formats.get(mime_type, )
request = .service.files().export_media(fileId=file_id, mimeType=export_mime)
:
request = .service.files().get_media(fileId=file_id)
io.FileIO(output_path, ) fh:
downloader = MediaIoBaseDownload(fh, request)
done =
done:
_, done = downloader.next_chunk()
.acquisition_log.append({
: datetime.utcnow().isoformat(),
: file_id,
: file_name,
: output_path,
:
})
output_path
( ) -> :
revisions = .service.revisions(). (
fileId=file_id,
fields=
).execute()
revisions.get( , [])
( ) -> :
report_path = os.path.join( .output_dir, )
(report_path, ) f:
json.dump({
: .acquisition_log[ ][ ] .acquisition_log ,
: datetime.utcnow().isoformat(),
: ( .acquisition_log),
: .acquisition_log
}, f, indent= )
report_path
self
self
True
self
def
list_all_files
self, include_trashed: bool = True
list
"""List all files including trashed items."""
None
""
if
else
"trashed = false"
while
True
self
list
1000
"nextPageToken, files(id, name, mimeType, size, "
"createdTime, modifiedTime, trashed, trashedTime, "
"owners, sharingUser, permissions, md5Checksum, "
"parents, webViewLink, driveId)"
"files"
"nextPageToken"
if
not
break
return
def
download_file
self, file_id: str , file_name: str , mime_type: str
str
"""Download a file from Google Drive preserving forensic integrity."""
self
if
"application/vnd.google-apps"
"application/vnd.google-apps.document"
"application/pdf"
"application/vnd.google-apps.spreadsheet"
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
"application/vnd.google-apps.presentation"
"application/pdf"
"application/pdf"
self
else
self
with
"wb"
as
False
while
not
self
"timestamp"
"file_id"
"file_name"
"output_path"
"action"
"downloaded"
return
def
get_activity_log
self, file_id: str
list
"""Retrieve activity/revision history for a specific file."""
self
list
"revisions(id, modifiedTime, lastModifyingUser, size, md5Checksum)"
return
"revisions"
def
export_acquisition_report
self
str
"""Export acquisition log for chain of custody documentation."""
self
"acquisition_log.json"
with
open
"w"
as
"acquisition_start"
self
0
"timestamp"
if
self
else
None
"acquisition_end"
"total_files"
len
self
"entries"
self
2
return
OneDrive / Microsoft 365 API Acquisition import msal
import requests
import os
import json
from datetime import datetime
class OneDriveForensicAcquisition :
"""Forensically acquire files and metadata from OneDrive via Microsoft Graph API."""
def __init__ (self, client_id: str , tenant_id: str , client_secret: str , output_dir: str ):
self .output_dir = output_dir
os.makedirs(output_dir, exist_ok=True )
authority = f"https://login.microsoftonline.com/{tenant_id} "
self .app = msal.ConfidentialClientApplication(
client_id, authority=authority, client_credential=client_secret
)
token_result = self .app.acquire_token_for_client(
scopes=["https://graph.microsoft.com/.default" ]
)
self .access_token = token_result.get("access_token" )
self .headers = {"Authorization" : f"Bearer {self.access_token} " }
self .base_url = "https://graph.microsoft.com/v1.0"
def list_user_files (self, user_id: str ) -> list :
"""List all files in user's OneDrive."""
url = f"{self.base_url} /users/{user_id} /drive/root/children"
files = []
while url:
response = requests.get(url, headers=self .headers)
data = response.json()
files.extend(data.get("value" , []))
url = data.get("@odata.nextLink" )
return files
def download_file (self, user_id: str , item_id: str , filename: str ) -> str :
"""Download a file from OneDrive."""
url = f"{self.base_url} /users/{user_id} /drive/items/{item_id} /content"
response = requests.get(url, headers=self .headers, stream=True )
output_path = os.path.join(self .output_dir, filename)
with open (output_path, "wb" ) as f:
for chunk in response.iter_content(chunk_size=8192 ):
f.write(chunk)
return output_path
def get_deleted_items (self, user_id: str ) -> list :
"""Retrieve items from OneDrive recycle bin."""
url = f"{self.base_url} /users/{user_id} /drive/special/recyclebin/children"
response = requests.get(url, headers=self .headers)
return response.json().get("value" , [])
Method 2: Local Endpoint Artifact Collection
KAPE Targets for Cloud Storage # Collect all cloud storage artifacts using KAPE
kape.exe --tsource C: --tdest C:\Output\CloudArtifacts --target GoogleDrive,OneDrive,Dropbox,Box
# OneDrive artifacts
# %USERPROFILE%\AppData\Local\Microsoft\OneDrive\logs\
# %USERPROFILE%\AppData\Local\Microsoft\OneDrive\settings\
# %USERPROFILE%\OneDrive\
# Google Drive artifacts
# %USERPROFILE%\AppData\Local\Google\DriveFS\
# Contains metadata SQLite databases and cached files
# Dropbox artifacts
# %USERPROFILE%\AppData\Local\Dropbox\
# %USERPROFILE%\Dropbox\.dropbox.cache\
# Contains filecache.dbx (encrypted SQLite), host.dbx, config.dbx
OneDrive Local Database Analysis import sqlite3
import os
def analyze_onedrive_sync_engine (db_path: str ) -> list :
"""Analyze OneDrive SyncEngineDatabase for file metadata."""
conn = sqlite3.connect(db_path)
cursor = conn.cursor()
cursor.execute("""
SELECT fileName, fileSize, lastChange,
resourceID, parentResourceID, eTag
FROM od_ClientFile_Records
ORDER BY lastChange DESC
""" )
files = []
for row in cursor.fetchall():
files.append({
"filename" : row[0 ],
"size" : row[1 ],
"last_change" : row[2 ],
"resource_id" : row[3 ],
"parent_id" : row[4 ],
"etag" : row[5 ]
})
conn.close()
return files
Cloud Storage Artifacts Summary Service Local Database Cache Location Log Files OneDrive SyncEngineDatabase.db %LOCALAPPDATA%\Microsoft\OneDrive\cache\ %LOCALAPPDATA%\Microsoft\OneDrive\logs\ Google Drive metadata_sqlite_db %LOCALAPPDATA%\Google\DriveFS{account}\content_cache\ %LOCALAPPDATA%\Google\DriveFS\Logs\ Dropbox filecache.dbx (encrypted) %APPDATA%\Dropbox.dropbox.cache\ %APPDATA%\Dropbox\logs\ Box sync_db %LOCALAPPDATA%\Box\Box\cache\ %LOCALAPPDATA%\Box\Box\logs\
References