通知の構成
通知が必要な問題が クラウド・ガードによって検出された場合は常に、イベントおよび通知サービスを使用して通知を送信します。
クラウド・ガード内で問題を完全に処理する場合、通知を構成する必要はありません。
クラウド・ガードは、イベント・サービスに問題の詳細を発行できる通知レスポンダ(クラウド・イベント)を提供します。クラウド・イベント・レスポンダ・ルールは、レスポンダ・レシピの一部であり、対応する1つ以上のターゲットにアタッチする必要があります。クラウド・イベント・ルールは、デフォルトで有効になっています。クラウド・イベント・レスポンダは、他のIAMポリシーを必要とせず、自動的に実行されるように構成されます。
クラウド・イベントからイベント・サービスへの発行により、通知サービスとの統合が可能になり、次に対して通知をプッシュできます:
- 電子メール
- Slack
- Oracle Cloud Infrastructure Functions
電子メールまたはSlackを使用して通知を設定するには、電子メールまたはSlackを使用した通知に進みます。
OCIファンクションを使用して通知情報を別のサービスにリレーするには、OCIファンクションを使用した通知を参照してください。
クラウド・ガード・イベント
クラウド・ガードでは、次のいずれかのイベント・タイプについて通知を送信できます
クラウド・ガードのレポート・リージョンからイベントと通知を設定する必要があります。これにより、モニター対象リージョンから問題が集計され、レポート・リージョンからクラウド・イベントが送信されます。
レスポンダ・レシピがトリガーされたときに通知を受信するには、次のタスクを実行する必要があります(詳細は、「電子メールまたはSlackを使用した通知」または「OCI関数を使用した通知」を参照)。
- クラウド・ガードで、レスポンダ・レシピに対してクラウド・イベント・ルールが有効になっていることを確認します。
- 電子メールまたはSlack通知の場合、通知サービスで、トピックとそのトピックへのサブスクリプションを作成します。
- OCIファンクションの場合、コールするファンクション・コードを作成し、コール元のコンパートメントにファンクション・アプリケーションを配置します。
- イベント・サービスで、実行するアクションを指定するルールを構成します。
クラウド・ガード・イベント・タイプ
クラウド・ガードが発行するイベント・タイプは次のとおりです:
フレンドリ名 | トリガー | イベント・タイプ |
---|---|---|
Cloud Guard - お知らせ | クラウド・ガードが新機能を発表 |
|
Cloud Guard - ステータス | クラウド・ガードのステータス(有効/無効)の変更 |
|
次の表に、クラウド・ガード・イベント・タイプのアクション、ステータスおよび理由の概要を示します。
イベント・タイプ | イベントを発生させるアクション | イベント詳細の「ステータス」フィールド | イベント詳細の「理由」フィールド |
---|---|---|---|
Cloud Guard - お知らせ | クラウド・ガードが新機能を発表 | 適用されません | お知らせによって異なります。例: New Detector Rule added by Cloud Guard |
Cloud Guard - ステータス | ユーザー(actor )が無効なクラウド・ガード |
CLOUDGUARD_DISABLED |
Cloud Guard is disabled |
問題イベント・タイプ
問題が発行するイベント・タイプは次のとおりです:
フレンドリ名 | トリガー | イベント・タイプ |
---|---|---|
検出済- 問題 | クラウド・ガードによる問題の検出 |
|
終了済- 問題あり | ユーザーが問題を終了した場合 |
|
修正済 - 問題 | 検出された問題を自動的に修正するように構成されたレスポンダによって、修正が実行されます。 |
|
次の表に、「修正済- 問題」イベント・タイプの様々なアクション、ステータスおよび理由を示します。
イベント・タイプ | イベントを発生させるアクション | イベント詳細の「ステータス」フィールド | イベント詳細の「理由」フィールド |
---|---|---|---|
修正済- 問題 | ユーザーが問題を解決済とマーク | RESOLVED |
<User OCID>によって解決済とマークされた問題 |
修正済- 問題 | 問題の終了 | RESOLVED |
<User>によって終了済とマークされた問題 |
修正済- 問題 | 問題の自動解決 | RESOLVED |
CloudGuardによって自動的に解決された問題 |
修正済- 問題 | ユーザーによる問題の手動修正/自動修正用のレスポンダ・ルールの構成 | RESOLVED |
CloudGuardによって修正された問題 |
検出済- 問題の例
これは検出された問題のリファレンス・イベントです:
{
"eventType" : "com.oraclecloud.cloudguard.problemdetected",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "CloudGuardResponderEngine",
"eventTime" : "2020-09-02T18:45:39Z",
"contentType" : "application/json",
"data" : {
"compartmentId" : "ocid1.compartment.oc1..<unique_ID>",
"compartmentName" : "compartment_name",
"resourceName" : "problem_name",
"resourceId" : "ocid1.cloudguardproblem.oc1.iad.<unique_ID>",
"additionalDetails" : {
"tenantId" : "ocid1.tenancy.oc1...<unique_ID>",
"problemDescription" : "problem_description",
"riskLevel" : "LOW",
"problemRecommendation" : "example_recommendation",
"status" : "OPEN",
"problemType" : "problem_type",
"resourceName" : "resource_name",
"resourceId" : "ocid1.vcn.oc1.iad.<unique_ID>",
"resourceType" : "resource_type",
"targetId" : "ocid1.cloudguardtarget.oc1..<unique_ID>",
"labels" : "label1, label2",
"firstDetected" : "2020-09-02T18:44:44.568Z",
"lastDetected" : "2020-09-02T18:44:44.568Z",
"region" : "us-ashburn-1"
}
},
"eventID" : "<unique_ID>",
"extensions" : {
"compartmentId" : "ocid1.compartment.oc1..<unique_ID>"
}
}
是正された問題の例
これは改善された問題のリファレンス・イベントです:
{
"eventType" : "com.oraclecloud.cloudguard.problemremediated",
"cloudEventsVersion" : "0.1",
"eventTypeVersion" : "2.0",
"source" : "CloudGuardResponderEngine",
"eventTime" : "2020-09-02T18:47:00Z",
"contentType" : "application/json",
"data" : {
"compartmentId" : "ocid1.compartment.oc1..<unique_ID>",
"compartmentName" : "compartment_name",
"resourceName" : "problem_name",
"resourceId" : "ocid1.cloudguardproblem.oc1.iad.<unique_ID>",
"additionalDetails" : {
"tenantId" : "ocid1.tenancy.oc1...<unique_ID>",
"problemDescription" : "problem_description",
"riskLevel" : "CRITICAL",
"problemRecommendation" : "example_recommendation",
"status" : "RESOLVED",
"problemType" : "problem_type",
"resourceName" : "resource_name",
"resourceId" : "ocid1.vcn.oc1.iad.<unique_ID>",
"resourceType" : "resource_type",
"targetId" : "ocid1.cloudguardtarget.oc1..<unique_ID>",
"labels" : "label1, label2",
"firstDetected" : "2020-09-02T18:44:44.145Z",
"lastDetected" : "2020-09-02T18:44:44.145Z",
"region" : "us-ashburn-1",
"responderRuleId" : "responder_rule_id"
}
},
"eventID" : "<unique_ID>",
"extensions" : {
"compartmentId" : "ocid1.compartment.oc1..<unique_ID>"
}
}
電子メールまたはSlackを使用した通知
通知が必要な問題がクラウド・ガードによって検出された場合は常に、イベントおよび通知サービスを使用して電子メールまたはSlackで通知を送信します。
複数のイベント・タイプの通知を追加するには、最初の通知に対して次のステップをすべて実行し、追加の通知ごとにステップ3と4を繰り返します。
OCIファンクションを使用した通知
通知が必要な問題がクラウド・ガードによって検出された場合は常に、イベントおよび通知サービスを使用してOracle Cloud Infrastructure Functionsで通知を送信します。