chore(security): 🔒 permissions-audit による CI 最小権限原則の定期監査強化

[genzouw]

背景

現在のリポジトリには gitleaks.yml, trivy.yml, codeql.yml などの CI 検知、および pre-commit hook でのローカル検知など多層的な防御がすでに構築されています。
各 CI ワークフローはトップレベルで permissions を明示して最小権限に設定されていますが、それが新規追加ワークフローでも将来にわたって継続的に守られることを保証する仕組み（定期監査）がありません。
permissions が明示されていないワークフローが存在すると、リポジトリへの不要な書き込み権限が与えられるリスク（意図しない改ざんやシークレットの流出等）があります。

現状認識（事前調査結果のサマリー）

• 既存防御策: gitleaks.yml, trivy.yml, codeql.yml, trufflehog.yml および .husky/pre-commit (gitleaks) 導入済み。各既存ワークフローで permissions は設定済み。
• 未カバー領域: ワークフローに対する設定忘れ（permissions の未記載）を自動検知する仕組みが存在しない。
• 直近の漏洩リスク兆候: 特になし（既存の CI で防御できている）。

このPRで導入・強化するもの

• 対象: 新規 .github/workflows/permissions-audit.yml 追加と docs/security/leak-prevention.md への追記。
• ツール名とバージョン: Bash (grep) を利用したカスタムスクリプト。
• 期待される効果: 全ての GitHub Actions ワークフローに対して、トップレベルの permissions: が明記されているかを PR / Push / 定期監査（週次）で検査し、未設定（過剰権限の可能性）がある場合に CI をブロックする。

検知漏れリスクと補完策

• 検知できないケース: 意図的に permissions: write-all などの過剰な権限が明記されているケース。
• 補完策: PR レビュー時に Code Review（人間または AI エージェント）によって、権限のスコープが適切かをチェックする。

マージ前に必要な手動作業（チェックリスト）

レビュアーは PR をマージする前に必ず以下を実施してください。
本 PR の CI は手動作業完了を前提に通る設計です。

• 手動設定は不要です。既存の GitHub Actions 機能のみを使用しています。

マージ後の確認手順

• 次の push / PR で導入した permissions-audit.yml が green になることを確認。

ロールバック手順

問題が発生した場合は、当該ワークフローファイルを削除するか、schedule トリガーなどを無効化して revert してください。

参考情報

• 公式ドキュメント: https://docs.github.com/en/actions/security-guides/automatic-token-authentication#modifying-the-permissions-for-the-github_token
• 直近の関連 PR / Issue: なし

---

PR created automatically by Jules for task 5970606457979758699 started by @genzouw

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.

[qodo-code-review]

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

本プルリクエストは、GitHub Actions ワークフローにおける過剰な権限付与のリスクを低減するため、定期的な権限監査の仕組みを導入するものです。CI ワークフローに permissions の明示を強制することで、意図しない書き込み権限の付与やシークレット流出のリスクを未然に防ぎ、セキュリティの堅牢性を向上させることを目的としています。

Highlights

• CI 権限監査の導入: 新規ワークフロー .github/workflows/permissions-audit.yml を追加し、全 GitHub Actions ワークフローで permissions が明示されているかを自動検査する仕組みを構築しました。
• ドキュメントの更新: docs/security/leak-prevention.md に GitHub Actions の権限最小化に関する指針を追記し、最小権限の原則を明文化しました。

Ignored Files

• Ignored by pattern: .github/workflows/** (1)
  • .github/workflows/permissions-audit.yml

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[coderabbitai]

Warning

Review limit reached

@genzouw, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 48 minutes and 36 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: fe6e8823-c43a-4029-b8f1-73ecdacddad0

📥 Commits

Reviewing files that changed from the base of the PR and between b3612a0 and c2c3b3c.

📒 Files selected for processing (2)

• .github/workflows/permissions-audit.yml
• docs/security/leak-prevention.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch security/permissions-audit-5970606457979758699

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gemini-code-assist]

Code Review

このプルリクエストでは、docs/security/leak-prevention.md に GitHub Actions の権限（Permissions）最小化に関するセクションが追加され、CIワークフローにおける permissions 明示の重要性と監査ワークフローについて説明されています。レビューでは、既存のドキュメントとの表記の統一（英単語や記号の前後への半角スペースの挿入）による可読性向上のための具体的なコード提案が行われています。

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}