mcpField
G
google-workspace-cli

google-workspace-cli

github.com/borgheiクラウド・DevOps1.0k63 回インストール1 週間前に更新
リポジトリ

google-workspace-cli について

Google Workspace 管理者向けに、設定エクスポートの監査、API 認証手順ガイドの作成、一般的な設定問題の診断を行うスキルです。セキュリティ設定、DNS や通信の確認、連携状態を扱います。

主な機能

  1. 01Workspace セキュリティ設定の監査
  2. 02OAuth とサービスアカウントの設定ガイド
  3. 03API スコープと委任の説明
  4. 04DNS・SSL/TLS・連携の診断
  5. 05人間向けまたは JSON 形式の出力

活用シーン

  1. 01エクスポートした Workspace 設定の監査
  2. 02API 認証手順の作成
  3. 03DNS とメール設定の確認
  4. 04連携や設定の競合の診断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/borghei/claude-skills --skill google-workspace-cli

インストール後、Claude Code で/google-workspace-cliを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
gws-admin-guide.md
scripts/
auth_setup_guide.py
gws_doctor.py
workspace_audit.py

詳細

Google Workspace CLI

Category: エンジニアリング Domain: Google Workspace の管理

概要

Google Workspace CLI スキルは、Google Workspace の設定を監査し、認証設定のドキュメントを生成し、よくある GWS の問題を診断するためのツールを提供します。IT 管理者が複雑な管理コンソールを操作せずに、安全で適切に設定された Workspace 環境を維持できるよう支援します。

まず確認すること

実行する前に、以下の入力内容を確認してください。不明または曖昧なものがあれば、推測せずに質問してください。

  • タスク — セキュリティ監査、認証設定ガイド、または診断（workspace_audit.py、auth_setup_guide.py、gws_doctor.py のいずれかを選択します）
  • 設定のエクスポートまたは認証方法 — 監査対象の GWS 設定 JSON、または設定ガイド用の認証方法とスコープ（--config または --method／--scopes を設定します）
  • 出力モード — 人が読みやすい形式、または自動化向けの JSON 形式（--format json を設定します）

停止ルール：出力に最も大きく影響する 2～3 項目だけを質問してください。ユーザーが「とにかく草案を作って」と言った場合は、そのまま進め、成果物の先頭に前提事項を記載してください。

クイックスタート

# Audit Workspace security configuration
python scripts/workspace_audit.py --config gws-config.json

# Generate auth setup guide
python scripts/auth_setup_guide.py --method oauth --scopes admin,drive

# Run diagnostics
python scripts/gws_doctor.py --check all

# JSON output for automation
python scripts/workspace_audit.py --config gws-config.json --format json

ツールの概要

workspace_audit.py

Google Workspace の設定エクスポートを監査し、セキュリティのベストプラクティスを確認します。

機能説明
2 要素認証の適用2 段階認証が必須かどうかを確認します
パスワードポリシーパスワード強度の要件を検証します
共有設定外部共有の設定を確認します
アプリへのアクセスサードパーティ製アプリのアクセスポリシーを確認します
管理者ロール管理者ロールの割り当てを確認します
モバイル管理デバイス管理ポリシーを確認します
Drive の設定Drive の共有とアクセス制御を検証します
auth_setup_guide.py

GWS API にアクセスするための認証設定手順を記載したドキュメントを生成します。

機能説明
OAuth の設定OAuth 2.0 の設定ガイドを生成します
サービスアカウントサービスアカウントの設定ドキュメントを作成します
API スコープ各 API に必要なスコープを一覧表示します
ドメイン委任ドメイン全体の委任設定について説明します
テストガイド検証手順を提示します
gws_doctor.py

よくある Google Workspace の設定問題を診断するツールです。

機能説明
DNS チェックMX、SPF、DKIM、DMARC レコードの形式を検証します
SSL/TLS証明書と通信のセキュリティ設定を確認します
インテグレーションの健全性一般的なインテグレーションパターンを検証します
設定の整合性競合する設定がないか確認します
ベストプラクティスGWS の推奨設定と照合します

ワークフロー

セキュリティ監査のワークフロー
  1. 設定をエクスポート - Admin SDK または手動エクスポートで、GWS の設定を JSON にエクスポートします
  2. 監査 - 設定ファイルを対象に workspace_audit.py を実行します
  3. 検出結果を確認 - 重大なセキュリティ上の不足を優先的に確認します
  4. 修正 - 管理コンソールで推奨設定を適用します
  5. 再監査 - 変更によって問題が解決したことを確認します
API 設定のワークフロー
  1. 計画 - 必要な API とスコープを特定します
  2. ガイドを生成 - 希望する方法を指定して auth_setup_guide.py を実行します
  3. 手順に従う - Google Cloud Console で認証情報を作成します
  4. 設定 - 必要に応じてドメイン委任を設定します
  5. 検証 - 提示された検証手順で API アクセスをテストします
ヘルスチェックのワークフロー
  1. 診断を実行 - すべてのチェックを含めて gws_doctor.py を実行します
  2. 結果を確認 - DNS、メール、インテグレーションの状態を確認します
  3. 問題を修正 - 優先度の高い順に問題に対処します
  4. 再確認 - 修正によって診断を通過することを確認します
定期メンテナンス
# Monthly security audit
python scripts/workspace_audit.py --config gws-export.json --format json > audit_$(date +%Y%m).json

# Weekly health check
python scripts/gws_doctor.py --check dns,email --format json

リファレンスドキュメント

よくあるパターンのクイックリファレンス

セキュリティの優先事項
設定優先度影響
2FA の強制重大アカウントの乗っ取りを防止します
パスワードポリシー重大認証情報への攻撃を減らします
外部共有高データ漏えいを防止します
アプリのアクセス制御高サードパーティのリスクを制限します
モバイル管理中デバイスへのアクセスを保護します
管理者ロールの見直し中権限の露出を制限します
メール用の DNS レコード
レコード用途例
MXメールのルーティングASPMX.L.GOOGLE.COM
SPF送信者の検証v=spf1 include:_spf.google.com ~all
DKIMメールの署名ドメイン固有の CNAME
DMARCポリシーの適用v=DMARC1; p=reject; rua=mailto:...
API スコープ
APIスコープ用途
Admin SDKadmin.directory.userユーザー管理
Drivedrive.readonlyファイルの一覧表示
Gmailgmail.settings.basicメール設定
Calendarcalendar.readonlyカレンダーへのアクセス
よくある問題
問題症状解決策
2FA なしアカウント乗っ取りのリスク2FA を強制する
弱いパスワード認証情報の詰め込み攻撃最低 12 文字に設定する
公開共有データ漏えい外部共有を制限する
DMARC なしメールのなりすましDMARC DNS レコードを追加する
古い管理者過剰な権限四半期ごとに管理者ロールを見直す

コメント

Markdown 対応