キーワード：WorkDocs, 通知, メール通知, CloudTrail, EventBridge, SNSトピック
参考ドキュメント： https://docs.aws.amazon.com/ja_jp/workdocs/latest/adminguide/cloudtrail_logging.html https://docs.aws.amazon.com/ja_jp/eventbridge/latest/userguide/eb-service-event.html
やりたいこと
WorkDocs サイトに新しいファイルがアップロードされたり、既存のファイルが変更された場合にメールで通知させたい
ユースケース
- 定期的にパートナー企業からのデータを受け取る
- パートナー企業が複数あり、それぞれのフォルダには閲覧権限を与えずに管理したい
今回使ったAWSサービス
| AWS サービス | 機能 | 用途・目的 |
|---|---|---|
| WorkDocs | フォルダ・ファイル管理、ユーザーへの閲覧権限を管理します | |
| CloudTrail | 証跡 | WorkDocs で実行されるアクションのAPI コールをイベントとして記録します |
| イベント履歴 | イベントとして記録された WorkDocs アクションを確認します | |
| EventBridge | イベントルール | CloudTrail からの情報を元にイベントを発火させる条件 |
| イベントバス | ※ デフォルト default イベントバスを使用します。AWSサービスからのイベント受信には、デフォルトイベントバスのみ対応しています。 | |
| SNS | トピック | 発火されたイベントを Eメールで通知するために使用します |
つまずいたところ
- CloudTrail 証跡は管理イベントを記録するように設定します。念の為、WorkDocsを作成したリージョンと同じリージョンで証跡を作成します。
- EventBridge イベントバスは、デフォルトを使用します。カスタムイベントバスで作成したら WorkDocs サービスから連携される "AWS API Call via CloudTrail" をトリガーにしたイベントルールが実行されませんでした。デフォルトイベントバスにイベントルールを作成します。
設定内容
CloudTrail 証跡
SNS トピックを作成し、サブスクリプションで通知先メールアドレスを登録します。
EventBridge イベントルール
デフォルトイベントバスにルールを作成します
イベントパターン
ターゲット
ターゲットは SNS トピックを指定します。
ターゲットの入力トランスフォーマーで、通知メッセージを編集することができます。
デフォルトイベントバスの「検知を開始する」で有効化
通知メールサンプル
以上、WorkDocs に新しいファイルがアップロードされたらメール通知させる方法でした。
8
