チュートリアル: Amazon EventBridge を使用して、組織の重要な変更をモニタリングする

組織の管理アカウントの管理者として AWS にサインインし、https://console.aws.amazon.com/cloudtrail/ の CloudTrail コンソールを開きます。

コンソールウィンドウの右上隅にあるナビゲーションバーで、米国東部 (バージニア北部) リージョンを選択します。他のリージョンを選択した場合、AWS Organizations が Amazon EventBridge 設定のオプションとして表示されず、CloudTrail は AWS Organizations に関する情報をキャプチャしません。

ナビゲーションペインで、[Trails] (追跡) を選択します。

[追跡の作成]を選択します。

[Trail name] (証跡名) に、My-Test-Trail と入力します。

CloudTrail がログを配信する場所を指定するには、次のいずれかのオプションを実行します。

[Next] を選択します。

[Choose log events] (ログイベントの選択) ページの [Management events] (管理イベント) セクションで、[Read] (読み取り) と [Write] (書き込み) を選択します。

[Next] を選択します。

場所を確認して [Create function] (関数の作成) を選択します。

https://console.aws.amazon.com/lambda/ で AWS Lambda コンソールを開きます。

Lambda を初めて利用する場合は、ようこそページの [Get Started Now] (今すぐ始める) を選択するか、[Create function] (関数を作成) を選択します。

[Create function] (関数の作成) ページで、[Blueprints] (設計図) を選択します。

[設計図] 検索ボックスでは、フィルターに hello を入力し、[hello-world] 設計図を選択します。

[設定] を選択します。

[基本的な情報] ページでは、以下を実行します。

1. [Name] (名前) テキストボックスに、Lambda 関数名として LogOrganizationEvents を入力します。

2. [Role] で、[Create a new role with basic Lambda permissions] を選択します。このロールは、必要なデータにアクセスし、出力ログを書き込むために Lambda 関数にアクセス許可を付与します。

次の例に示すように、 Lambda 関数のコードを編集します。

console.log('Loading function');

exports.handler = async (event, context) => {
    console.log('LogOrganizationsEvents');
    console.log('Received event:', JSON.stringify(event, null, 2));
    return event.key1;  // Echo back the first key value
    // throw new Error('Something went wrong');
};

このサンプルコードでは、「LogOrganizationEvents」マーカー文字列の後にイベントを構成する JSON 文字列を続けてイベントをログに記録します。

[Create function (関数の作成)] を選択します。

https://console.aws.amazon.com/sns/v3/ で Amazon SNS コンソールを開きます。

ナビゲーションペインで、[トピック] を選択します。

[Create new topic] を選択します。

1. [トピック名] に OrganizationsCloudWatchTopic と入力します。

2. [Display name (表示名)] に OrgsCWEvnt と入力します。

3. [Create topic] (トピックの作成) を選択します。

トピックのサブスクリプションを作成できるようになりました。先ほど作成したトピックの ARN を選択します。

[Create subscription] を選択します。

1. [Create subscription] ページの [Protocol] で [Email] を選択します。

2. [エンドポイント] に E メールアドレスを入力します。

3. [Create subscription] を選択します。AWS は、前のステップで指定した E メールアドレスに E メールを送信します。E メールが送信されたら、[サブスクリプションを確認] リンクを選択して、E メールを正常に受信したことを確認します。

4. コンソールに戻り、ページを更新します。[Pending confirmation] メッセージが表示されなくなり、現在有効なサブスクリプション ID に置き換えられます。

https://console.aws.amazon.com/events/ で[Amazon EventBridge console] (Amazon EventBridge コンソール) を開きます。

コンソールを米国東部 (バージニア北部)リージョンに設定しないと、Organizations に関する情報は利用できません。コンソールウィンドウの右上隅にあるナビゲーションバーで、米国東部 (バージニア北部) リージョンを選択します。

ルールの作成手順については、「Amazon EventBridge ユーザーガイド」の「Getting started with Amazon EventBridge」(Amazon EventBridge の開始方法) を参照してください。

https://console.aws.amazon.com/cloudwatch/ にある CloudWatch コンソールを開きます。

ナビゲーションページで [Logs] (ログ) を選択します。

[Log Groups] (ロググループ) で、Lambda 関数 [/aws/lambda/LogOrganizationEvents] に関連付けられているグループを選択します。

各グループには 1 つ以上のストリームがあり、今日のための 1 つのグループがあります。これを選択します。

ログを表示します。次のような行が表示されます。

エントリの中央の行を選択すると、受信したイベントの完全な JSON テキストが表示されます。API リクエストのすべての詳細は、出力の requestParameters および responseElements で確認できます。

2017-03-09T22:45:05.101Z 0999eb20-051a-11e7-a426-cddb46425f16 Received event:
{
    "version": "0",
    "id": "123456-EXAMPLE-GUID-123456",
    "detail-type": "AWS API Call via CloudTrail",
    "source": "aws.organizations",
    "account": "123456789012",
    "time": "2017-03-09T22:44:26Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "eventVersion": "1.04",
        "userIdentity": {
            ...
        },
        "eventTime": "2017-03-09T22:44:26Z",
        "eventSource": "organizations.amazonaws.com",
        "eventName": "CreateOrganizationalUnit",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.168.0.1",
        "userAgent": "AWS Organizations Console, aws-internal/3",
        "requestParameters": {
            "parentId": "r-exampleRootId",
            "name": "TestCWEOU"
        },
        "responseElements": {
            "organizationalUnit": {
                "name": "TestCWEOU",
                "id": "ou-exampleRootId-exampleOUId",
                "arn": "arn:aws:organizations::1234567789012:ou/o-exampleOrgId/ou-exampleRootId-exampeOUId"
            }
        },
        "requestID": "123456-EXAMPLE-GUID-123456",
        "eventID": "123456-EXAMPLE-GUID-123456",
        "eventType": "AwsApiCall"
    }
}

E メールアカウントで、[OrgsCWEvnt] (Amazon SNS トピックの表示名) からのメッセージを確認します。E メールの本文には、前のステップで示されたログエントリと同じ JSON テキスト出力が含まれます。

CloudTrail コンソールを使用して、ステップ 1 で作成した My-Test-Trail という名前の証跡を削除します。

ステップ 1 で Amazon S3 バケットを作成した場合は、Amazon S3 コンソールを使用して削除します。

Lambda コンソールを使用して、ステップ 2 で作成した LogOrganizationEvents という名前の関数を削除します。

Amazon SNS コンソールを使用して、ステップ 3 で作成した OrganizationsCloudWatchTopic という名前の Amazon SNS トピックを削除します。

CloudWatch コンソールを使用して、ステップ 4 で作成した OrgsMonitorRule という名前の EventBridge ルールを削除します。

最後に、Organizations コンソールを使用して、ステップ 5 で作成した TestCWEOU という名前の OU を削除します。