セキュリティの概要
Awnexa を使う前に審査するチーム向けの 1 ページの要約です。それぞれの項目に、どう守っているかを書いています。脆弱性の報告はセキュリティを参照してください。
Awnexa とは
Section titled “Awnexa とは”手元のマシンや CI のランナーで動くコマンドラインツールです。利用者の認証情報で AWS の構成を読み、手元の SQLite データベースに保存し、そのデータベースから問い合わせに答えます(CLI と、Claude Code 向けの stdio の MCP サーバー)。利用者のデータを保存する Awnexa のサーバーはありません。
AWS への呼び出し: 読み取り専用
Section titled “AWS への呼び出し: 読み取り専用”Describe*・List*・Get*・BatchGet*・Search*の API だけを呼びます。ソースが import するすべての AWS SDK のコマンドをテストが検査するため、ほかの種類の呼び出しを加える変更はビルドで失敗します。- 名前は読み取り系でも、値・ログ・認証情報を返す API は 1 つずつ禁止し、同じテストで検査しています。例:
GetSecretValue、GetParameter、GetLogEvents、LookupEvents、GetRecords、Lambda のGetFunction(コードへのリンクを返す)。 - Secrets Manager・SSM パラメータストア・KMS はメタデータだけで、値は読みません。S3 のオブジェクトの一覧や中身、DynamoDB の項目、ログのイベントは読まず、Kubernetes の API にも接続しません。
- エンドポイントを上書きしません。リクエストは SDK が選ぶ AWS のエンドポイントに送られます。
awnexa pluginsが、プラグインごとに呼ぶ API と必要な IAM のアクションを一覧にします。
推奨する IAM の設定は、AWS 管理ポリシー ReadOnlyAccess だけを付けたロールです。Awnexa は AWS を変更する権限を必要としません。データの読み取り(S3 のオブジェクト・シークレットの値・ログのイベントなど)を拒否する任意のポリシーははじめににあります。
- AWS SDK の既定の認証情報チェーン(プロファイル・SSO・環境変数・ロール)で解決します。Awnexa が保存するのはプロファイルの名前とスキャンした主体の ARN だけで、キーやトークンは保存しません。
- データベース・ログ・エラーメッセージ・Evidence のファイルに書きません。ログの出力では認証情報のフィールドを伏せます。
- 例外は 1 つです。
user:passwordを含むプロキシの URL はconfig.json(権限 600)に保存できます。表示やログでは必ず伏せます。
保存するものと場所
Section titled “保存するものと場所”すべてデータディレクトリ(既定は .awnexa)に置きます。データベース、config.json、Evidence のファイル(それぞれの事実の元になった、マスキング済みの API の応答)です。
- 保存する前に、
Password・Secret・Token・PrivateKeyなどのキーの値、アクセスキー、PEM の秘密鍵を[REDACTED]に置き換えます。Lambda 関数と ECS タスク定義の環境変数の値も置き換えます(変数名は残します)。 - Linux と macOS では、ディレクトリを権限 700、ファイルを権限 600 で作り、誤ってコミットしないよう
.gitignoreを置きます。Windows ではユーザープロファイルの下に置いてください。 - 名前・ID・CIDR・タグ・ポリシーは構成そのものなので残します。データディレクトリはインフラの設計資料と同じように扱ってください。
- 削除は手元だけです:
awnexa snapshot prune(確認と--dry-runがあります)。
ネットワークの接続先
Section titled “ネットワークの接続先”- スキャンのための AWS の API のエンドポイント。
- 匿名の利用統計のためだけに、Awnexa 自身のバックエンド(
api.awnexa.net)。利用統計は既定でオンです。最初の実行でそのことを表示して何も送らず、awnexa telemetry disableまたはAWNEXA_TELEMETRY=0で無効にできます。AWS の構成データ・アカウント ID・認証情報・ファイルのパス・ホスト名は含めません。項目の一覧は CLI が送信するデータにあり、AWNEXA_TELEMETRY=debugにすると、CLI は送る代わりにイベントを表示します。 - それ以外にはありません。HTTP(S) プロキシは接続を中継するだけで、TLS は AWS とバックエンドまでつながります。
awnexa mcpは stdio だけを使います。ネットワークのポートを開かず、AWS も呼びません。
インストール
Section titled “インストール”- npm からインストールします。実行時の依存関係にインストールスクリプトを実行するものはなく、SQLite のドライバーはパッケージに含まれるビルド済みのバイナリを使うため、インストールでほかのものをダウンロード・ビルドしません。
- ソースのリポジトリはまだ公開していないため、パッケージは npm の provenance なしで公開しています。
AI が読むデータ
Section titled “AI が読むデータ”リソースの名前・タグ・説明・ポリシーは、AWS アカウントを変更できる人なら誰でも書けるため、AI への指示を意図した文を含むことがあります。Awnexa はこれらの値を変えません(取得した事実だからです)。代わりに、MCP サーバーの instructions と Skill で、値をデータとして扱い指示として扱わないこと、指示のように読める値を所見として報告することを Claude Code に伝えています。Awnexa のツールは読み取り専用で AWS を呼ばないため、そうした文が Awnexa を通じて AWS を変更することはありません。Claude Code が持つほかのツール(シェルや AWS CLI など)は Awnexa の外にあります。AWS を変更するコマンドは Claude Code の許可の確認を通すようにしてください。
Awnexa がしないこと
Section titled “Awnexa がしないこと”- AWS のリソースを変更すること、リソースの中のデータ(オブジェクト・項目・メッセージ・ログ・シークレットの値)を読むこと。
- サービスとして動くこと、データディレクトリ以外にデータを置くこと。
- AWS の構成データをどこかへ送ること。