glab-security

glab security

プロジェクトの GitLab セキュリティ機能を設定します。

実験的な上流コマンドのインターフェースです。本番環境の自動化で使用する前に、現在の glab security --help を確認してください。

よく使うコマンド

# Show security command help
glab security --help

# Enable a scan profile on the current project
glab security config enable dependency_scanning

# Enable SAST on a specific project
glab security config enable sast -R gitlab-org/cli

# Check profile status
glab security config status dependency_scanning

# Disable a scan profile
glab security config disable dependency_scanning

# Disable dependency scanning auto-remediation
glab security config disable dependency_scanning_post_processing

対応しているプロファイルの例

上流のヘルプでは、現在、以下のプロファイル名が例として表示されています。

• dependency_scanning
• sast
• 脆弱な依存関係の自動修正用の dependency_scanning_post_processing

GitLab では、インスタンスのバージョンやプロジェクトの機能に応じて、ほかのプロファイル名もサポートされる場合があります。プロファイルでエラーが発生した場合は、エラー出力と GitLab プロジェクトのセキュリティ設定で、利用可能かどうかを確認してください。

運用上のガイダンス

• 対象プロジェクトのメンテナーまたはオーナーである必要があります。
• エージェントやスクリプトでは、明示的に対象を指定するために -R/--repo を使用してください。それ以外の場合、glab は現在の git リモートからプロジェクトを特定します。
• enable と disable はプロジェクト設定への書き込みとして扱ってください。状態を変更する前に、対象プロジェクトと要求されたプロファイルを確認してください。
• 変更の前後に status を実行し、現在のスキャン／プロファイルの状態をユーザーが確認できるようにしてください。

安全なワークフロー

PROFILE=sast
PROJECT=group/project

# 1. Inspect current state
glab security config status "$PROFILE" -R "$PROJECT"

# 2. Confirm requested change with the user, then apply
glab security config enable "$PROFILE" -R "$PROJECT"

# 3. Verify
glab security config status "$PROFILE" -R "$PROJECT"

サブコマンド

現在取得されている --help 出力については、references/commands.md を参照してください。