secrets-management
Vault、AWS Secrets Manager、またはネイティブプラットフォームソリューションを使用したCI/CDパイプライン用の安全なシークレット管理を実装。機密認証情報の処理、シークレットのローテーション、またはCI/CD環境の保護時に使用。
When & Why to Use This Skill
This Claude skill provides comprehensive guidance and implementation patterns for secure secrets management within CI/CD pipelines. It covers industry-standard tools like HashiCorp Vault, AWS Secrets Manager, and native cloud solutions to help teams handle sensitive credentials, automate secret rotation, and enforce DevSecOps best practices to prevent credential leakage.
Use Cases
- Integrating HashiCorp Vault with GitHub Actions or GitLab CI to dynamically inject credentials into build environments without hardcoding.
- Automating the rotation of database passwords and API keys using AWS Secrets Manager to reduce the risk of long-lived credential exposure.
- Implementing secret scanning in pre-commit hooks or CI stages using tools like TruffleHog to detect and block sensitive data from entering version control.
- Configuring the Kubernetes External Secrets Operator to securely synchronize secrets from external providers like Azure Key Vault or Google Secret Manager into K8s clusters.
| name | secrets-management |
|---|---|
| description | Vault、AWS Secrets Manager、またはネイティブプラットフォームソリューションを使用したCI/CDパイプライン用の安全なシークレット管理を実装。機密認証情報の処理、シークレットのローテーション、またはCI/CD環境の保護時に使用。 |
English | 日本語
シークレット管理
Vault、AWS Secrets Manager、その他のツールを使用したCI/CDパイプライン用の安全なシークレット管理プラクティス。
目的
機密情報をハードコーディングせずにCI/CDパイプラインで安全なシークレット管理を実装する。
使用タイミング
- APIキーと認証情報の保存
- データベースパスワードの管理
- TLS証明書の処理
- シークレットの自動ローテーション
- 最小権限アクセスの実装
シークレット管理ツール
HashiCorp Vault
- 集中シークレット管理
- 動的シークレット生成
- シークレットローテーション
- 監査ログ
- きめ細かなアクセス制御
AWS Secrets Manager
- AWSネイティブソリューション
- 自動ローテーション
- RDSとの統合
- CloudFormationサポート
Azure Key Vault
- Azureネイティブソリューション
- HSMバックアップキー
- 証明書管理
- RBAC統合
Google Secret Manager
- GCPネイティブソリューション
- バージョニング
- IAM統合
HashiCorp Vault統合
Vaultのセットアップ
# Vault開発サーバーを起動
vault server -dev
# 環境を設定
export VAULT_ADDR='http://127.0.0.1:8200'
export VAULT_TOKEN='root'
# シークレットエンジンを有効化
vault secrets enable -path=secret kv-v2
# シークレットを保存
vault kv put secret/database/config username=admin password=secret
GitHub ActionsとVault
name: Deploy with Vault Secrets
on: [push]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Import Secrets from Vault
uses: hashicorp/vault-action@v2
with:
url: https://vault.example.com:8200
token: ${{ secrets.VAULT_TOKEN }}
secrets: |
secret/data/database username | DB_USERNAME ;
secret/data/database password | DB_PASSWORD ;
secret/data/api key | API_KEY
- name: Use secrets
run: |
echo "データベースに$DB_USERNAMEとして接続"
# $DB_PASSWORD、$API_KEYを使用
GitLab CIとVault
deploy:
image: vault:latest
before_script:
- export VAULT_ADDR=https://vault.example.com:8200
- export VAULT_TOKEN=$VAULT_TOKEN
- apk add curl jq
script:
- |
DB_PASSWORD=$(vault kv get -field=password secret/database/config)
API_KEY=$(vault kv get -field=key secret/api/credentials)
echo "シークレットでデプロイ中..."
# $DB_PASSWORD、$API_KEYを使用
参照: references/vault-setup.mdを参照
AWS Secrets Manager
シークレットの保存
aws secretsmanager create-secret \
--name production/database/password \
--secret-string "super-secret-password"
GitHub Actionsでの取得
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v4
with:
aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
aws-region: us-west-2
- name: Get secret from AWS
run: |
SECRET=$(aws secretsmanager get-secret-value \
--secret-id production/database/password \
--query SecretString \
--output text)
echo "::add-mask::$SECRET"
echo "DB_PASSWORD=$SECRET" >> $GITHUB_ENV
- name: Use secret
run: |
# $DB_PASSWORDを使用
./deploy.sh
TerraformとAWS Secrets Manager
data "aws_secretsmanager_secret_version" "db_password" {
secret_id = "production/database/password"
}
resource "aws_db_instance" "main" {
allocated_storage = 100
engine = "postgres"
instance_class = "db.t3.large"
username = "admin"
password = jsondecode(data.aws_secretsmanager_secret_version.db_password.secret_string)["password"]
}
GitHubシークレット
組織/リポジトリシークレット
- name: Use GitHub secret
run: |
echo "API Key: ${{ secrets.API_KEY }}"
echo "Database URL: ${{ secrets.DATABASE_URL }}"
環境シークレット
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- name: Deploy
run: |
echo "${{ secrets.PROD_API_KEY }}でデプロイ中"
参照: references/github-secrets.mdを参照
GitLab CI/CD変数
プロジェクト変数
deploy:
script:
- echo "$API_KEYでデプロイ中"
- echo "Database: $DATABASE_URL"
保護されマスクされた変数
- 保護: 保護されたブランチでのみ利用可能
- マスク: ジョブログで非表示
- ファイルタイプ: ファイルとして保存
ベストプラクティス
- シークレットをGitにコミットしない
- 環境ごとに異なるシークレットを使用
- シークレットを定期的にローテーション
- 最小権限アクセスを実装
- 監査ログを有効化
- シークレットスキャンを使用(GitGuardian、TruffleHog)
- ログでシークレットをマスク
- 保管時にシークレットを暗号化
- 可能な限り短命トークンを使用
- シークレット要件を文書化
シークレットローテーション
AWSでの自動ローテーション
import boto3
import json
def lambda_handler(event, context):
client = boto3.client('secretsmanager')
# 現在のシークレットを取得
response = client.get_secret_value(SecretId='my-secret')
current_secret = json.loads(response['SecretString'])
# 新しいパスワードを生成
new_password = generate_strong_password()
# データベースパスワードを更新
update_database_password(new_password)
# シークレットを更新
client.put_secret_value(
SecretId='my-secret',
SecretString=json.dumps({
'username': current_secret['username'],
'password': new_password
})
)
return {'statusCode': 200}
手動ローテーションプロセス
- 新しいシークレットを生成
- シークレットストアでシークレットを更新
- アプリケーションを更新して新しいシークレットを使用
- 機能を検証
- 古いシークレットを無効化
External Secrets Operator
Kubernetes統合
apiVersion: external-secrets.io/v1beta1
kind: SecretStore
metadata:
name: vault-backend
namespace: production
spec:
provider:
vault:
server: "https://vault.example.com:8200"
path: "secret"
version: "v2"
auth:
kubernetes:
mountPath: "kubernetes"
role: "production"
---
apiVersion: external-secrets.io/v1beta1
kind: ExternalSecret
metadata:
name: database-credentials
namespace: production
spec:
refreshInterval: 1h
secretStoreRef:
name: vault-backend
kind: SecretStore
target:
name: database-credentials
creationPolicy: Owner
data:
- secretKey: username
remoteRef:
key: database/config
property: username
- secretKey: password
remoteRef:
key: database/config
property: password
シークレットスキャン
プリコミットフック
#!/bin/bash
# .git/hooks/pre-commit
# TruffleHogでシークレットをチェック
docker run --rm -v "$(pwd):/repo" \
trufflesecurity/trufflehog:latest \
filesystem --directory=/repo
if [ $? -ne 0 ]; then
echo "❌ シークレットが検出されました!コミットがブロックされました。"
exit 1
fi
CI/CDシークレットスキャン
secret-scan:
stage: security
image: trufflesecurity/trufflehog:latest
script:
- trufflehog filesystem .
allow_failure: false
参照ファイル
references/vault-setup.md- HashiCorp Vault設定references/github-secrets.md- GitHubシークレットベストプラクティス
関連スキル
github-actions-templates- GitHub Actions統合用gitlab-ci-patterns- GitLab CI統合用deployment-pipeline-design- パイプラインアーキテクチャ用