タグ: #aws

AWS SSO の認証情報は Docker コンテナに直接渡せない

~/.aws をマウントしても SSO トークンの解決に失敗する。boto3 から一時認証情報を取得して環境変数で渡す方法が確実。

Agent Registry の AGENT_SKILLS レコードは CLI と REST API でパラメータ名が異なる

AWS Agent Registry で AGENT_SKILLS レコードを作成する際、CLI では skillMd（dict 型）、REST API では skillMarkdown（文字列型）。descriptorType も SKILL ではなく AGENT_SKILLS。

Agent Registry の MCP レコード作成は server.json スキーマの制約に注意

AWS Agent Registry で MCP レコードを作成する際、name の reverse-DNS 形式、description の 100 文字制限、schemaVersion の必須指定でバリデーションエラーになる。ドキュメントの Minimal example だけでは分からない。

RDS Proxy 経由の Blue/Green Switchover では AdminShutdown ではなく SSL 切断が発生する

Aurora PostgreSQL の Blue/Green Switchover 中、ドキュメントでは AdminShutdown エラーが記載されているが、RDS Proxy 経由では SSL connection has been closed unexpectedly が発生する。エラーハンドリングの設計時に注意が必要。

EKS Auto Mode クラスターにマネージドノードグループを追加するには vpc-cni 等のアドオンが必要

EKS Auto Mode で作成したクラスターにマネージドノードグループを追加すると NodeCreationFailure (cni plugin not initialized) で失敗する。vpc-cni、kube-proxy、coredns アドオンの手動インストールで解決する。

amazon-efs-utils v2.x がインストール済みだと公式インストーラーで v3.0.0 にアップグレードされない

S3 Files に必要な amazon-efs-utils v3.0.0 を公式インストーラースクリプトでインストールしようとしたが、v2.x が既に入っていると v3.0.0 にならなかった。未インストール状態で実行すれば解決する。

AWS Security Agent は SQL Injection で取得したクレデンシャルで自力ログインする

認証情報を提供しなくても、Agent は SQL Injection でデータベースからクレデンシャルを抽出し、TOTP コードを推測して管理者としてログインした。ドキュメントの「認証情報なしでは公開ページのみテスト」は攻撃チェーンによる突破を除外していない。

AWS Security Agent のペンテストは HTML リンクがないとエンドポイントを発見できない

Security Agent の SCANNER は JSON レスポンスからリンクを辿らない。API-only アプリをテストする場合は HTML の <a> タグやフォームを含むエントリポイントが必要。

AWS Security Agent の Code Remediation には NAT Gateway が必要

Code Remediation を有効にしたペンテストで Unable to reach GitHub repository エラー。Agent のテスト環境は Agent Space のサブネットで起動し、GitHub にアクセスするためインターネット接続が必要。

AWS Security Agent の create-pentest で subnetArns は1つしか指定できない

create-pentest の vpcConfig.subnetArns は配列だが、2つ以上指定すると 'Maximum of 1 subnet id is allowed' エラーになる。EC2 と同じサブネットを1つだけ指定する。

AWS Security Agent の Private VPC ドメインは UNREACHABLE が正常な検証状態

Target Domain の HTTP Route 検証で UNREACHABLE になっても問題ない。Private VPC ドメインの場合、UNREACHABLE がペンテストに使用可能な正常状態。ドキュメントに記載あり。

ECS Managed Instances のデーモンには専用の IAM ポリシーが必要

ECS Managed Daemons が起動しない場合、インスタンスプロファイルに AmazonECSInstanceRolePolicyForManagedInstances をアタッチしているか確認する。従来の AmazonEC2ContainerServiceforEC2Role では動かない。

Security Agent の Application はリージョナルリソース（グローバルではない）

Security Agent の Application は1アカウント1つではなく1リージョン1つ。東京で作成した Application は us-east-1 からは見えず、リージョンごとに create-application が必要。

AWS Security Agent のサービスロールに CloudWatch Logs 権限が必須（ドキュメント未記載）

Security Agent のペネトレーションテストで PREFLIGHT が AccessDeniedException で即失敗する場合、サービスロールに logs:CreateLogGroup 権限が不足している。公式ドキュメントに記載がない。

Security Agent のペンテストはシングルスレッドサーバーをクラッシュさせる — gunicorn 等が必須

AWS Security Agent は13カテゴリの攻撃を並列実行するため、Flask 開発サーバーのようなシングルスレッドサーバーは HTTP 503 でクラッシュする。gunicorn 等のマルチワーカー構成が必要。

Security Agent の sourceCode は東京リージョンで INTERNAL_ERROR、us-east-1 では正常動作

sourceCode を使ったペンテストが東京リージョンで2回連続 INTERNAL_ERROR になったが、us-east-1 では同じ設定で正常に動作した。documents は東京でも問題なし。

Security Agent の sourceCode は ZIP 必須、documents は生ファイルで指定できる

create-pentest の assets.sourceCode に生ファイルを指定すると「Source code S3 URL must point to a ZIP archive」エラーになる。documents は生ファイルを直接指定可能。

Security Agent の sourceCode と documents は処理パイプラインが根本的に異なる

sourceCode は CODE SCANNER（BUSINESS LOGIC / IMPORTANT FLOWS / FRAMEWORKS）で体系的な静的分析を実行し PENTEST 前に脆弱性を検出する。documents は DOCUMENTS タスクで文脈処理するのみ。

Security Agent の VPC Config 利用時、CLI のドメイン検証が UNREACHABLE でもペンテストは実行可能

verify-target-domain CLI コマンドはパブリック経由で検証するためプライベート DNS は UNREACHABLE になるが、VPC Config 経由のペンテストでは PREFLIGHT 中に別途 VPC 内部検証が行われる。

DevOps Agent の IAM アクションプレフィックスは aidevops だった

AWS DevOps Agent の IAM アクションプレフィックスは devops-agent ではなく aidevops。boto3 のクライアント名は devops-agent だがポリシーでは aidevops:* を指定する。AWS CLI は v2.34.20 以降で対応。

DevOps Agent Webhook の同一 incidentId は破棄ではなくリンクされる

ドキュメントには Duplicate messages are deduplicated と記載されているが、実際には同一 incidentId の Webhook は既存の Investigation にリンクされ、リンク先の Investigation が再び In Progress に遷移する動作が確認された。

Lambda マネージドランタイムの boto3 に新サービスのモデルがない場合は PYTHONPATH でバンドル版を優先する

Lambda の Python マネージドランタイムに含まれる boto3 が古く、DevOps Agent などの新サービスのサービスモデルがない場合がある。PYTHONPATH=/var/task を設定してバンドル版 boto3 を優先させることで解決する。

Spring Boot + HikariCP ではノードベース ElastiCache でもウォームアップが効く

素の JDBC では不要だったウォームアップが、HikariCP のコネクションプール初期化により Spring Boot 環境では有効。初回リクエストが 2443ms → 264ms に改善した。

AWS SDK for Rust は初回リクエストに約900msかかる — TLS ハンドシェイクが99%

Lambda で AWS SDK for Rust のクライアントを Init で初期化しても、初回の API 呼び出しに約900msかかる。分離計測の結果、TLS ハンドシェイクが745msで99%を占めていた。

ElastiCache Serverless の接続は10分アイドルでは切断されない

公式ドキュメントではアイドルタイムアウトが非公開だが、実機検証で10分のアイドル後もキャッシュ接続が維持されることを確認した。

ElastiCache Serverless の初回レイテンシは公式ドキュメントに記載がある

「初回リクエストは通常より高レイテンシになる」ことが AWS 公式トラブルシューティングガイドの Reuse connections セクションに明記されている。

Lambda Durable Functions の呼び出しには修飾付き ARN が必須

未修飾の関数名で invoke すると InvalidParameterValueException になる。$LATEST を付けるか publish-version したバージョン番号を指定する。

Lambda Durable Functions のサスペンド中ステータスは RUNNING

コールバック待ちでサスペンドしていても get-durable-execution のステータスは RUNNING。実行履歴の CallbackStarted イベントで判断する。

AWS Payment Cryptography の HMAC 鍵は Java SDK v2.31.9 から作成できない

AWS Payment Cryptography の PVK アルゴリズムでドキュメント間に不整合がある

ECS の NLB 用インフラロールポリシーの ARN に service-role/ プレフィックスはない

AmazonECSInfrastructureRolePolicyForLoadBalancers の ARN は service-role/ なし。他の ECS ポリシーと同じパターンで書くと AttachRolePolicy が失敗する。

ECS の update-service で Linear ↔ Canary を動的に切り替えられる

ECS サービスの再作成なしに、update-service の --deployment-configuration で Linear と Canary を動的に切り替えられることを確認した。

ElastiCache for Valkey のノードベースクラスターは CreateCacheCluster ではなく CreateReplicationGroup で作る

aws elasticache create-cache-cluster --engine valkey が InvalidParameterValue で失敗する。Valkey エンジンは CreateReplicationGroup API が必須だった。

RDS の StorageEncrypted: false は「暗号化されていない」を意味しない

Aurora Express Configuration のクラスターで StorageEncrypted: false が返るが、公式ドキュメントには RDS サービス所有キーで暗号化されていると明記されている。API レスポンスとドキュメントの記述が矛盾する例。

EKS Pod Identity セッションポリシーの AccessDenied は原因が明示される

セッションポリシー起因の拒否は「no session policy allows」、IAM ロール起因は「no identity-based policy allows」とエラーメッセージで区別できる。IAM の権限トラブルシューティングが格段にやりやすい。

Network Firewall Proxy は HTTP でも PreRequest フェーズのルールが効く

TLS インターセプトなしでも HTTP の absolute-form リクエストに対しては PreRequest フェーズの HTTP メソッドやヘッダーの検査が可能。ドキュメントの記述は HTTPS に限定した話だった。

Network Firewall Proxy の PrivateLink 経由アクセスでは SourceIp が NAT される

PrivateLink エンドポイント経由のクロス VPC アクセスでは request:SourceIp がエンドポイントの ENI IP に NAT される。SourceVpc や SourceVpce で代替する必要がある。

Aurora PostgreSQL の Blue/Green でカスタムパラメータグループ使用時は Green 用も事前作成が必要

カスタムパラメータグループを使っている Aurora PostgreSQL クラスターでメジャーバージョンアップグレードを伴う Blue/Green デプロイメントを作成すると InvalidParameterCombination で失敗する。Green 用のパラメータグループを明示的に指定する必要がある。

Aurora Blue/Green デプロイメントは論理レプリケーションの事前有効化が必須

デフォルトパラメータグループのまま create-blue-green-deployment を実行すると SourceClusterNotSupportedFault で失敗する。PostgreSQL は rds.logical_replication = 1、MySQL は binlog_format = ROW を設定し、全インスタンスの再起動が必要。

HikariCP は Blue/Green Switchover 後も旧 Writer に接続し続ける

Blue/Green Switchover 中に全接続が切断された後、HikariCP が DNS キャッシュ経由で旧 Writer に再接続してしまう問題。書き込みワークロードでは read-only transaction エラーが発生する。PostgreSQL でも MySQL でも同じ挙動。

AgentCore CLI は AWS_REGION 環境変数が aws-targets.json より優先される

aws-targets.json に us-east-1 を指定しても、AWS_REGION=ap-northeast-1 が設定されていると ap-northeast-1 にデプロイされる。CLI のドキュメントに明記されていない挙動。

CloudFormation スタックが DELETE_FAILED で残ると eksctl create cluster が失敗する

eksctl create cluster が AlreadyExistsException で失敗する場合、DELETE_FAILED 状態の CloudFormation スタックが残っている可能性がある。手動で削除すれば解決する。

EKS Auto Mode は Pod が載っていない空ノードを自動で削除する

EKS Auto Mode（Karpenter）は空ノードを DisruptionTerminating: Empty で自動ターミネートする。コスト最適化のための正常な挙動。

aws eks list-insights でアップグレード前のブロッカーを事前検出できる

EKS Cluster Insights は kubelet version skew やアドオン互換性の問題を自動検出する。kubent/pluto と併用するとアップグレード判断が楽になる。

topologySpreadConstraints は hostname だけでなく zone も設定すべき

hostname だけだと同一 AZ 内の別ノードに分散するだけ。topology.kubernetes.io/zone を追加して AZ 間分散を保証する。

agentcore destroy 後の VPC 削除で DependencyViolation が出たら ENI の解放を待つ

AgentCore Runtime が VPC 内に作成した ENI は destroy 後も数時間 in-use のまま残ることがある。サブネットや VPC の削除は ENI が available になってから再試行する。

Identity Center のホームリージョンは sso-admin list-instances を各リージョンで叩いて特定する

Identity Center はグローバルに見えるが実体は特定リージョンにある。EKS Capabilities の idcRegion を間違えると AccessDeniedException になる。

Bedrock Foundation Model の IAM ポリシーではアカウント ID を空にする

Foundation Model の ARN は arn:aws:bedrock:region::foundation-model/... のようにアカウント ID が空。サンプルの ACCOUNT_ID プレースホルダーをそのまま置換すると権限が効かない。

EKS のアクセスエントリとアクセスポリシーは別物で、両方必要

EKS Capabilities が自動作成するアクセスエントリにはデプロイ権限がない。associate-access-policy で別途ポリシーを関連付けないと ArgoCD の同期が失敗する。

Lambda AZメタデータのPowertools対応はPython版未リリース・TypeScript版は利用可能

公式ドキュメントにはPython/TypeScript両方のPowertoolsコード例があるが、Python版3.25.0にはlambda_metadataモジュールが未収録でModuleNotFoundErrorになる。TypeScript版は@aws-lambda-powertools/commons 2.32.0で対応済み。

AgentCore の boto3 クライアントはコントロールプレーンとデータプレーンで分かれている

bedrock-agentcore-control（作成・削除）と bedrock-agentcore（セッション操作・コード実行）を混同すると AttributeError になる。

AgentCore Policyで条件なしのCedar permitはOverly Permissiveで自動拒否される

Bedrock AgentCore PolicyでCedar permitにwhen句を付けずに作成するとCREATE_FAILEDになる。FAIL_ON_ANY_FINDINGSの自動推論が原因。

AgentCore GatewayとPolicy Engineで命名規則が異なる

Bedrock AgentCore GatewayはハイフンのみでPolicy Engineはアンダースコアのみ。同じプレフィックスを使い回すとValidationExceptionになる。

AWS CLIの設定ファイルをXDG Base Directoryに準拠させるには環境変数2つで済む

AWS CLIはデフォルトで~/.aws/以下を使うが、AWS_CONFIG_FILEとAWS_SHARED_CREDENTIALS_FILEを設定するだけでXDG準拠にできる。

Lambda の capacity-provider-config は関数作成時にしか指定できない

update-function-configuration で後から追加しようとすると CapacityProviderConfig isn't supported for Lambda Default functions エラーになる。

Lambda Managed Instances は --log-type Tail 非対応、Duration は CloudWatch の platform.report で取得する

Invoke API で Tail を指定するとエラーになる。代わりに CloudWatch Logs の platform.report イベントから Duration を取得できる。

Lambda Managed Instances のオペレーターロールには AWSLambdaManagedEC2ResourceOperator が必須

EC2 FullAccess や AdministratorAccess をアタッチしても InsufficientRolePermissions で失敗する。専用のマネージドポリシーが必要だった。

AgentCore Memory の CLI パラメータ名はドキュメントのスキーマと異なる箇所がある

batch-update-memory-records の timestamp 必須や、memory-strategies のキー名 semanticMemoryStrategy / namespaceTemplates など、ドキュメントと AWS CLI の差異をまとめた。

Lambda Durable Functions の IAM アクション名は CheckpointDurableExecution（単数形）

ドキュメントの一部に CheckpointDurableExecutions（複数形）と記載があるが、実際に必要なのは単数形。複数形だと権限エラーになる。

Lambda Durable Functions SDK の DurableContext は named import できない

import { DurableContext } from '@aws/durable-execution-sdk-js' は SyntaxError になる。withDurableExecution のみ import し、型は推論に任せる。