AWSにサインインされたことをSlackに通知する

# まえおき

* AWSへのサインインはIP制限ができないので、イベント検知したかった。（IAMユーザー含む）
※ AWSリソースに対するIP制限はできるが、サインインそのものにはIP制限できないとのこと。（2018年5月15日時点のAWSサポートからの回答より）
　　

* すべてのアカウントにMFAが適用されているかどうかを確認したかった。
* 想定外の場所からサインインされていないかを確認したかった。
　

* Amazon SNSのメール通知で試したところ、JSON形式のままメール本文に記載されていたため、読みづらかったので、Slack通知に変えて見やすくしたかった。
* サインインの失敗や想定外のアクセス元IPアドレスなどを、Slackのメンションを使って気付きやすくしたかった。


## 全体の流れ
1.AWS CloudTrail
※Amazon Simple Storage Service （S3）
↓
2.Amazon CloudWatch Events
↓
3.Amazon Simple Notification Service （SNS）
↓
4.AWS Lambda
  ※AWS Key Management Service （KMS）も併用。
↓
5.Slack



▼ログイン成功時のSlack通知（AWSアカウントの場合）
<img width="547" alt="スクリーンショット_2018-05-13_23_26_39.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/c59311ac-0149-6543-459a-b91853f6f556.png">

※モザイク部分はアクセス元のIPアドレスです。

▼ログイン失敗時のSlack通知（IAMユーザーの場合）
<img width="547" alt="スクリーンショット_2018-05-15_23_35_39.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/039ae569-063c-c5c6-c252-0c66f25acc50.png">

※モザイク部分はIAMユーザー名とアクセス元のIPアドレスです。


# 設定
処理の流れに沿って書いていますが、実際は逆順から設定する必要があります。

## 指定したリージョン
**米国東部（バージニア北部）**

サインインイベントは、このリージョンに対して記録されているため。
（理由は調査中。違う事例もあるのかも）

## 1.AWS CloudTrail
AWS アカウント内で行われた操作のイベントログを記録する。ここでサインインイベントが記録される。

* 証跡を作成する
* 作成した証跡のストレージの場所として、Amazon S3を使用


## 2.Amazon CloudWatch Events
ルールに一致したイベントを 1 つ以上のターゲット関数またはストリームに振り分ける。ここでサインインイベントを拾って、Amazon SNSに投げる。

* ルールを作成する

<img width="1061" alt="スクリーンショット 2018-05-15 22.35.27.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/86da42e5-8033-f91b-7e06-78a97749090d.png">

※ 先にトピックを作っておく必要がある（後述の3を参照）


## 3.Amazon Simple Notification Service （SNS）
サブスクライブしているエンドポイントまたはクライアントへのメッセージを配信する。ここで受けたメッセージをAWS Lambdaに配信する。

* トピックを作成する

<img width="885" alt="スクリーンショット 2018-05-15 22.37.47.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/ac5aec10-3e6c-4c38-0001-fb385f794437.png">

* 作成したトピックにて、サブスクリプションを作成する
 * プロトコルに「AWS Lambda」を指定
 * エンドポイントに関数を指定

<img width="880" alt="スクリーンショット_2018-05-15_22_42_39.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/f6044064-48cb-bcb7-7d41-780c5e27c9ef.png">

※ 先に関数を作っておく必要がある（後述の4を参照）


## 4.AWS Lambda
サーバーレスでコードを実行する。ここでAmazon SNSから受けたメッセージを元に、Slackにメッセージを送る。

* 関数を作成する

<img width="1143" alt="スクリーンショット_2018-05-15_22_59_11.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/a4124ca1-227d-7ad4-a154-2788e0836abf.png">

* [基本的な情報]は任意入力
* [SNS トリガー]は下記の通り

<img width="983" alt="スクリーンショット 2018-05-15 23.01.42.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/10ee8aeb-0ce2-b284-711f-e11e2f71fbf5.png">

---

* [Lambda 関数のコード]

 * ランタイム
     * processEvent関数の部分を編集する

```
function processEvent(event, callback) {
    const message = JSON.parse(event.Records[0].Sns.Message);

    const eventName = message.detail.eventName
    if (eventName !== 'ConsoleLogin') {
        return;
    }
    
    const eventTime = message.detail.eventTime;
    const sourceIPAddress = message.detail.sourceIPAddress;
    const region = message.region;
    const awsRegion = message.detail.awsRegion;

    const userType = message.detail.userIdentity.type;
    let loginUser;
    if (userType == 'Root') {
        loginUser = userType;
    } else if (userType == 'IAMUser') {
        let userName = message.detail.userIdentity.userName;
        loginUser = `${userType}:${userName}`;
    }

    const ConsoleLogin = message.detail.responseElements.ConsoleLogin;
    let color;
    let mention = '';
    switch (ConsoleLogin) {
        case 'Success':
            color = 'good';
            break;
        case 'Failure':
            color = 'warning';
            mention = '<!here|here>';
            break;
        default:
            color = 'danger';
            mention = '<!channel|channel>';
            break;
    }
    
    const MFAUsed = message.detail.additionalEventData.MFAUsed;
    let MFALog;
    if (MFAUsed == 'Yes') {
        MFALog = 'MFAUsed';
    } else {
        MFALog = 'Not MFA';
    }

    const slackMessage = {
        "channel": slackChannel,
        "username": `AWS通知(${eventName})`,
        "text": `${mention}`,
        "attachments": [
            {
                "color": color,
                "fields": [
                    {
                        "title": "eventTime",
                        "value": `${eventTime}`,
                        "short": true
                    },
                    {
                        "title": "ConsoleLoginResult(MFA)",
                        "value": `${ConsoleLogin}(${MFALog})`,
                        "short": true
                    },
                    {
                        "title": "loginUser(sourceIPAddress)",
                        "value": `${loginUser} (${sourceIPAddress})`,
                        "short": true
                    },
                    {
                        "title": "region:awsRegion",
                        "value": `${region}:${awsRegion}`,
                        "short": true
                    }
                ]
	    	}
        ]
    };

    postMessage(slackMessage, (response) => {
        if (response.statusCode < 400) {
            console.info('Message posted successfully');
            callback(null);
        } else if (response.statusCode < 500) {
            console.error(`Error posting message to Slack API: ${response.statusCode} - ${response.statusMessage}`);
            callback(null);  // Don't retry because the error is due to a problem with the request
        } else {
            // Let Lambda retry
            callback(`Server error when processing message: ${response.statusCode} - ${response.statusMessage}`);
        }
    });
}
```
↓↓↓↓↓
<img width="547" alt="スクリーンショット_2018-05-13_23_26_39.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/c59311ac-0149-6543-459a-b91853f6f556.png">

<img width="547" alt="スクリーンショット_2018-05-15_23_35_39.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/039ae569-063c-c5c6-c252-0c66f25acc50.png">

Slackに出力しているメッセージ内容は下記となります。

| 項目名 | 内容 |
|:---|:---|
| eventTime                  | サインインした日時                |
| ConsoleLoginResult(MFA)    | ログイン結果とMFAの使用有無        |
| loginUser(sourceIPAddress) | ログインユーザーとアクセス元IPアドレス |
| region:awsRegion           | リージョン                       |

（補足説明）
* サインイン成功時に緑色の縦線をメッセージに表示する。
* サインイン失敗時に黄色または赤色の縦線をメッセージに表示する。
* サインイン失敗時に@hereまたは@channelメンションを付ける。

---

 * 暗号化の設定
     * ヘルパーの有効化にチェック
     * KMSキーを選択

 * 環境変数
     * 「slackChannel」には送信先のチャンネル名を指定
     * 「kmsEncryptedHookUrl」には、SlackのWebhook URLの【https://】除いた部分を設定
     * 暗号化をクリック
 
<img width="985" alt="スクリーンショット_2018-05-15_23_04_09-2.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/929212f2-a58d-a21d-7df0-06d18f458d99.png">

※ 先にSlackのWebhook URLを用意しておく必要がある（後述の5を参照）
※ 先にKMSキーを作っておく必要がある（本記事では「cw2slack」という名前で事前に作成、暗号化しない場合は不要）


## 5.Slack

* Incoming WebHooksを追加して、「Webhook URL」を取得する。

<img width="994" alt="スクリーンショット 2018-05-15 22.49.29.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/4fffc30c-d754-0866-0e62-1a8fde289e87.png">

↓↓↓↓↓

<img width="957" alt="スクリーンショット_2018-05-15_22_51_01.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/7155841c-8172-882b-9569-b03238b6188e.png">


# あとがき

* 見積もり上では月額数ドル程度の費用だけれども、実際にどうなるかは経過監視後。
* アクセス元IPアドレスによる異常検知も組み込みたいけど、IPをハードコーディングすると柔軟性に欠けるので実現方法を考え中。

# 追記

　2018年9月23日追記：本件に生じたAWS費用は、約2.2ドルでした。（3カ月ほったらかし）
<img width="736" alt="スクリーンショット 2018-09-23 14.33.17.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/3865e740-e824-af7b-f146-1ede5084b9f6.png">

内訳から見ても、KMSとS3の費用だけだったので、Lambdaの実行回数が無料枠内（1,000,000件リクエスト）におさまる限りは、これより増えることはないようです。
<img width="734" alt="スクリーンショット 2018-09-23 15.06.06.png" src="https://qiita-image-store.s3.amazonaws.com/0/148986/b1ff1825-9a0a-d05e-7f0e-861ef6a6cf9a.png">