AWS 側の準備(IAM ユーザーと権限)
キャッシュクリアに使う IAM ユーザー、または EC2 インスタンスの IAM ロールを用意し、最小限の権限を付与する手順をご案内します。
本プラグインから AWS CloudFront に Invalidation リクエストを送るには、次のどちらかの方法で認証します。
- IAM ユーザーのアクセスキー(Access Key ID / Secret Access Key): 手順 1〜3 を行います。
- EC2 インスタンスにアタッチした IAM ロール(v1.1.0 以降): 手順 4 を行います。Movable Type が EC2 インスタンス上で稼働している場合に利用でき、アクセスキーを Movable Type に保存する必要がありません。
どちらの場合も、手順 5 で Distribution ID を確認します。
1. IAM ユーザーの作成
- AWS マネジメントコンソールにサインインします。
- IAM サービスを開き、「ユーザー > ユーザーを作成」を選択します。
- 適当なユーザー名(例:
mt-cloudfront-clear-caches)を入力します。 - マネジメントコンソールへのサインインは不要なので、チェックは付けないまま「次へ」進みます。
2. 権限の付与
「ポリシーを直接アタッチする」を選択し、次のいずれかの権限を付与します。
- シンプルに付与する場合: AWS マネージドポリシー
CloudFrontFullAccessをアタッチします。 - 最小権限に絞りたい場合: カスタムポリシーを作成して
cloudfront:CreateInvalidationのみ許可します。サンプルポリシーは次の通りです。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "cloudfront:CreateInvalidation",
"Resource": "arn:aws:cloudfront::<ACCOUNT_ID>:distribution/<DISTRIBUTION_ID>"
}
]
}
複数のサイトを運用している場合、システム設定に登録した認証情報(IAM ロールを含む)は、各サイトの管理者がサイト設定で指定したディストリビューションの無効化にも使われます。意図しないディストリビューションを無効化されないよう、カスタムポリシーの Resource で対象のディストリビューションを限定することをおすすめします。複数のディストリビューションを対象にする場合は、Resource に ARN を配列で列挙します。
3. アクセスキーの発行
- 作成したユーザーの詳細画面を開きます。
- 「セキュリティ認証情報」タブで「アクセスキーを作成」をクリックします。
- 用途として「AWS の外部で実行されるアプリケーション」を選択します。
- 表示された「アクセスキー ID」と「シークレットアクセスキー」を控えます。シークレットはこのとき以降は表示できませんのでご注意ください。
4. IAM ロールを使う場合(v1.1.0 以降)
Movable Type が EC2 インスタンス上で稼働している場合は、手順 1〜3 の代わりに次の操作を行います。
- IAM サービスを開き、「ロール > ロールを作成」を選択します。
- 信頼されたエンティティタイプで「AWS のサービス」を、ユースケースで「EC2」を選択して「次へ」進みます。
- 手順 2 と同じ権限(
CloudFrontFullAccess、またはcloudfront:CreateInvalidationを許可するカスタムポリシー)を選択して「次へ」進みます。 - 適当なロール名(例:
mt-cloudfront-clear-caches-role)を入力して、ロールを作成します。 - EC2 サービスで Movable Type が稼働しているインスタンスを選択し、「アクション > セキュリティ > IAM ロールを変更」から作成したロールを選択して更新します。
インスタンスにすでに別の IAM ロールがアタッチされている場合は、新しいロールを作成せず、そのロールに上記の権限を追加してください。1 つのインスタンスにアタッチできる IAM ロールは 1 つです。
プラグインは、キャッシュクリアを実行するたびにインスタンスメタデータサービス(IMDS)から一時的な認証情報を取得します。取得した認証情報はデータベースやファイルには保存しません。IMDSv2、IMDSv1 のどちらにも対応しています。
Movable Type を Docker コンテナ内で稼働させている場合、インスタンスメタデータのホップ制限が 1 のままだと、コンテナから IMDS に到達できないことがあります。その場合はホップ制限を 2 以上に設定してください。
プラグイン側では、システム設定の「認証方法」で「EC2インスタンスにアタッチされたIAMロールを使用する」を選択します(「システム設定(AWS 認証情報)」を参照)。
5. Distribution ID の確認
AWS マネジメントコンソールの「CloudFront > ディストリビューション」一覧で、無効化したい Distribution の ID(E で始まる文字列)を控えておきます。