この記事のポイント
- AWSでClaude Codeを安全に利用するための認証方法について解説
- 永続的なアクセスキー、Bedrock API keys、Console credentials、Cognito and OIDC、IAM Identity Center、IAM Identity Center + AWS STSの違いを紹介
- 他、初歩的な注意点も記載
はじめに
この記事では「この前リリースされた機能って実際に動かすとどんな感じなんだろう」とか
「もしかしたら内容次第では使えるかも??」などAWSサービスの中でも特定の機能にフォーカスして検証していく記事です。
今回はAWSの公式ブログでも紹介されているClaude Code on AWS パターン解説という内容を読んだうえで
Claude CodeをAWSで安全に利用するためにはどうすれば良いかという点について、AWSの認証方法を中心に解説していきたいと思います。
Amazon BedrockのClaudeを安全にClaude Codeで使う
AWSの環境を操作したい場合の認証については以下のような方法があります。
- 永続的なアクセスキー
- Bedrock API keys
- Console credentials(
aws login) - Cognito and OIDC
- IAM Identity Center
- IAM Identity Center + AWS STS
AWS CLIを使用してAWSリソースにアクセスする場合、セキュリティを確保するために適切な認証方法を選択することが重要です。
組織・プロジェクトの要件に応じて、最適な方法を選択する必要があると思いますが、どれかひとつを選ぶとしたら何が良いのだろうかと
迷うところです。
それぞれの認証方法について違いを解説します。
なお、手元の端末で実行するとしたらを前提に解説しています。
永続的なアクセスキー
これはいわずもがな、AWSアクセスキーIDとシークレットアクセスキーを使用して認証する方法です。
メリットとしてはとても設定が簡単であることですが、その反面かなりセキュリティリスクが高い方法といえます。
具体的には以下のようなリスクがあります。
- キーの漏洩
- アクセスキーが誤って公開されたり、第三者に盗まれたりする可能性があります
- キーの管理の難しさ
- 複数のOrgを管理している場合ではどのアカウントのどのアクセスキーなのか追跡が難しい
- 発行の手間
- Cloud Formationなどで自動化は可能ですが、運用が複雑になる可能性があります
IAM Identity Centerを使用できる場合においては、IAM Identity Centerを使用することが推奨されます。
Bedrock API keys
次に、Bedrock API keysを使用する方法です。
これはAmazon Bedrock APIを使用するための認証方法で、APIキーを使用してアクセスする方法です。
メリット
- APIキーは特定のサービスに対して発行されるため、アクセスキーよりもセキュリティレベルが高いという点
デメリット
- できることに制限があること
- アクセスキー同様にAPIキーの管理が必要なこと
デメリットを補うためにはクラウド上ではAWS Secrets Manager、ローカルでは環境変数を使用してAPIキーを安全に管理しながらセキュアに開発することが推奨されます。
Console credentials(aws login)
次に、AWS CLIのaws loginコマンドを使用して認証する方法です。
この方法は、AWS CLI v2で提供されている機能で、ブラウザを使用してAWSアカウントにログインする方法です。
前述のアクセスキーやAPIキーを使用せずに、AWSアカウントに安全にアクセスできる方法ですが、SCPでsignin:AuthorizeOAuth2Access と signin:CreateOAuth2Token の 2 つの IAM アクションを許可していない場合は使用できません。
またメリットでもありデメリットにも取れるところとしてはマルチセッションに対応していることが挙げられます。
-
メリットとして見る場合
- 複数のAWSアカウントやロールを使用している場合に、簡単に切り替えることができる点
-
デメリットとして見る場合
- 複数のAWSアカウントやロールを使用していると誤って選択してしまう可能性がある点
- UIがあるがゆえに、誤って選択してしまう可能性
- 複数のAWSアカウントやロールを使用していると誤って選択してしまう可能性がある点
Cognito and OIDC
この方法は、Amazon CognitoやOpenID Connect (OIDC)を使用して認証する方法です。
- Amazon Bedrock を使用した Claude Code 向けガイダンス
- aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock
この方法は、ユーザーがAmazon CognitoやOIDCプロバイダーを使用して認証することができるため、セキュリティレベルが高い方法といえます。
※Cognitoを使用する場合はユーザープールの設定や管理が必要です。
メリットとして見る場合はEntra IDなどのIDプロバイダーを使用している場合に、既存の認証基盤を活用できる点が挙げられます。
既存のIDプロバイダーを使用している場合は、ユーザー管理やアクセス制御を一元化できるため、セキュリティの向上が期待できます。
IAM Identity Center
旧AWS SSOであるIAM Identity Centerを使用して認証する方法です。一時的な認証情報を使用してAWSリソースにアクセスする方法で、セキュリティレベルが高い方法といえます。IAM Identity Centerを使用することで、ユーザーはAWSアカウントやロールを選択してログインできます。
メリットとして見る場合は、複数プロファイルによるアクセスと一時的な認証情報の両方を提供するため、セキュリティと利便性のバランスが取れている点が挙げられます。
デメリットとしては、IAM Identity Centerを使用するためには、組織でIAM Identity Centerが設定されている必要があることです。
複数アカウントを保有している場合は認証プロファイル(.aws/config)を複数設定して管理する必要があるという点には注意が必要です。
IAM Identity Center + AWS STS
この方法は、IAM Identity CenterとAWS Security Token Service (STS)を組み合わせて認証する方法です。
IAM Identity Centerを使用してユーザーがAWSアカウントやロールを選択してログインし、その後AWS STSを使用して一時的な認証情報を取得する方法です。
具体的にはBedrockの権限のみを付与したロールをClaude Codeに紐づけ、Claude CodeのIAMロールで別のIAMロールを引き受けるという方法です。
たとえば、以下のようなスクリプトを実行するとSTSを使用して一時的な認証情報を取得できます。
#!/bin/bash
# ロールARNを指定(引数にしてもOK)
ROLE_ARN="arn:aws:iam::123456789012:role/SpecificWorkRole"
SESSION_NAME="ClaudeCodeSession"
# STSで一時的な認証情報を取得
CREDENTIALS=$(aws sts assume-role \
--role-arn "$ROLE_ARN" \
--role-session-name "$SESSION_NAME" \
--query "Credentials" \
--output json)
# 環境変数にエクスポート
export AWS_ACCESS_KEY_ID=$(echo $CREDENTIALS | jq -r .AccessKeyId)
export AWS_SECRET_ACCESS_KEY=$(echo $CREDENTIALS | jq -r .SecretAccessKey)
export AWS_SESSION_TOKEN=$(echo $CREDENTIALS | jq -r .SessionToken)
echo "Assumed role: $ROLE_ARN"
echo "This session is now active in this terminal."
上記の方法を使用することで、IAM Identity Centerの利便性とAWS STSのセキュリティを組み合わせることができます。
メリットとして見る場合は、IAM Identity Centerの利便性とAWS STSのセキュリティを組み合わせることでAWS プロファイルを複数管理する必要がなくなります。
デメリットとして見る場合は、IAM Identity CenterとAWS STSの両方を設定しつつ、引き受けるロールの管理も必要になるため、設定が複雑になる点が挙げられます。ここはIaCなどで自動化すると良いでしょう。
ロールARNをどう取得するかという点で結構難儀しそうなところですが
AWS CLIで取得するかCloudFormationでIAMロールのスタック作成しておいて出力するなどの方法が考えられます。
AWS CLIで取得する場合は以下のようなコマンドで取得できます。
aws iam list-roles --query "Roles[?RoleName=='SpecificWorkRole'].Arn" --output text
他、初歩的な注意点
ここまででロールに関することを書いてきましたが、もっと重要でかつ初歩的なところとしてはIAMロールに何が定義されていて、どういう状況(Condition)で利用できるかというところです。
IAMのConditionはさまざまな制限が可能です。条件に設定できるコンテキストキーはバリエーションが豊富なのでここでは割愛します。
他にもどのリソースにアクセスできるかというリソース制限もあります。SCPで一括制御してしまうのもひとつの手でしょう。
まとめ
Claude CodeをAWSでセキュアに使用するための認証方法についてどんな方法があるか簡単にまとめてみました。
調べて実際にやってみると他にも方法があるのでは?と思いましたが、キリがなさそうなのでAnthropicの公式ドキュメントやAWSの公式ドキュメント、あとは個人の見解も交えつつ、代表的な方法を紹介しました。
個人的にはIAM Identity Center + AWS STSの方法が一番セキュアで運用も楽そうな気がしていますが、組織の要件や既存の認証基盤などを考慮して最適な方法を選択することが重要だと思いますので、ぜひ参考にしてみてください。
次回はAWS上のSandbox環境でClaude Codeを実際に動かしてみるところまで解説していきたいと思います。
