Configuration des notifications
Utilisez les services Events et Notifications pour envoyer des notifications chaque fois que Cloud Guard détecte un problème dont vous souhaitez être averti.
Si vous traitez les problèmes intégralement dans Cloud Guard, vous n'avez pas besoin de configurer des notifications.
Cloud Guard fournit un répondeur de notification (événement cloud) qui peut transmettre les détails des problèmes au service Events. La règle de répondeur d'événement cloud fait partie de la recette de répondeur, qui doit être attachée à des cibles correspondantes. La règle d'événement cloud est activée par défaut. Le répondeur d'événement cloud ne requiert pas d'autres stratégies IAM et est configuré pour s'exécuter automatiquement.
L'émission à partir de l'événement cloud vers le service Events permet l'intégration au service Notifications, qui peut propager les notifications vers les destinations suivantes :
- Courriel
- Slack
- Oracle Cloud Infrastructure Functions
Pour configurer des notifications par courriel ou via Slack, passez à Notifications par courriel ou via Slack.
Afin d'utiliser OCI Functions pour transmettre des informations de notification à un autre service, reportez-vous à Notifications via OCI Functions.
Evénements Cloud Guard
Les notifications peuvent être envoyées pour l'un des types d'événement suivants dans Cloud Guard.
vous devez configurer les événements et les notifications à partir de votre région de génération de rapports Cloud Guard, qui regroupe les problèmes des régions surveillées et envoie l'événement cloud.
Pour recevoir des notifications lorsqu'une recette de répondeur est déclenchée, vous devez effectuer les tâches suivantes (pour plus de détails, reportez-vous à Notification par courriel ou Slack ou à Notification via OCI Functions) :
- Dans Cloud Guard, assurez-vous que la règle d'événement cloud est activée pour la recette de répondeur.
- Pour les notifications Slack ou par courriel, dans le service Notifications, créez un sujet et un abonnement à ce sujet.
- Pour OCI Functions, créez le code de fonction à appeler et placez l'application de fonction dans le compartiment à partir duquel elle doit être appelée.
- Dans le service Events, configurez une règle qui spécifie l'action à effectuer.
Types d'événement Cloud Guard
Voici les types d'événement émis par Cloud Guard :
Nom convivial | Déclenchement | Type d'événement |
---|---|---|
Cloud Guard - Annonces | Cloud Guard annonce une nouvelle fonctionnalité |
|
Cloud Guard - Statut | Modifications du statut de Cloud Guard (activées/désactivées) |
|
Le tableau suivant récapitule les actions, le statut et les motifs des types d'événement Cloud Guard.
Type d'événement | Action menant à l'événement | Champ Etat dans les détails de l'événement | Champ Motif dans les détails de l'événement |
---|---|---|---|
Cloud Guard - Annonces | Cloud Guard annonce une nouvelle fonctionnalité | Non applicable | Varie avec l'annonce - exemple : New Detector Rule added by Cloud Guard |
Cloud Guard - Statut | L'utilisateur (actor ) a désactivé Cloud Guard |
CLOUDGUARD_DISABLED |
Cloud Guard is disabled |
Types d'événement de problème
Voici les types d'événement émis par les problèmes :
Nom convivial | Déclenchement | Type d'événement |
---|---|---|
détecté - Problème | Cloud Guard détecte un problème |
|
Rejeté - Problème | Un utilisateur rejette un problème |
|
Corrigé - Problème | Un répondeur configuré pour résoudre automatiquement un problème détecté effectue la correction. |
|
Le tableau suivant détaille les différentes actions, statuts et motifs du type d'événement Corrigé - Problème.
Type d'événement | Action menant à l'événement | Champ Etat dans les détails de l'événement | Champ Motif dans les détails de l'événement |
---|---|---|---|
Corrigé - Problème | L'utilisateur a marqué le problème comme résolu | RESOLVED |
Problem marked as RESOLVED by <User OCID> |
Corrigé - Problème | Problème rejeté | RESOLVED |
Problem marked as DISMISSED by <User> |
Corrigé - Problème | Problème résolu automatiquement | RESOLVED |
Problem is auto resolved by CloudGuard |
Corrigé - Problème | L'utilisateur passe par la correction manuelle du problème/les règles de répondeur configurées pour la correction automatique | RESOLVED |
Problem remediated by CloudGuard |
Détecté - Exemple de problème
Evénement de référence pour les problèmes détectés :
{
"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>"
}
}
Exemple de problème corrigé
Evénement de référence pour les problèmes corrigés :
{
"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>"
}
}
Types d'événement d'observation
Voici les types d'événement émis par les observations :
Nom convivial | Déclencheur | Type d'événement |
---|---|---|
Observation - détectée | Cloud Guard détecte une observation |
|
Notifications par courriel ou via Slack
Utilisez les services Events et Notifications pour envoyer des notifications par courriel ou via Slack chaque fois que Cloud Guard détecte un problème dont vous souhaitez être averti.
Afin d'ajouter des notifications pour plusieurs types d'événement, effectuez toutes les étapes suivantes pour la première notification, puis répétez les étapes 3 et 4 pour chaque notification supplémentaire.
Notifications via OCI Functions
Utilisez les services Events et Notifications pour envoyer des notifications via Oracle Cloud Infrastructure Functions chaque fois que Cloud Guard détecte un problème dont vous souhaitez être averti.