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 ユーザーの作成

  1. AWS マネジメントコンソールにサインインします。
  2. IAM サービスを開き、「ユーザー > ユーザーを作成」を選択します。
  3. 適当なユーザー名(例: mt-cloudfront-clear-caches)を入力します。
  4. マネジメントコンソールへのサインインは不要なので、チェックは付けないまま「次へ」進みます。

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. アクセスキーの発行

  1. 作成したユーザーの詳細画面を開きます。
  2. 「セキュリティ認証情報」タブで「アクセスキーを作成」をクリックします。
  3. 用途として「AWS の外部で実行されるアプリケーション」を選択します。
  4. 表示された「アクセスキー ID」と「シークレットアクセスキー」を控えます。シークレットはこのとき以降は表示できませんのでご注意ください。

4. IAM ロールを使う場合(v1.1.0 以降)

Movable Type が EC2 インスタンス上で稼働している場合は、手順 1〜3 の代わりに次の操作を行います。

  1. IAM サービスを開き、「ロール > ロールを作成」を選択します。
  2. 信頼されたエンティティタイプで「AWS のサービス」を、ユースケースで「EC2」を選択して「次へ」進みます。
  3. 手順 2 と同じ権限(CloudFrontFullAccess、または cloudfront:CreateInvalidation を許可するカスタムポリシー)を選択して「次へ」進みます。
  4. 適当なロール名(例: mt-cloudfront-clear-caches-role)を入力して、ロールを作成します。
  5. 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 で始まる文字列)を控えておきます。