AWS Vault Mfa Iam

Use when AWS account の IAM API が MFA 必須 policy で弾かれて、 `sts:GetCallerIdentity` は通るのに `iam:*` が `InvalidClientTokenId` で拒否されるとき、 または FIDO2 passkey で MFA が CLI から使えないとき。 aws-vault / aws-cli / MFA / passkey 関連で「アクセス拒否」 「token expired」 「IAM 操作のみ失敗」 等の症状から起動 (user が aws-vault を名指しでなくても OK)。

423 stars 6 forksDevOps & Cloud

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add mizchi/skills --skill aws-vault-mfa-iam
Manual install
git clone --depth 1 https://github.com/mizchi/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/aws-vault-mfa-iam ~/.claude/skills/aws-vault-mfa-iam

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# aws-vault に virtual MFA (TOTP) を設定する

## 症状

`aws-vault exec <profile> -- aws iam list-roles` が次のエラーで停止:

```
InvalidClientTokenId: The security token included in the request is invalid
```

しかし `aws sts get-caller-identity` は同じ session で通る。

## 原因

account にある IAM 権限境界 (boundary policy / SCP / inline policy) が「IAM API は MFA 認証された session でのみ許可」というルールを持っている。`aws-vault` のデフォルト session は `sts:GetSessionToken` を MFA なしで取得するため、IAM API だけ弾かれる。

## 解決手順

### 1. AWS Console で virtual MFA device を登録

`https://us-east-1.console.aws.amazon.com/iam/home#/users/details/<user>?section=security_credentials`

- 「**Multi-factor authentication (MFA)**」 → 「**Assign MFA device**」
- Device type: **Authenticator app** を選ぶ(passkey じゃない、CLI から使えない)
- 1Password / Authy / iOS Passwords / Google Authenticator で QR を読み取り
- **連続 2 個のコード**を入力(30 秒以上空けること、これしないと activate されない)

device の ARN は `arn:aws:iam::<ACCOUNT>:mfa/<device-name>`。

### 2. `~/.aws/config` の profile に `mfa_serial` を追加

```ini
[profile <profile>]
region = ap-northeast-1
mfa_serial = arn:aws:iam::<ACCOUNT>:mfa/<device-name>
```

### 3. session を一度 clear

```sh
aws-vault clear <profile>
```

### 4. exec で MFA code 入力

```sh
aws-vault exec <profile> -- aws iam list-roles
# Enter MFA code: <6桁>
```

## 罠

| 罠 | 対処 |
|---|---|
| `aws sts get-caller-identity` が通るので「権限はある」と勘違いする | IAM API も叩いて切り分け |
| FIDO2 passkey は AWS Console login 専用、CLI で使えない | virtual MFA を別途登録 |
Read the full skill on GitHub

Details

Skill name
aws-vault-mfa-iam
Repository
mizchi/skills
Path
aws-vault-mfa-iam/SKILL.md
Repo updated
18 November 2026

FAQ

What does the AWS Vault Mfa Iam skill do?

Use when AWS account の IAM API が MFA 必須 policy で弾かれて、 `sts:GetCallerIdentity` は通るのに `iam:*` が `InvalidClientTokenId` で拒否されるとき、 または FIDO2 passkey で MFA が CLI から使えないとき。 aws-vault / aws-cli / MFA / passkey 関連で「アクセス拒否」 「token expired」 「IAM 操作のみ失敗」 等の症状から起動 (user が aws-vault を名指しでなくても OK)。

How do I install the AWS Vault Mfa Iam skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add mizchi/skills --skill aws-vault-mfa-iam. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is AWS Vault Mfa Iam popular?

It lives in mizchi/skills, which has 423 GitHub stars and 6 forks.

Related skills

Actions CI Tuning

423

mizchi/skills

Use when auditing or improving GitHub Actions workflows for a project. Covers cache setup (npm/pnpm/yarn), job parallelism, shard-based test splitting, artifact handling pitfalls, and Playwright-specific patterns. Trigger on: slow CI, cache miss, flaky shard jobs, merge-reports failures, or an explicit 'tune CI' request.

Testing & QA

AI Index

423

mizchi/skills

Method and tooling for measuring how AI-generated a piece of prose reads, in Japanese or English. Two layers — a deterministic lint for removable surface tells (scripts/slopscore.py, no API) and a judgment layer of typed probabilistic questions (Jev noul/score) for the tells that survive editing. Includes measured human/AI baselines, a gap-first calibration procedure, and labeled fixtures. Use when building or calibrating an AI-likeness score, or when a draft needs a defensible number rather than a vibe. For writing guidance use natural-writing-ja / natural-writing-en instead.

AI, LLMs & Agents

Apm Usage

423

mizchi/skills

Reference for APM manifests, installation, targeted updates, deployment paths and lockfiles. Invoke when the user explicitly asks about APM or apm.yml, or an unfamiliar APM command/error needs exact CLI details. Do not automatically invoke for every project that happens to have installed skills.

DevOps & Cloud

Cloudflare Access App Setup

423

mizchi/skills

One-shot Cloudflare Access self-hosted application provisioning via the API — app + email allowlist policy + service token. Use when you want to gate a Worker behind Access without a full Pulumi stack.

DevOps & Cloud

AWS Github Oidc Scoped Role

423

mizchi/skills

Configure GitHub Actions OIDC trust in AWS IAM using audience and exact subject conditions, including custom subjects for reusable workflows, Bedrock inference-profile permissions and explicit Deny guardrails. Use when designing or reviewing AWS roles assumed by GitHub Actions.

DevOps & Cloud

Cloudflare Deploy

423

mizchi/skills

Deploy applications and infrastructure to Cloudflare with the cf CLI and typed cloudflare.config.ts. Use when deploying Workers, migrating a Wrangler project to cf, or setting up Cloudflare resources and CI.

DevOps & Cloud

Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.